CAknQueryControl Class Reference

class CAknQueryControl : public CAknControl

The control for a query dialog.

Manage layout of elements in a query dialog:- the text, the image and the editors.

CAknQueryDialog, CAknText

Inherits from

Nested Classes and Structures

Public Member Functions
CAknQueryControl()
~CAknQueryControl()
voidAttemptEmergencyCallL()
IMPORT_C TIntCancelAnimation()
voidCancelQueryL()
IMPORT_C TBoolCheckNumber()
CCoeControl *ComponentControl(TInt)
IMPORT_C voidConstructFromResourceL(TResourceReader &)
IMPORT_C CCoeControl *ControlByLayoutOrNull(TInt)
TInt CountComponentControls()
TBool EditorContentIsValidL()
voidFocusChanged(TDrawNow)
voidGetCaption(TDes &)
IMPORT_C TTimeIntervalSecondsGetDuration()
IMPORT_C TRealGetFloatingPointNumberL()
IMPORT_C voidGetLocation(TPosition &)
IMPORT_C TIntGetNumber()
IMPORT_C voidGetText(TDes &)
IMPORT_C TIntGetTextEntryLength()
IMPORT_C TIntGetTextLength()
IMPORT_C TTimeGetTime()
IMPORT_C voidHandleControlEventL(CCoeControl *, TCoeEvent)
IMPORT_C voidHandleEdwinEventL(CEikEdwin *, TEdwinEvent)
IMPORT_C TBoolHandleEdwinSizeEventL(CEikEdwin *, TEdwinSizeEvent, TSize)
IMPORT_C voidHandlePointerEventL(const TPointerEvent &)
IMPORT_C voidHandleResourceChange(TInt)
IMPORT_C TSizeMinimumSize()
IMPORT_C TIntNbrOfEditorLines()
IMPORT_C TIntNbrOfPromptLines()
IMPORT_C TKeyResponseOfferKeyEventL(const TKeyEvent &, TEventCode)
voidPrepareForFocusLossL()
TInt QueryType()
IMPORT_C voidReadPromptL(TResourceReader &)
voidSetAndUseFlagsL(TBitFlags16)
IMPORT_C voidSetAnimationL(TInt)
IMPORT_C voidSetDuration(TTimeIntervalSeconds &)
voidSetEcsCbaVisibleL(TBool)
IMPORT_C voidSetFloatingPointNumberL(const TReal *)
IMPORT_C voidSetImageL(CEikImage *)
IMPORT_C voidSetImageL(const TDesC &, TInt, TInt)
IMPORT_C voidSetLocation(const TPosition &)
IMPORT_C voidSetMinimumAndMaximum(const TTime &, const TTime &)
IMPORT_C voidSetMinimumAndMaximum(const TTimeIntervalSeconds &, const TTimeIntervalSeconds &)
IMPORT_C voidSetMinimumAndMaximum(TInt, TInt)
IMPORT_C voidSetMinimumAndMaximum(const TReal &, const TReal &)
IMPORT_C voidSetNumberL(TInt)
IMPORT_C voidSetNumberOfEditorLines(TInt)
IMPORT_C voidSetPromptL(const TDesC &)
IMPORT_C voidSetQueryControlObserver(MAknQueryControlObserver *)
IMPORT_C voidSetTextEntryLength(TInt)
IMPORT_C voidSetTextL(const TDesC &)
IMPORT_C voidSetTime(TTime &)
IMPORT_C voidStartAnimationL()
voidWindowLayout(TAknWindowLineLayout &)
Protected Member Functions
voidConstructQueryL(TResourceReader &)
TRect DialogRect()
TSize DialogSize()
voidDialogSizeChanged()
voidDraw(const TRect &)
voidDrawEditorFrame(CWindowGc &, TRect &)
voidLayout()
voidLayoutEditor(const TLayoutMethod &)
voidLayoutEditorFrame(const TLayoutMethod &)
voidLayoutEditorIndicator(const TLayoutMethod &)
voidLayoutImageOrAnim(const TLayoutMethod &)
voidLayoutPrompt(const TLayoutMethod &)
TRect LayoutRect()
CAknLocationEditor *&LocationEd()
CAknLocationEditor *LocationEd()
TTypeUid::Ptr MopSupplyObject(TTypeUid)
CAknQueryExtension *QueryExtension()
voidSetLineWidthsL()
voidSizeChanged()
Private Member Functions
voidCreateBackspaceButtonL()
voidCreateIncAndDecButtonsL()
voidDeployFlagsL()
CEikDialog *Dialog()
voidDoSetPromptL()
TBool EmbeddedVirtualInput()
IMPORT_C void *ExtensionInterface(TUid)
voidLayoutEditorForFullScreen(const TLayoutMethod &)
voidLayoutPromptForFullScreen()
voidPictographCallBack()
TInt PinCodeTimeoutCallback(TAny *)
voidPlayPinCodeTacticon()
voidResetPinCodeTacticonTimer()
voidSetFlags(TBitFlags16)
TInt StaticPictographCallBack(TAny *)
voidStopPinCodeTacticonTimer()
Inherited Functions
CAknControl::CAknControl()
CAknControl::~CAknControl()
CBase::CBase()
CBase::Delete(CBase *)
CBase::Extension_(TUint,TAny *&,TAny *)
CBase::operator new(TUint)
CBase::operator new(TUint,TAny *)
CBase::operator new(TUint,TLeave)
CBase::operator new(TUint,TLeave,TUint)
CBase::operator new(TUint,TUint)
CBase::~CBase()
CCoeControl::AccumulatedZoom()const
CCoeControl::ActivateGc()const
CCoeControl::ActivateL()
CCoeControl::BackedUpWindow()const
CCoeControl::Background()const
CCoeControl::CCoeControl()
CCoeControl::CCoeControl(CCoeEnv *)
CCoeControl::CCoeControl(const CCoeControl &)
CCoeControl::CapturesPointer()const
CCoeControl::ClaimPointerGrab(TBool)
CCoeControl::ClaimPointerGrab(TInt,TBool)
CCoeControl::CloseWindow()
CCoeControl::ComponentArrayExists()const
CCoeControl::Components()
CCoeControl::Components()const
CCoeControl::ControlContext()const
CCoeControl::ControlEnv()const
CCoeControl::CopyControlContextFrom(const CCoeControl *)
CCoeControl::CreateBackedUpWindowL(RWindowTreeNode &)
CCoeControl::CreateBackedUpWindowL(RWindowTreeNode &,TDisplayMode)
CCoeControl::CreateWindowL()
CCoeControl::CreateWindowL(RWindowGroup *)
CCoeControl::CreateWindowL(RWindowTreeNode &)
CCoeControl::CreateWindowL(const CCoeControl *)
CCoeControl::CustomGc()const
CCoeControl::DeactivateGc()const
CCoeControl::DrawBackground(const TRect &)const
CCoeControl::DrawDeferred()const
CCoeControl::DrawForeground(const TRect &)const
CCoeControl::DrawNow()const
CCoeControl::DrawNow(const TRect &)const
CCoeControl::DrawableWindow()const
CCoeControl::EnableDragEvents()
CCoeControl::EnableReportControlStateChange(TBool)
CCoeControl::EnableWindowTransparency()
CCoeControl::FindBackground()const
CCoeControl::FindFontProvider()const
CCoeControl::GetColor(TInt,TRgb &)const
CCoeControl::GetColorUseListL(CArrayFix< TCoeColorUse > &)const
CCoeControl::GetGc()const
CCoeControl::GetHelpContext(TCoeHelpContext &)const
CCoeControl::GrabbingComponent()const
CCoeControl::GrabbingComponent(TInt)const
CCoeControl::HandleComponentControlsResourceChange(TInt)
CCoeControl::HandleControlArrayEventL(CCoeControlArray::TEvent,const CCoeControlArray *,CCoeControl *,TInt)
CCoeControl::HandlePointerBufferReadyL()
CCoeControl::HandleRedrawEvent(const TRect &)const
CCoeControl::HasBorder()const
CCoeControl::HitTest()const
CCoeControl::IgnoreEventsUntilNextPointerUp()
CCoeControl::Index(const CCoeControl *)const
CCoeControl::InitComponentArrayL()
CCoeControl::InputCapabilities()const
CCoeControl::IsActivated()const
CCoeControl::IsBackedUp()const
CCoeControl::IsBeingDestroyed()const
CCoeControl::IsBlank()const
CCoeControl::IsDimmed()const
CCoeControl::IsFocused()const
CCoeControl::IsNonFocusing()const
CCoeControl::IsReadyToDraw()const
CCoeControl::IsVisible()const
CCoeControl::LayoutManager()const
CCoeControl::MakeVisible(TBool)
CCoeControl::MaximumWidth()const
CCoeControl::NotifyFontChange(const CCoeFontProvider *)
CCoeControl::Observer()const
CCoeControl::OverrideColorL(TInt,TRgb)
CCoeControl::OwnsWindow()const
CCoeControl::Parent()
CCoeControl::Parent()const
CCoeControl::Position()const
CCoeControl::PositionChanged()
CCoeControl::PositionRelativeToScreen()const
CCoeControl::PrepareForFocusGainL()
CCoeControl::ProcessPointerBufferReadyL()
CCoeControl::ProcessPointerEventL(const TPointerEvent &)
CCoeControl::Rect()const
CCoeControl::RecursivelyMergeInputCapabilities(TCoeInputCapabilities &)const
CCoeControl::RecursivelyMergedInputCapabilities()const
CCoeControl::RefetchPixelMappingL()
CCoeControl::RemoveFromParent()
CCoeControl::ReportEventL(MCoeControlObserver::TCoeEvent)
CCoeControl::RequestRelayout(const CCoeControl *)
CCoeControl::ResetGc()const
CCoeControl::ScreenFont(const TCoeFont &)const
CCoeControl::SetAdjacent(TInt)
CCoeControl::SetAllowStrayPointers()
CCoeControl::SetBackground(const MCoeControlBackground *)
CCoeControl::SetBlank()
CCoeControl::SetCanDrawOutsideRect()
CCoeControl::SetComponentsToInheritVisibility(TBool)
CCoeControl::SetContainerWindowL(RBackedUpWindow &)
CCoeControl::SetContainerWindowL(RWindow &)
CCoeControl::SetContainerWindowL(const CCoeControl &)
CCoeControl::SetControlContext(MCoeControlContext *)
CCoeControl::SetCornerAndSize(TGulAlignment,const TSize &)
CCoeControl::SetCustomGc(CWindowGc *)
CCoeControl::SetDimmed(TBool)
CCoeControl::SetExtent(const TPoint &,const TSize &)
CCoeControl::SetExtentToWholeScreen()
CCoeControl::SetFocus(TBool,TDrawNow)
CCoeControl::SetFocusing(TBool)
CCoeControl::SetFontProviderL(const CCoeFontProvider &)
CCoeControl::SetGc(CWindowGc *)const
CCoeControl::SetGloballyCapturing(TBool)
CCoeControl::SetHitTest(const MCoeControlHitTest *)
CCoeControl::SetLayoutManagerL(MCoeLayoutManager *)
CCoeControl::SetMaximumWidth(TInt)
CCoeControl::SetMopParent(MObjectProvider *)
CCoeControl::SetNeighbor(CCoeControl *)
CCoeControl::SetNonFocusing()
CCoeControl::SetObserver(MCoeControlObserver *)
CCoeControl::SetParent(CCoeControl *)
CCoeControl::SetPointerCapture(TBool)
CCoeControl::SetPosition(const TPoint &)
CCoeControl::SetRect(const TRect &)
CCoeControl::SetSize(const TSize &)
CCoeControl::SetSizeWithoutNotification(const TSize &)
CCoeControl::SetTextBaselineSpacing(TInt)
CCoeControl::SetUniqueHandle(TInt)
CCoeControl::SetZoomFactorL(TInt,TZoomType)
CCoeControl::Size()const
CCoeControl::SystemGc()const
CCoeControl::TextBaselineOffset(const TSize &)const
CCoeControl::TextDrawer(TInt)const
CCoeControl::UniqueHandle()const
CCoeControl::Window()const
CCoeControl::WriteInternalStateL(RWriteStream &)const
CCoeControl::WriteInternalStateNowL(RWriteStream &)const
CCoeControl::ZoomWithType()const
CCoeControl::operator=(const CCoeControl &)
CCoeControl::~CCoeControl()
Public Member Enumerations
enumTLayoutMethod {
EConfQueryLayoutM, EDataQueryLayoutM, ECodeQueryLayoutM, ETimeQueryLayoutM, EDateQueryLayoutM, ECombinedCodeDataQueryLayoutM
}
enumTQueryControlFlagBitIndices { EEmergencyCallsEnabledByAPI, EEmergencyCallsDisabledByAPI, EPredictiveTextEntryPermitted, EEditorIndicatorOff, EEmergencyCallsCBASupport }
Inherited Enumerations
CCoeControl:TZoomType
Protected Attributes
CAknBitmapAnimation *iAnimation
TInt iControl
CEikDateEditor *iDateEdwin
CAknButton *iDecreaseValueButton
TSize iDialogSize
CEikDurationEditor *iDurationEdwin
CAknEcsDetector *iEcsDetector
TAknQueryEcsObserver *iEcsObserver
CAknQueryEditIndicator *iEditIndicator
TAknLayoutRect iEditorFrame
TAknLayoutRect iEditorHorShadow
TAknLayoutRect iEditorVerShadow
CEikEdwin *iEdwin
TBitFlags16 iFlags
CEikFloatingPointEditor *iFloatingPointEditor
TBool iHasEditor
CEikImage *iImage
CAknButton *iIncreaseValueButton
TAknLayoutRect iLayoutMfne
CArrayFixFlat< TInt > *iLineWidths
CAknIntegerEdwin *iNumberEdwin
TInt iNumberOfEditorLines
CAknNumericSecretEditor *iPinEdwin
CAknTextControl *iPrompt
MAknQueryControlObserver *iQueryControlObserver
TInt iQueryType
CEikSecretEditor *iSecretEd
TUint16 iSpare_1
CEikTimeEditor *iTimeEdwin
Private Attributes
CAknQueryControlExtension *iExtension
TInt iSpare
Inherited Attributes
CCoeControl::iCoeEnv
CCoeControl::iContext
CCoeControl::iPosition
CCoeControl::iSize

