CObjectConIx Class Reference

#include <e32base.h>

class CObjectConIx : public CBase

Inherits from

CObjectConIx
- CBase

Protected Member Enumerations
enum	anonymous { ENotOwnerID }

Public Member Functions
	~CObjectConIx()
IMPORT_C CObjectCon *	CreateL()
IMPORT_C CObjectCon *	Lookup(TInt)
IMPORT_C CObjectConIx *	NewL()
IMPORT_C void	Remove(CObjectCon *)

Protected Member Functions
	CObjectConIx()
IMPORT_C void	CreateContainerL(CObjectCon *&)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed 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.

Member Enumeration Documentation

Enum anonymous

Enumerator	Value	Description
ENotOwnerID

Constructor & Destructor Documentation

CObjectConIx ( )

IMPORT_C

CObjectConIx

(

)

[protected]

Default constructor.

~CObjectConIx ( )

IMPORT_C

~CObjectConIx

(

)

Destructor.

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

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

Member Function Documentation

CreateContainerL ( CObjectCon *& )

IMPORT_C void

CreateContainerL

(

CObjectCon *&

anObject

)

[protected]

Actually create the container

CreateL ( )

IMPORT_C CObjectCon *

CreateL

(

)

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: A pointer to the new object container.

Lookup ( TInt )

IMPORT_C CObjectCon *

Lookup

(

TInt

aFindHandle

)

const

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

Parameters
aFindHandle	The find handle.

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

NewL ( )

IMPORT_C CObjectConIx *

NewL

(

)

[static]

Creates a new container index.

Return Value: A pointer to the newly created container index.

Remove ( CObjectCon * )

IMPORT_C void

Remove

(

CObjectCon *

aCon

)

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

Parameters
aCon	A pointer to the object container to be removed. If the pointer is NULL, the function just returns.

Panic Codes
E32USER-CBASE	36 if the object container cannnot be found.