From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/qptrcollection.html | 177 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 177 insertions(+) create mode 100644 doc/html/qptrcollection.html (limited to 'doc/html/qptrcollection.html') diff --git a/doc/html/qptrcollection.html b/doc/html/qptrcollection.html new file mode 100644 index 00000000..3ab68959 --- /dev/null +++ b/doc/html/qptrcollection.html @@ -0,0 +1,177 @@ + + + + + +TQPtrCollection Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

TQPtrCollection Class Reference

+ +

The TQPtrCollection class is the base class of most pointer-based TQt collections. +More... +

All the functions in this class are reentrant when TQt is built with thread support.

+

#include <qptrcollection.h> +

Inherited by TQAsciiCache, TQAsciiDict, TQCache, TQDict, TQIntCache, TQIntDict, TQPtrList, TQPtrDict, and TQPtrVector. +

List of all member functions. +

Public Members

+ +

Protected Members

+ +

Detailed Description

+ + + +The TQPtrCollection class is the base class of most pointer-based TQt collections. +

+ +

The TQPtrCollection class is an abstract base class for the TQt +collection classes TQDict, TQPtrList, +etc. TQt also includes value based collections, e.g. TQValueList, +TQMap, etc. +

A TQPtrCollection only knows about the number of objects in the +collection and the deletion strategy (see setAutoDelete()). +

A collection is implemented using the Item (generic collection +item) type, which is a void*. The template classes that create +the real collections cast the Item to the retquired type. +

See also Collection Classes and Non-GUI Classes. + +

Member Type Documentation

+

TQPtrCollection::Item

+ +

This type is the generic "item" in a TQPtrCollection. + +

Member Function Documentation

+

TQPtrCollection::TQPtrCollection () [protected] +

+ +

Constructs a collection. The constructor is protected because +TQPtrCollection is an abstract class. + +

TQPtrCollection::TQPtrCollection ( const TQPtrCollection & source ) [protected] +

+ +

Constructs a copy of source with autoDelete() set to FALSE. The +constructor is protected because TQPtrCollection is an abstract +class. +

Note that if source has autoDelete turned on, copying it will +risk memory leaks, reading freed memory, or both. + +

TQPtrCollection::~TQPtrCollection () [virtual protected] +

+ +

Destroys the collection. The destructor is protected because +TQPtrCollection is an abstract class. + +

bool TQPtrCollection::autoDelete () const +

+ +

Returns the setting of the auto-delete option. The default is FALSE. +

See also setAutoDelete(). + +

void TQPtrCollection::clear () [pure virtual] +

+ +

Removes all objects from the collection. The objects will be +deleted if auto-delete has been enabled. +

See also setAutoDelete(). + +

Reimplemented in TQAsciiCache, TQAsciiDict, TQCache, TQDict, TQIntCache, TQIntDict, TQPtrList, TQPtrDict, and TQPtrVector. +

uint TQPtrCollection::count () const [pure virtual] +

+ +

Returns the number of objects in the collection. + +

Reimplemented in TQAsciiCache, TQAsciiDict, TQCache, TQDict, TQIntCache, TQIntDict, TQPtrList, TQPtrDict, and TQPtrVector. +

void TQPtrCollection::deleteItem ( Item d ) [pure virtual protected] +

+ +

Reimplement this function if you want to be able to delete items. +

Deletes an item that is about to be removed from the collection. +

This function has to reimplemented in the collection template +classes, and should only delete item d if auto-delete has +been enabled. +

Warning: If you reimplement this function you must also +reimplement the destructor and call the virtual function clear() +from your destructor. This is due to the way virtual functions and +destructors work in C++: Virtual functions in derived classes +cannot be called from a destructor. If you do not do this, your +deleteItem() function will not be called when the container is +destroyed. +

See also newItem() and setAutoDelete(). + +

Item TQPtrCollection::newItem ( Item d ) [virtual protected] +

+Virtual function that creates a copy of an object that is about to +be inserted into the collection. +

The default implementation returns the d pointer, i.e. no copy +is made. +

This function is seldom reimplemented in the collection template +classes. It is not common practice to make a copy of something +that is being inserted. +

See also deleteItem(). + +

void TQPtrCollection::setAutoDelete ( bool enable ) +

+ +

Sets the collection to auto-delete its contents if enable is +TRUE and to never delete them if enable is FALSE. +

If auto-deleting is turned on, all the items in a collection are +deleted when the collection itself is deleted. This is convenient +if the collection has the only pointer to the items. +

The default setting is FALSE, for safety. If you turn it on, be +careful about copying the collection - you might find yourself +with two collections deleting the same items. +

Note that the auto-delete setting may also affect other functions +in subclasses. For example, a subclass that has a remove() +function will remove the item from its data structure, and if +auto-delete is enabled, will also delete the item. +

See also autoDelete(). + +

Examples: grapher/grapher.cpp, scribble/scribble.cpp, and table/bigtable/main.cpp. + +

+This file is part of the TQt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
TQt 3.3.8
+
+ -- cgit v1.2.1