Constructor & Destructor Documentation

CAknQueryControl()

IMPORT_CCAknQueryControl()

C++ Constructor.

~CAknQueryControl()

IMPORT_C~CAknQueryControl()[virtual]

C++ Destructor.

Member Functions Documentation

AttemptEmergencyCallL()

voidAttemptEmergencyCallL()

Attempts to make an emergency call if a valid emergency number has been entered to the query.

CancelAnimation()

IMPORT_C TIntCancelAnimation()

stops animation if one present

error code

CancelQueryL()

voidCancelQueryL()

This cancels the query. Used when the query control has to get abandon the query for some reason

CheckNumber()

IMPORT_C TBoolCheckNumber()

Checks if the given number in the editor is within the maximum and minimum values.

ComponentControl(TInt)

CCoeControl *ComponentControl(TIntanIndex)const [virtual]

From CCoeControl Get the components of a compound control. It returns one of the control's component controls, identified by aIndex. The component control with an index of aIndex.

Parameters

TInt anIndexThe index of the control to get.

ConstructFromResourceL(TResourceReader &)

IMPORT_C voidConstructFromResourceL(TResourceReader &aRes)[virtual]

Second phase constructor: loads contents of array from resources.

Parameters

TResourceReader & aRes

ConstructQueryL(TResourceReader &)

