Queries whether highlight animation should be used for newly created Avkon list controls.

3.0

ETrue if list highlight animation should be used, EFalse otherwise. The default value is ETrue.

Queries whether default skin parameters should be used for newly created Avkon controls. Components supporting SetSkinEnabledL method should also check for this value upon construction and set their internal state accordingly.

Note that this flag is intended to be used to determine whether or not controls should create skin backgrounds for main pane layouts. Skins are always enabled for e.g. all the popup windows, even through the flag may be EFalse, and therefore the flag must not be used as a generic "are skins enabled" switch.

Most controls do not (and should not) query the flag value. If control just fetches the skin control context with AknsDrawUtils::ControlContext, it will get the proper NULL value if no background has been defined.

2.0

ETrue if default skin parameters should be used, EFalse otherwise. The default value is EFalse.

Retrieves the value of the given boolean property skin item.

2.8

Value of the boolean property as TBool.

Exceptions:

Constructs an application icon supporting scalable graphics.

This method is fallback-enabled. If no icon is found in the currently active skin, the application icon is retrieved using application resource file or AIF.

After successful completion, the method leaves both the bitmaps in the cleanup stack. The order in which they are pushed into the stack and types of the items in the stack are both undefined.

The caller must set the size of the returned bitmaps. See AknIconUtils for details.

Note:

Since both the bitmaps are left in the cleanup stack, call to this method can not be enclosed in an immediate TRAP.

2.8

AknSkins.lib

Exceptions:

If the method fails, it leaves with a standard error code.

Constructs a new bitmap item definition object.

2.0

Newly constructed item definition object.

Exceptions:

If construction fails, the method leaves with an error code.

Constructs an independent bitmap. Creates an independent copy of bitmap (in terms of instance ownership) by given item ID.

2.0

Pointer to the newly created bitmap. Ownership of the object is transferred to the caller.

Exceptions:

Constructs an independent masked color-customized icon with fallback support without setting its size.

Creates an independent (in terms of instance ownership) copy of a masked bitmap by the given item ID and applies color-based skinning to it.

The method fails only, if the masked bitmap can not be constructed at all. If the icon can not be color-skinned, it is returned as-is.

2.6

AknSkins.lib

Exceptions:

If data construction fails or bitmap is not found, the function leaves with an error code.

Otherwise identical to CreateColorIconL without size parameters, but calls SetSize to set the size of the resulting icon.

2.8

AknSkins.lib

Otherwise identical to CreateColorIconL, but leaves both the bitmap and the mask in the cleanup stack. The order in which they are pushed into the stack and types of the items in the stack are both undefined.

2.6

AknSkins.lib

Note:

Since two bitmaps are left in the cleanup stack, call to this method can not be enclosed in an immediate TRAP.

Otherwise identical to CreateColorIconL, but leaves both the bitmap and the mask in the cleanup stack. The order in which they are pushed into the stack and types of the items in the stack are both undefined.

2.8

AknSkins.lib

Note:

Since two bitmaps are left in the cleanup stack, call to this method can not be enclosed in an immediate TRAP.

Creates data context suitable for a container. Constructs a new data context suitable for a container. Container should store the pointer and perform proper destruction when the lifetime of the container itself ends.

2.0

Newly created data context. Ownership of the context object is transferred to the caller.

Constructs an independent CGulIcon object with fallback support. Creates an independent (in terms of instance ownership) copy of a masked bitmap by the given item ID, and returns it as a newly constructed CGulIcon object.

If no matching item is found in the currently active skin, attempts to construct the item using the given file.

2.6

AknSkins.lib

Pointer to the newly created CGulIcon object. Ownership of the object is transferred to the caller.

Exceptions:

If data construction fails or bitmap is not found, the function leaves with an error code.

Constructs an independent CGulIcon object. Creates an independent (in terms of instance ownership) copy of a bitmap or a masked bitmap by the given item ID, and returns it as a newly constructed CGulIcon object.

Note:

This method does not have fallback support (to load the bitmap from the specified file in case it is not available in the current skin). Consider using one of the fallback-enabled overloads instead.

2.1

AknSkins.lib

Pointer to the newly created CGulIcon object. Ownership of the object is transferred to the caller.

Exceptions:

If data construction fails or bitmap is not found, the function leaves with an error code.

Constructs an independent masked bitmap with fallback support. Creates an independent (in terms of instance ownership) copy of a masked bitmap by the given item ID.

If no matching item is found in the currently activate skin, attempts to construct the item using the given file.

2.6

AknSkins.lib

Exceptions:

If data construction fails or bitmap is not found, the function leaves with an error code.

Constructs an independent non-masked bitmap with fallback support. Creates an independent (in terms of instance ownership) copy of a non-masked bitmap by the given item ID.

If no matching item is found in the currently activate skin, attempts to construct the item using the given file.

2.6

AknSkins.lib

Exceptions:

If data construction fails or bitmap is not found, the function leaves with an error code.

Otherwise identical to CreateIconL, but leaves both the bitmaps in the cleanup stack. The order in which they are pushed into the stack and types of the items in the stack are both undefined.

Note:

Since both the bitmaps are left in the cleanup stack, call to this method can not be enclosed in an immediate TRAP.

Otherwise identical to CreateIconL, but leaves the bitmap in the cleanup stack. The type of the item pushed into the stack is undefined.

Note:

Since the bitmap is left in the cleanup stack, call to this method can not be enclosed in an immediate TRAP.

Constructs a new masked bitmap item definition object.

2.0

Newly constructed item definition object. Ownership of the object is transferred to the caller.

Exceptions:

If construction fails, the method leaves with an error code.

