Construction

: will be made protected - use NewL

do not use

do not use

Called by NeedToDismissQueryL(), gives a change to either accept or reject the query. Default implementation is to accept the query if the Left soft key is displayed and reject it otherwise. Left softkey is only displayed if the query has valid data into it.

Set the prompt inside the query control. If dialog is active redo layout and draw.

Call PrepareLC and display dialog.

Identical to version in CEikDialog but need to override this because of version with prompt, compiler will complain if this is not implemented in derived class as well

Call PrepareLC and display dialog.

From CAknControl

To be used to go through every control in the dialog, on every page, in Dialog-internal storage order, until a control with that type is found. If such a control is not found, a null pointer will be returned.

Returns left CBA short key press

Returns right CBA short key press

Handles pointer events

From MAknQueryControlObserver

Gets called when editor sends size event.

From MAknQueryControlObserver

Gets called when editor sends state event

Deprecated method to return pointer to query heading or NULL (use QueryHeading())

From CCoeControl. Gets the control's input capabilities.

Returns whether the left softkey is visible

Recreates layout and redraws the dialog

Set visibility of the left softkey. Softkey is hidden when data in the query is not acceptable.

Return the maximum possible length of the query text This is (in order of precedence, and assuming they are valid i.e. less than or equal to the length of the descriptor passed to return the value) dependent on:

1) aApiValue

2) Resource set value held in aControl

3) The MaxLength of the descriptor

Called by OfferkeyEventL(), gives a change to dismiss the query even with keys different than Enter of Ok.

Second phase construction required to align with multiline queries API In future might use MAknQueryData mixin in the base class, hence requiring second phase construction.

Not yet totally implemented!

From CCoeControl

Handle key events. When a key event occurs, until one of them returns EKeyWasConsumed to indicate that it processed the key event. CONE calls this function for each control on the control stack,

From CEikdialog

This function is called by the EIKON framework if the user activates a button in the button panel. It is not called if the Cancel button is activated, unless the EEikDialogFlagNotifyEsc flag is set.

Plays tone

From CEikdialog

This function is called by the EIKON dialog framework just before the dialog is activated, after it has called PreLayoutDynInitL() and the dialog has been sized.

From CEikdialog

This function is called by the EIKON dialog framework just before the dialog is activated, but before it is sized, and before PostLayoutDynInitL() is called.

Prompt access for derived classes

Return pointer to query control or NULL

Return pointer to query heading or NULL

Removes the editor indicators for this dialog. Used to ensure this dialog does not own any editor indicators. before opening another dialog which outlasts this one.

Resets system's inactivity timer

Runs the querydialog and returns the ID of the button used to dismiss it. The dialog is destroyed on exit.

Enable or disable emergency call support. This method is only valid in numeric queries (secret or normal).

Default is Off for both.

Enable or disable support to change the CBA labels of the query according to the current ECS state. It's necessary to enable this alongside with ECS for touch and full screen queries.

Note that if enabling this, then it's not necessary to call SetEmergencyCallSupport( ETrue ) additionally, as when enabling this, CAknQueryControl::EEmergencyCallsEnabledByAPI will also be set. To enable the ECS via this method, it must be called prior to PreLayoutDynamicInitL.

If this is enabled for CAknQueryDialog-derived classes, then the OkToExitL implementation of those should forward the EAknSoftkeyEmergencyCall events to the base class' OkToExitL for the emergency call event to be handled.

This method is only valid in numeric queries (secret or normal), default is Off for both.

This method can be used to set predictive text entry permitted. The default Query behaviour is to supress predictive entry (over-riding editor resource flags that may indicate otherwise.

This may be called at any time prior to activation of the query.

Set prompt text for query. This this will override text given in constructor.

From CEikdialog

EIKON provides an implementation of this function, which positions the dialog in the centre of the screen. However, it can be overridden by derived classes.

If the query text is ok (retrieved form query control) then display the left soft key, otherwise hide it.

Enumeration for tones.

The tone played before the dialog is shown. Application specific tones may be played by casting the application defined Sound ID (SID), to TTone

Caption Retriever

Flags for emergency call support Need these at least to store the ECS state until the control exists

Prompt text

Sound system

Spare variable for further development

Tone which is played when the query is executed These will be made private, use protected methods