voidConstructQueryL(TResourceReader &aRes)[protected, virtual]

After having read the query type from resource. This method is called in CostructFromResourceL()

ConstructFromResourceL()

Parameters

TResourceReader & aRes

ControlByLayoutOrNull(TInt)

IMPORT_C CCoeControl *ControlByLayoutOrNull(TIntaLayout)[virtual]

Get pointer to query controls control (editor)

Pointer to control, NULL if not found

Parameters

TInt aLayoutControls layout (for one line queries use EDataLayout, ECodeLayout... and for multiline queries use EMultiDataFirstEdwin, EMultiDataSecondEdwin...)

CountComponentControls()

TInt CountComponentControls()const [virtual]

From CCoeControl Count number of controls contained in a compound control.

The number of component controls contained by this control.

CreateBackspaceButtonL()

voidCreateBackspaceButtonL()[private]

Creates backspace button.

CreateIncAndDecButtonsL()

voidCreateIncAndDecButtonsL()[private]

Creates increment and decrement buttons.

DeployFlagsL()

voidDeployFlagsL()[private]

This acts on the Query control flags that are set from CAknQueryDialog

Dialog()

CEikDialog *Dialog()const [private]

Returns pointer to dialog.

Pointer to dialog if it exists.

DialogRect()

TRect DialogRect()const [protected]