Constructs an independent masked bitmap with fallback support. Creates an independent (in terms of instance ownership) copy of a masked bitmap by the given item ID.

If no matching item is found in the currently activate skin, attempts to construct the item using the given file.

2.6

AknSkins.lib

Pointer to the newly created CApaMaskedBitmap object. Ownership of the object is transferred to the caller.

Exceptions:

If data construction fails or bitmap is not found, the function leaves with an error code.

Note:

Since CApaMaskedBitmap can not be used to store scalable graphics, consider using CreateIconLC instead.

Constructs an independent masked bitmap. Creates an independent (in terms of instance ownership) copy of a masked bitmap by the given item ID.

Alternatively, masked bitmaps can be retrieved by using MAknsSkinInstance::GetCachedItemData(TAknsItemID,TAknsItemType) or MAknsSkinInstance::CreateUncachedItemDataL(TAknsItemID,TAknsItemType) methods. For these, EAknsITMaskedBitmap should be given as the second parameter. Returned CAknsItemData pointer can be casted to a CAknsMaskedBitmapItemData pointer in order to get access to the bitmap objects themselves.

Note:

This method does not have fallback support (to load the bitmap from the specified file in case it is not available in the current skin). Consider using one of the fallback-enabled overloads instead.

2.0

Pointer to the newly created CApaMaskedBitmap object. Ownership of the object is transferred to the caller.

Exceptions:

If data construction fails or bitmap is not found, the function leaves with an error code.

Note:

Since CApaMaskedBitmap can not be used to store scalable graphics, consider using CreateIconLC instead.

Returns pointer to current data context. If aMop parameter is specified, retrieves the nearest data context in control hierarchy. If none is found (or NULL parameter was given) returns root data context from skin instance. If there is no skin instance, NULL value is returned.

2.0

Pointer to the nearest data context, or NULL if no skin support is available.

Removes the position of the given control from the list. The position of the given control is removed from the thread-local control position list. If the control has not been registered, this method does nothing.

2.0

Constructs an application icon. Icon bitmaps are duplicated to the given CApaMaskedBitmap object.

Since Series 60 Release 2.6, this method is fallback-enabled. If no icon is found in the currently active skin, it uses AppArch to construct the icon.

2.0

KErrNone if succeeded, KErrNotFound if no icon was found or size requirements were not met, other error code if another error occured.

Note:

This method does not support scalable graphics. Consider using CreateAppIconLC instead.

Gets an application icon from skin.

2.8

Returns pointer to a cached bitmap. Retrieves (and constructs if necessary) a bitmap in skin instance cache. Caller can use the bitmap temporarily (e.g. in drawing code), but should not store pointer to it, since its lifetime is determined by cache.

2.0

Pointer to the bitmap, or NULL if no bitmap with given ID was found or an error occured.

Exceptions:

Returns a color value from a cached color table. Retrieves (and constructs if necessary) a color table in skin instance cache and returns a color value from it.

Since release 2.8, this method also handles any backward compatibility operations possibly required.

2.0

KErrNone if successful, otherwise an error code is returned.

Retrieves temporary pointers to a cached bitmap and its mask. Retrieves (and constructs, if necessary) a masked bitmap in the skin instance cache. Pointers to the bitmap (and its mask) are stored to the pointers given as parameters. Caller can use the bitmaps temporarily (e.g. in drawing code), but should not store them, since their lifetimes are determined by the cache.

2.1

Exceptions:

Gets the position of the control registered in the control position list.

KErrNone if successful, KErrNotFound if the control has not been registered.

Initializes application skin support. Creates application skin instance. Method should be called once in the construction phase of application, before any other skin-related operations take place.

2.0

Notes:

The framework calls this method automatically for each application. Thus, a normal application does not need to call this method explicitly.

Exceptions:

Test whether the given type is derived from the given base type.

2.0

ETrue if the type is derived from the base type, EFalse otherwise.

Opens the file containing application icon data.

This method first checks whether there is a data file of the given type associated with the application icon of the given UID. If no file is found, an error code is returned and the caller should use CreateAppIconLC to construct the icon. Otherwise, one of the associated files is opened using the given RFile object.

3.0

AknSkins.lib

KErrNone if a file was opened, an error code otherwise.

Registers the position of the given control. The position is stored in the thread-local control position list. If the control has already been registered, its position is updated.

Registering the position of the control enables background drawing methods in AknsDrawUtils to calculate positions in parent-absolute layouts without causing window server flushes.

When a registered control goes out of scope, it must call AknsUtils::DeregisterControlPosition to ensure that it is properly removed from the list.

2.0

Registers the position of the given control with given position. The position is stored in the thread-local control position list. If the control has already been registered, its position is updated.

Registering the position of the control enables background drawing methods in AknsDrawUtils to calculate positions in parent-absolute layouts without causing window server flushes.

When a registered control goes out of scope, it must call AknsUtils::DeregisterControlPosition to ensure that it is properly removed from the list.

2.0

Reserved for future use.

2.0

Always returns zero.

Returns the best application icon bitmap IID among the listed icons.

2.1

Icon bitmap IID.

Sets the flag indicating whether highlight animations should be used for Avkon list controls in the scope of the current AppUi.

3.0

Exceptions:

If construction of the storage object for the flag fails, leaves with an error code.

Sets the flag indicating whether default skin parameters should be used for newly created Avkon controls in the scope of the current AppUi.

2.0

Exceptions:

If construction of the storage object for the flag fails, leaves with an error code.

Returns pointer to current skin instance. Retrieves pointer to the current application skin instance singleton. If there is none, NULL value is returned.

2.0

Pointer to current skin instance, or NULL if no skin support is available.