Class CApaSystemControl

CApaSystemControl

Support

Supported from 5.0

Description

Wrapper for a plug-in extension to the control panel.

An instance of the class represents an extension control's DLL. It is also a cache for the control's icon and caption.

An instance of the wrapper can only be constructed by the control list, a CApaSystemControlList object that is part of the internal implementation of the Symbian platform.

Derivation

CApaSystemControl Wrapper for a plug-in extension to the control panel CBase Base class for all classes to be instantiated on the heap

Defined in CApaSystemControl:
Caption(), CreateL(), FileName(), Icon(), Type()

Inherited from CBase:
operator new()

void CreateL();

Description

Loads the control's DLL, if not already loaded, and calls the DLL's ordinal 1 function to create and run the control.

The function leaves with KErrBadLibraryEntryPoint if the ordinal 1 function cannot be found

TPtrC Caption() const;

Description

Gets the control's caption.

Return value

TPtrC A non-modifiable pointer descriptor representing the control's caption.

TFileName FileName() const;

Description

Gets the full path name of the control's DLL.

Return value

TFileName The full path name.

CApaMaskedBitmap* Icon() const;

Description

Gets the control's icon.

Return value

CApaMaskedBitmap* The icon bitmap.

TUid Type() const;

Description

Gets the UID that uniquely identifies the control.

Return value

TUid The UID.