Return the rect that is used by the dialog for layout This can be determined using LAF values and is equal to TPoint(0,0) plus the control size plus the margins

DialogSize()

TSize DialogSize()const [protected]

Return the size of the dialog. This equals to the control size plus the margins.

DialogSizeChanged()

voidDialogSizeChanged()[protected]

Calculates the size of the dialog. This can be determined using LAF values and is equal to the control size plus the margins.

DoSetPromptL()

voidDoSetPromptL()[private]

Call CAknTextControl::ParseTextL

Draw(const TRect &)

voidDraw(const TRect &aRect)const [protected, virtual]

From CCoeControl Draw a control.

Parameters

const TRect & aRectThe region of the control to be redrawn.

DrawEditorFrame(CWindowGc &, TRect &)

voidDrawEditorFrame(CWindowGc &aGc,
TRect &aRect
)const [protected]

Draw editor frame and shadows

Parameters

CWindowGc & aGc
TRect & aRect

EditorContentIsValidL()

TBool EditorContentIsValidL()const

true if the content of the editor is valid, false otherwise

EmbeddedVirtualInput()

TBool EmbeddedVirtualInput()const [private]

Checks if this query control should contain embedded virtual keypad.

ETrue if embedded virtual keypad should be used.

ExtensionInterface(TUid)

