Categories: Symbian C++ | How To | UI | Customization | Code Examples

This page was last modified 16:22, 23 June 2008.

From Forum Nokia Wiki

CAknSettingItemList is defined in aknsettingitemlist.h. Creating settings items is discussed here

Create setting item listbox from resource with some items in it.

iListBox = new ( ELeave ) CAknSettingItemList;
-----
-----
iListBox->ConstructFromResourceL(R_SETTINGS_LIST )
iListBox->ActivateL();

To hide an item or make invisible SetHidden(ETrue) is to be called on that item.

(*(iListBox->SettingItemArray()))[index]->SetHidden(ETrue);

The setting item array must have to be notified of this by calling CAknSettingItemList::HandleChangeInItemArrayOrVisibility

iListBox->HandleChangeInItemArrayOrVisibilityL();

Note that the items are hidden and not deleted. They can still be accessed using (*SettingItemArray())[index] where index indicates the hidden item number.

Also that SettingItemArray()->MdcaCount() gives only the visible number of items (because of which one may think that the hidden item is deleted. ) SettingItemArray()->Count() gives the total number of items in the SettingList (visible + invisible).

SettingItemArray()->VisibleCount ( ) Returns the number of visible items.

Use Cases

Hide one setting item to prevent the situation where two settings items should not be simultaneously switched ON.

Example Project

The types of settings item that can appear in a list can be found here.

The following sample application creates a slider control setting item and becomes invisible when you select “Hidden” from Options menu.

Example Application

Internal Links

• Create Dynamic Settings Pages

• Settings Lists