Class CObjectConIx

CObjectConIx

Support

Supported from 5.0

Description

A container for object containers

This is referred to as a container index.

The class provides the mechanism through which object containers, CObjectCon types, are created.

Derivation

CBase Base class for all classes to be instantiated on the heap CObjectConIx A container for object containers

Defined in CObjectConIx:
CreateL(), Lookup(), NewL(), Remove(), ~CObjectConIx()

Inherited from CBase:
operator new()

See also:

• CObjectCon
• CObject

static CObjectConIx* NewL();

Description

Creates a new container index.

Return value

CObjectConIx* A pointer to the newly created container index.

~CObjectConIx();

Description

Frees all resources owned by the container index, prior to its destruction.

In particular, it destroys all of its contained object containers.

CObjectCon* CreateL();

Description

Creates a new object container and adds it into this container index's collection.

In addition to creating the object container, the function assigns the next available unique ID to it.

Return value

CObjectCon* A pointer to the new object container.

void Remove(CObjectCon* aCon);

Description

Removes the specified object container from this container index and deletes it.

Parameters

CObjectCon* aCon A pointer to the object container to be removed. If it cannot be found, then the function raises an E32USER-CBASE 36 panic. If this pointer is NULL, then the function does nothing.

CObjectCon* Lookup(TInt aUniqueID) const

Description

Gets a pointer to the object container with the specified unique ID.

Parameters

TInt aUniqueID The unique ID.

Return value

CObjectCon* A pointer to the object container with a matching unique ID. If no matching object container can be found, then this is NULL.