IMPORT_C void *ExtensionInterface(TUidaInterface)[private, virtual]

Parameters

TUid aInterface

FocusChanged(TDrawNow)

voidFocusChanged(TDrawNowaDrawNow)[virtual]

From CCoeControl Added to pass-through focus-loss warnings. if not ready, this will leave. Indicates whether or not the key event was used by this control.

Parameters

TDrawNow aDrawNow

GetCaption(TDes &)

voidGetCaption(TDes &aCaption)const

Return prompt needed by FEP to query dialog

Parameters

TDes & aCaption

GetDuration()

IMPORT_C TTimeIntervalSecondsGetDuration()const

Get duration from duration editor

Return duration from editor.

GetFloatingPointNumberL()

IMPORT_C TRealGetFloatingPointNumberL()const

Get number from floating point editor.

Returns number from editor

GetLocation(TPosition &)

IMPORT_C voidGetLocation(TPosition &aLocation)const

Get location from location editor

Modifies aLocation in such way that either longitude or latitude will change.

Parameters

TPosition & aLocation

GetNumber()

IMPORT_C TIntGetNumber()const

Get number from number editor.

Returns number from editor

GetText(TDes &)

IMPORT_C voidGetText(TDes &aDes)const

Get text from text, secret text, numeric secret text snd phonenumber editor.

Parameters

TDes & aDesAddress of variable where text returned.

GetTextEntryLength()

IMPORT_C TIntGetTextEntryLength()const

Return the max length of the text in the text editor max text length

GetTextLength()

IMPORT_C TIntGetTextLength()const

Get text length from editor.

Length of text from editor

GetTime()

IMPORT_C TTimeGetTime()const

Get time from date or time editors

Returns data from editor.

HandleControlEventL(CCoeControl *, TCoeEvent)

IMPORT_C voidHandleControlEventL(CCoeControl *aControl,
TCoeEventaEventType
)

Parameters

CCoeControl * aControlControl who caused the event
TCoeEvent aEventTypeType of the event

HandleEdwinEventL(CEikEdwin *, TEdwinEvent)

IMPORT_C voidHandleEdwinEventL(CEikEdwin *aEdwin,
TEdwinEventaEventType
)

Parameters

CEikEdwin * aEdwinEditor who sent the event
TEdwinEvent aEventTypeType of the event

HandleEdwinSizeEventL(CEikEdwin *, TEdwinSizeEvent, TSize)

IMPORT_C TBoolHandleEdwinSizeEventL(CEikEdwin *aEdwin,
TEdwinSizeEventaEventType,
TSizeaDesirableEdwinSize
)

Parameters

CEikEdwin * aEdwinEditor who's size has changed
TEdwinSizeEvent aEventTypeType of the size event
TSize aDesirableEdwinSizeDesirable size of the edwin

HandlePointerEventL(const TPointerEvent &)

IMPORT_C voidHandlePointerEventL(const TPointerEvent &aPointerEvent)[virtual]

From CCoeControl. Handles pointer events

Parameters

const TPointerEvent & aPointerEvent

HandleResourceChange(TInt)

IMPORT_C voidHandleResourceChange(TIntaType)[virtual]

Parameters

TInt aType

Layout()

voidLayout()[protected]

Perform layout by calling SizeChanged

LayoutEditor(const TLayoutMethod &)

voidLayoutEditor(const TLayoutMethod &aLayoutM)[protected, virtual]

Layout the text editor

Parameters

const TLayoutMethod & aLayoutM

LayoutEditorForFullScreen(const TLayoutMethod &)

voidLayoutEditorForFullScreen(const TLayoutMethod &)[private]

Layouts the query prompt in case of Full Screen Query.

Parameters

const TLayoutMethod &

LayoutEditorFrame(const TLayoutMethod &)

voidLayoutEditorFrame(const TLayoutMethod &aLayoutM)[protected, virtual]

Layout the editor frame

Parameters

const TLayoutMethod & aLayoutM

LayoutEditorIndicator(const TLayoutMethod &)

voidLayoutEditorIndicator(const TLayoutMethod &aLayoutM)[protected, virtual]

Layout the editor state indicator icons

