| class CAknEnumeratedTextPopupSettingItem : public CAknEnumeratedTextSettingItem |
Setting item type for CAknEnumeratedItems.
The main use case for this is for list of texts that are being manipulated in the client source code as a set of enumerations, while the texts, read from resource, are not strongly exposed to the client.
They are exposed to the user, and appear in two versions, if desired - the text shown in the setting list when not being edited, and the "popped-up" version of the texts.
| Public Member Functions | |
|---|---|
| CAknEnumeratedTextPopupSettingItem ( TInt , TInt &) | |
| ~CAknEnumeratedTextPopupSettingItem () | |
| IMPORT_C void | EditItemL ( TBool ) |
| IMPORT_C CArrayPtr < CAknEnumeratedText > * | EnumeratedTextArray () |
| IMPORT_C void | LoadL () |
| IMPORT_C CArrayPtr < HBufC > * | PoppedUpTextArray () |
| IMPORT_C const TDesC & | SettingTextL () |
| IMPORT_C void | StoreL () |
| Protected Member Functions | |
|---|---|
| IMPORT_C void | CompleteConstructionL () |
| IMPORT_C void | CreateAndExecuteSettingPageL () |
| IMPORT_C CAknSettingPage * | CreateSettingPageL () |
| IMPORT_C TInt | ExternalValue () |
| IMPORT_C TInt | IndexFromValue ( TInt ) |
| IMPORT_C TInt | InternalValue () |
| IMPORT_C MAknQueryValue * | QueryValue () |
| IMPORT_C void | SetExternalValue ( TInt ) |
| IMPORT_C void | SetInternalValue ( TInt ) |
| IMPORT_C void | SetSelectedIndex ( TInt ) |
| Private Member Functions | |
|---|---|
| IMPORT_C void | CAknSettingItem_Reserved () |
| void | CreateQueryValueL () |
| void | CreateTextArrayL () |
| TInt | FindNextEnumerationValue () |
| void | SetSettingPageTextL () |
| void | UpdateInternalValuesL () |
| Inherited Enumerations | |
|---|---|
| CAknSettingItem:TFlags | |
| CAknSettingItem:TSettingItemProtection | |
| Private Attributes | |
|---|---|
| TInt & | iExternalValue |
| TInt | iInternalValue |
| TInt | iNumberOfItems |
| CAknQueryValueTextArray * | iQueryTextArray |
| CAknQueryValueText * | iQueryValue |
| TInt | iSelectedIndex |
| TInt | iSpare_EnumeratedTextPopup_1 |
| IMPORT_C | CAknEnumeratedTextPopupSettingItem | ( | TInt | aResourceId, |
| TInt & | aValue | |||
| ) | ||||
Construct a list, storing in it a resource (to be read at 2nd stage construction) and a reference to na externally owned integer - the value to be manipulated
| IMPORT_C void | CompleteConstructionL | ( | ) | [protected, virtual] |
Method called by framework to complete the construction. Extra allocations of memory or extra resource reading can happen here.
| IMPORT_C void | CreateAndExecuteSettingPageL | ( | ) | [protected, virtual] |
Framework method to create and execute setting page
| IMPORT_C CAknSettingPage * | CreateSettingPageL | ( | ) | [protected, virtual] |
Framework method for constructing the launching setting page
| IMPORT_C void | EditItemL | ( | TBool | aCalledFromMenu | ) | [virtual] |
This launches the setting page for popup list setting page
| TBool aCalledFromMenu | - ignored in this class |
| IMPORT_C CArrayPtr < CAknEnumeratedText > * | EnumeratedTextArray | ( | ) | const |
Access to the enumerated text array. Texts here are used in the setting item list display.
| TInt | FindNextEnumerationValue | ( | ) | const [private] |
This routine looks at the current enumeration values and returns the next integer higher than the highest enumeration. For internal use only, although it is possible that clients or derivers might want to use somthing like it.
| IMPORT_C TInt | IndexFromValue | ( | TInt | aInputValue | ) | const [protected] |
Returns the index in the enumerated item array, given the value of the enumeration
| TInt aInputValue | Value to look up; Returns -1 if value is not found |
| IMPORT_C CArrayPtr < HBufC > * | PoppedUpTextArray | ( | ) | const |
Access to the "popped up" array of texts. They may be defined differently from those in the enumerated text arry
| IMPORT_C MAknQueryValue * | QueryValue | ( | ) | const [protected] |
Return a reference to the MAknQueryValue that is constructed for the CAknPopupListSettingPage
| IMPORT_C void | SetExternalValue | ( | TInt | aNewValue | ) | [protected] |
Sets the value of the (unowned) external value using the reference to it held internally. Note that this does not change the value of the reference itself. That is, aNewValue's address is not copied in to be used as the external reference.
| TInt aNewValue | Value to be copied via the external reference. |
| IMPORT_C void | SetInternalValue | ( | TInt | aNewValue | ) | [protected] |
Sets the internal value. The value of aNewValue is copied into the internal storage holding the internal value
| TInt aNewValue |
| IMPORT_C void | SetSelectedIndex | ( | TInt | aNewIndex | ) | [protected] |
Set the item that is selected in the associated popup. This should be done so as to keep the selected index consistent with the internal value
| TInt aNewIndex |
| void | SetSettingPageTextL | ( | ) | [private] |
Implementors of subclasses can call this non-virtual method to set up the list of texts to be used for the setting page. (Although it is not useful for CAknCheckBoxSettingPage ) The list is constructed from the contents of the two text arrays, EnumeratedTextArray() and PoppedUpTextArray() . This is usually to be done "On the fly" immediately prior to the raising of a setting page.
| IMPORT_C void | StoreL | ( | ) | [virtual] |
This command externalizes the current setting. The displayed (internal) copy is transferred to the external copy (the one referenced in the constructor).
This must be called by the client if he wants this to happen. Note that StoreAllL() on the setting item list will call this for each setting item.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.