#include <mw/AknQueryValue.h>
| class MAknQueryValue |
| Public Member Enumerations | |
|---|---|
| enum | TMode { EQueryMode, ESettingPageMode } |
| Protected Member Enumerations | |
|---|---|
| enum | TFlagBits { ESettingPageModeBitIndex, EAutoAppendBitIndex } |
| Public Member Functions | |
|---|---|
| virtual | ~MAknQueryValue() |
| pure virtual TBool | CreateEditorL() |
| pure virtual TInt | CurrentValueIndex() |
| pure virtual HBufC * | CurrentValueTextLC() |
| pure virtual const MDesCArray * | MdcArray() |
| pure virtual void | SetAutoAppend(TBool) |
| pure virtual void | SetCurrentValueIndex(const TInt) |
| pure virtual void | SetQueryMode(MAknQueryValue::TMode) |
| pure virtual void | SetSettingPageResourceIds(TInt, TInt) |
| Protected Member Functions | |
|---|---|
| pure virtual void | AppendValueIfNewL() |
Mixin class representing a value that is accessed as text.
The Value can be changed by creating an editor dialog, which may be either a query or a setting page or optionally by choosing an entry from an array of values. The array can be accessed as a descriptor array, and the value can be accessed as a descriptor.
| void | AppendValueIfNewL | ( | ) | [protected, pure virtual] |
Method to add the current value to the QueryValueArray if it is new. The new value is not owned by QueryValue object, but is "given away"
| TBool | CreateEditorL | ( | ) | [pure virtual] |
Creates an editor within context. If the value is edited and OK'd, the new value will be set as the current value. Otherwise the current value remains unchanged.
Returns: ETrue if current value was altered; EFalse otherwise
| TInt | CurrentValueIndex | ( | ) | const [pure virtual] |
Returns the index in the array of the current value. If no matches, returns zero
| HBufC * | CurrentValueTextLC | ( | ) | [pure virtual] |
This should be implemented so that it returns the current value as text
Returns: descriptor representing current value, new descriptor is created and left on cleanup stack, ownership passed back to client
| const MDesCArray * | MdcArray | ( | ) | const [pure virtual] |
Returns the array as a descriptor array, ownership will be not passed
| void | SetAutoAppend | ( | TBool | aAppend | ) | [pure virtual] |
Set the QueryValue to append a new user value, if distinct from former value
| Parameter | Description |
|---|---|
| aAppend | set/unset flag EAutoAppendBitIndex |
| void | SetCurrentValueIndex | ( | const TInt | aIndex | ) | [pure virtual] |
Changes the current value to correspond to a value in the array.
| Parameter | Description |
|---|---|
| aIndex | index in array of value to set as current |
| void | SetQueryMode | ( | MAknQueryValue::TMode | aMode | ) | [pure virtual] |
Set QueryMode to be whether query or settingpage -mode
TMode
| Parameter | Description |
|---|---|
| aMode | value from |
| void | SetSettingPageResourceIds | ( | TInt | aSettingPageResourceId, |
| TInt | aSettingPageEditorResourceId | |||
| ) | [pure virtual] | |||
Override the default resource IDs used if a Setting Page mode query is put up. All Queryvalue implementations should have default resource set up. Hence this need not be called unless non-default resource is required.
THE IMPLEMENTATION OF THESE RESOURCE OVERRIDES IS RESERVED FOR FUTURE VERSIONS OF SERIES 60. NOT CURRENTLY FUNCTIONAL. DO NOT USE.
The rules for usage of these ids is the same as that for the CAknSettingPage constructors that take both these resources Editor Resource Setting Page Resource present present Both are used (but text & number overridden) = 0 present Editor resource is used via SP resource present = 0 default SP resource for the query type is used + this editor resource
The type of the editor resource is fixed. If editor resource override is being used, then the resource must be for that control type of editor used in the CAknQueryValueXXXX class.
| Parameter | Description |
|---|---|
| aSettingPageResourceId | AVKON_SETTING_PAGE resource ID to use |
| aSettingPageEditorResourceId | Editor resource ID to use (takes precedence) |