Parameters

const TLayoutMethod & aLayoutM

LayoutImageOrAnim(const TLayoutMethod &)

voidLayoutImageOrAnim(const TLayoutMethod &aLayoutM)[protected, virtual]

Layout the image or the animation

Parameters

const TLayoutMethod & aLayoutM

LayoutPrompt(const TLayoutMethod &)

voidLayoutPrompt(const TLayoutMethod &aLayoutM)[protected, virtual]

Layout the query prompt

Parameters

const TLayoutMethod & aLayoutM

LayoutPromptForFullScreen()

voidLayoutPromptForFullScreen()[private]

Layout the text editor in case of Full Screen Query.

LayoutRect()

TRect LayoutRect()[protected, virtual]

Layout rectangle (shift up and left by margins)

LocationEd()

CAknLocationEditor *&LocationEd()[protected]

LocationEd()

CAknLocationEditor *LocationEd()const [protected]

MinimumSize()

IMPORT_C TSizeMinimumSize()[virtual]

From CCoeControl Give the control a mimimum size.

The minimum size required by the control.

MopSupplyObject(TTypeUid)

TTypeUid::Ptr MopSupplyObject(TTypeUidaId)[protected]

Parameters

TTypeUid aId

NbrOfEditorLines()

IMPORT_C TIntNbrOfEditorLines()const

Return number of editor lines

Number lines in the editor

NbrOfPromptLines()

IMPORT_C TIntNbrOfPromptLines()const

Return number of prompt lines

Number of lines in the prompt

OfferKeyEventL(const TKeyEvent &, TEventCode)

IMPORT_C TKeyResponseOfferKeyEventL(const TKeyEvent &aKeyEvent,
TEventCodeaType
)[virtual]

From CCoeControl Handle key events. When a key event occurs, CONE calls this function for each control on the control stack, until one of them returns EKeyWasConsumed to indicate that it processed the key event. Indicates whether or not the key event was used by this control.

Parameters

const TKeyEvent & aKeyEventThe key event.
TEventCode aTypeThe type of the event: EEventKey, EEventKeyUp or EEventKeyDown.

PictographCallBack()

voidPictographCallBack()[private]

PinCodeTimeoutCallback(TAny *)

TInt PinCodeTimeoutCallback(TAny *aThis)[private, static]

Callback for pin code timeouts for producing a tacticons.

Parameters

TAny * aThisPointer to this object, which is used to play tacticon.

PlayPinCodeTacticon()

voidPlayPinCodeTacticon()[private]

Plays a tacticon. Used by the timeout callback.

PrepareForFocusLossL()

voidPrepareForFocusLossL()[virtual]

From CCoeControl Added to pass-through focus-loss warnings. if not ready, this will leave. Indicates whether or not the key event was used by this control.

QueryExtension()

CAknQueryExtension *QueryExtension()const [protected]

Get the extension object instance, if any exists.

QueryType()

TInt QueryType()const [inline]

Layout indication

At the moment the layout is a good indication of the query type (PIN,number,etc) The query dialog uses this information to determine query type in order to process key events in a way dependent on the query type. These key events can't be processes by the control directly because they involve actions only the dialog can perform

ReadPromptL(TResourceReader &)

IMPORT_C voidReadPromptL(TResourceReader &aRes)[virtual]

Read prompt text from resource and call SetPrompt if there was text for prompt.

Parameters

TResourceReader & aResresource reader pointed to a query resource

ResetPinCodeTacticonTimer()

voidResetPinCodeTacticonTimer()[private]

Resets the timer for pincode query tacticon playback.

SetAndUseFlagsL(TBitFlags16)

voidSetAndUseFlagsL(TBitFlags16aFlags)

This transfers CAknQueryControl's flags set by the dialog and then uses them. The method must be called after all the contained controls are constructed; Inside PreLayoutDynamicInitL is recommended.

Parameters

TBitFlags16 aFlags

SetAnimationL(TInt)

IMPORT_C voidSetAnimationL(TIntaResource)

Sets and overrides other animation

Parameters

TInt aResource

SetDuration(TTimeIntervalSeconds &)

IMPORT_C voidSetDuration(TTimeIntervalSeconds &aDuration)

Set duration to duration editor

Parameters

TTimeIntervalSeconds & aDurationDuration to editor

SetEcsCbaVisibleL(TBool)

voidSetEcsCbaVisibleL(TBoolaVisible)

Sets the ECS CBA visibility in the query.

TBool aVisible ETrue if an ECS number is entered to the query, EFalse otherwise.

Parameters

TBool aVisible

SetFlags(TBitFlags16)

voidSetFlags(TBitFlags16aFlags)[private]

This transfers CAknQueryControl's flags set by the dialog

Parameters

TBitFlags16 aFlags

SetFloatingPointNumberL(const TReal *)

IMPORT_C voidSetFloatingPointNumberL(const TReal *aNumber)

Set number to floating point editor

Parameters

const TReal * aNumberNumber to editor

SetImageL(CEikImage *)

IMPORT_C voidSetImageL(CEikImage *aImage)

Sets and overrides other image or animation Takes ownership of aImage

Parameters

CEikImage * aImage

SetImageL(const TDesC &, TInt, TInt)

IMPORT_C voidSetImageL(const TDesC &aImageFile,
TIntaBmpId,
TIntaBmpMaskId
)

Sets and overrides other image or animation

Parameters

const TDesC & aImageFile
TInt aBmpId
TInt aBmpMaskId

SetLineWidthsL()

voidSetLineWidthsL()[protected, virtual]

Determine the line widths for the prompt, depends on layout

SetLocation(const TPosition &)

IMPORT_C voidSetLocation(const TPosition &aLocation)

Set location to location editor

Modifies editor in such way that it'll start showing either longitude or latitude from the given location. It depends on resource file flags of the location editor which is used.

Parameters

const TPosition & aLocationLocation to editor

SetMinimumAndMaximum(const TTime &, const TTime &)

IMPORT_C voidSetMinimumAndMaximum(const TTime &aMinimum,
const TTime &aMaximum
)

Set minimum and maximum time or date to editor

Parameters

const TTime & aMinimumMinimum value
const TTime & aMaximumMaximum value

SetMinimumAndMaximum(const TTimeIntervalSeconds &, const TTimeIntervalSeconds &)

IMPORT_C voidSetMinimumAndMaximum(const TTimeIntervalSeconds &aMinimumDuration,
const TTimeIntervalSeconds &aMaximumDuration
)

Set minimum and maximum duration to editor

Parameters

const TTimeIntervalSeconds & aMinimumDurationMinimum value
const TTimeIntervalSeconds & aMaximumDurationMaximum value

SetMinimumAndMaximum(TInt, TInt)

IMPORT_C voidSetMinimumAndMaximum(TIntaMinimumValue,
TIntaMaximumValue
)

Set minimum and maximum number to editor

Parameters

TInt aMinimumValueMinimum value
TInt aMaximumValueMaximum value

SetMinimumAndMaximum(const TReal &, const TReal &)

IMPORT_C voidSetMinimumAndMaximum(const TReal &aMinimumValue,
const TReal &aMaximumValue
)

Set minimum and maximum number to floating point editor

Parameters

const TReal & aMinimumValueMinimum value
const TReal & aMaximumValueMaximum value

SetNumberL(TInt)

IMPORT_C voidSetNumberL(TIntaNumber)

Set number to number editor

Parameters

TInt aNumberNumber to editor

SetNumberOfEditorLines(TInt)

IMPORT_C voidSetNumberOfEditorLines(TIntaNum)

Set the number of lines in the editor.

Parameters

TInt aNumNumber of lines in the editor

SetPromptL(const TDesC &)

IMPORT_C voidSetPromptL(const TDesC &aDesC)[virtual]

Set prompt text for query. This call WrapToStringL.

Parameters

const TDesC & aDesCText for prompt

SetQueryControlObserver(MAknQueryControlObserver *)

IMPORT_C voidSetQueryControlObserver(MAknQueryControlObserver *aQueryControlObserver)

Set observer for query control.

Parameters

MAknQueryControlObserver * aQueryControlObserverPointer to oberver class

SetTextEntryLength(TInt)

IMPORT_C voidSetTextEntryLength(TIntaLength)

Set max length of text to text editor. This will override length from resource

Parameters

TInt aLengthMax length of text in editor

SetTextL(const TDesC &)

IMPORT_C voidSetTextL(const TDesC &aDesC)

Set text to text and phonenumber editor.

Parameters

const TDesC & aDesCText for editor

SetTime(TTime &)

IMPORT_C voidSetTime(TTime &aTime)

Set date of time to editor

Parameters

TTime & aTimeTime or date to editor.

SizeChanged()

voidSizeChanged()[protected, virtual]

From CCoeControl Respond to size changed. This function is called by CONE whenever SetExtentL(), SetSizeL(), SetRectL(), SetCornerAndSizeL(), or SetExtentToWholeScreenL() are called on the control.

StartAnimationL()

IMPORT_C voidStartAnimationL()

starts animation if one present

StaticPictographCallBack(TAny *)

TInt StaticPictographCallBack(TAny *aPtr)[private, static]

Parameters

TAny * aPtr

StopPinCodeTacticonTimer()

voidStopPinCodeTacticonTimer()[private]

Stops/removes the timer for pincode query tacticon playback.

WindowLayout(TAknWindowLineLayout &)

voidWindowLayout(TAknWindowLineLayout &aLayout)const [virtual]

Return window layout depending on Layout Window layout is done by the dialog

Parameters

TAknWindowLineLayout & aLayout

Member Enumerations Documentation

Enum TLayoutMethod

Layout for queries can be done using the following methods. Each method is specified in a LAF section

Enumerators

EConfQueryLayoutM
EDataQueryLayoutM
ECodeQueryLayoutM
ETimeQueryLayoutM
EDateQueryLayoutM
ECombinedCodeDataQueryLayoutM

LAYOUT according to LAF specs for combined code and data queries

Enum TQueryControlFlagBitIndices

Enumeration for indexing into control flags, which determine the control behaviour relative to a number of things, e.g. emergency control handling, displaying of edit indicator, enabling of predictive text, etc

Enumerators

EEmergencyCallsEnabledByAPI

Query supports emergency calls.

EEmergencyCallsDisabledByAPI

Query doesn't support emergency calls.

EPredictiveTextEntryPermitted

Predictive text input is allowed in the query.

EEditorIndicatorOff

Editor indicators are not shown in the query.

EEmergencyCallsCBASupport

Additional support to ECS for CBA label change. Must be enabled for touch full screen query for the ECS to function properly.

Member Data Documentation

CAknBitmapAnimation * iAnimation

CAknBitmapAnimation *iAnimation[protected]

TInt iControl

TInt iControl[protected]

CEikDateEditor * iDateEdwin

CEikDateEditor *iDateEdwin[protected]

CAknButton * iDecreaseValueButton

CAknButton *iDecreaseValueButton[protected]

TSize iDialogSize

TSize iDialogSize[protected]

CEikDurationEditor * iDurationEdwin

CEikDurationEditor *iDurationEdwin[protected]

CAknEcsDetector * iEcsDetector

CAknEcsDetector *iEcsDetector[protected]

TAknQueryEcsObserver * iEcsObserver

TAknQueryEcsObserver *iEcsObserver[protected]

CAknQueryEditIndicator * iEditIndicator

CAknQueryEditIndicator *iEditIndicator[protected]

TAknLayoutRect iEditorFrame

TAknLayoutRect iEditorFrame[protected]

TAknLayoutRect iEditorHorShadow

TAknLayoutRect iEditorHorShadow[protected]

TAknLayoutRect iEditorVerShadow

TAknLayoutRect iEditorVerShadow[protected]

CEikEdwin * iEdwin

CEikEdwin *iEdwin[protected]

CAknQueryControlExtension * iExtension

CAknQueryControlExtension *iExtension[private]

TBitFlags16 iFlags

TBitFlags16 iFlags[protected]

CEikFloatingPointEditor * iFloatingPointEditor

CEikFloatingPointEditor *iFloatingPointEditor[protected]

TBool iHasEditor

TBool iHasEditor[protected]

CEikImage * iImage

CEikImage *iImage[protected]

CAknButton * iIncreaseValueButton

CAknButton *iIncreaseValueButton[protected]

TAknLayoutRect iLayoutMfne

TAknLayoutRect iLayoutMfne[protected]

CArrayFixFlat< TInt > * iLineWidths

CArrayFixFlat< TInt > *iLineWidths[protected]

CAknIntegerEdwin * iNumberEdwin

CAknIntegerEdwin *iNumberEdwin[protected]

TInt iNumberOfEditorLines

TInt iNumberOfEditorLines[protected]

CAknNumericSecretEditor * iPinEdwin

CAknNumericSecretEditor *iPinEdwin[protected]

CAknTextControl * iPrompt

CAknTextControl *iPrompt[protected]

MAknQueryControlObserver * iQueryControlObserver

MAknQueryControlObserver *iQueryControlObserver[protected]

TInt iQueryType

TInt iQueryType[protected]

CEikSecretEditor * iSecretEd

CEikSecretEditor *iSecretEd[protected]

TInt iSpare

TInt iSpare[private]

TUint16 iSpare_1

TUint16 iSpare_1[protected]

CEikTimeEditor * iTimeEdwin

CEikTimeEditor *iTimeEdwin[protected]