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 ()
void AttemptEmergencyCallL ()
IMPORT_C TInt CancelAnimation ()
void CancelQueryL ()
IMPORT_C TBool CheckNumber ()
CCoeControl * ComponentControl ( TInt )
IMPORT_C void ConstructFromResourceL ( TResourceReader &)
IMPORT_C CCoeControl * ControlByLayoutOrNull ( TInt )
TInt CountComponentControls ()
TBool EditorContentIsValidL ()
void FocusChanged ( TDrawNow )
void GetCaption ( TDes &)
IMPORT_C TTimeIntervalSeconds GetDuration ()
IMPORT_C TReal GetFloatingPointNumberL ()
IMPORT_C void GetLocation ( TPosition &)
IMPORT_C TInt GetNumber ()
IMPORT_C void GetText ( TDes &)
IMPORT_C TInt GetTextEntryLength ()
IMPORT_C TInt GetTextLength ()
IMPORT_C TTime GetTime ()
IMPORT_C void HandleControlEventL ( CCoeControl *, TCoeEvent)
IMPORT_C void HandleEdwinEventL ( CEikEdwin *, TEdwinEvent)
IMPORT_C TBool HandleEdwinSizeEventL ( CEikEdwin *, TEdwinSizeEvent, TSize )
IMPORT_C void HandlePointerEventL (const TPointerEvent &)
IMPORT_C void HandleResourceChange ( TInt )
IMPORT_C TSize MinimumSize ()
IMPORT_C TInt NbrOfEditorLines ()
IMPORT_C TInt NbrOfPromptLines ()
IMPORT_C TKeyResponse OfferKeyEventL (const TKeyEvent &, TEventCode )
void PrepareForFocusLossL ()
TInt QueryType ()
IMPORT_C void ReadPromptL ( TResourceReader &)
void SetAndUseFlagsL ( TBitFlags16 )
IMPORT_C void SetAnimationL ( TInt )
IMPORT_C void SetDuration ( TTimeIntervalSeconds &)
void SetEcsCbaVisibleL ( TBool )
IMPORT_C void SetFloatingPointNumberL (const TReal *)
IMPORT_C void SetImageL ( CEikImage *)
IMPORT_C void SetImageL (const TDesC &, TInt , TInt )
IMPORT_C void SetLocation (const TPosition &)
IMPORT_C void SetMinimumAndMaximum (const TTime &, const TTime &)
IMPORT_C void SetMinimumAndMaximum (const TTimeIntervalSeconds &, const TTimeIntervalSeconds &)
IMPORT_C void SetMinimumAndMaximum ( TInt , TInt )
IMPORT_C void SetMinimumAndMaximum (const TReal &, const TReal &)
IMPORT_C void SetNumberL ( TInt )
IMPORT_C void SetNumberOfEditorLines ( TInt )
IMPORT_C void SetPromptL (const TDesC &)
IMPORT_C void SetQueryControlObserver ( MAknQueryControlObserver *)
IMPORT_C void SetTextEntryLength ( TInt )
IMPORT_C void SetTextL (const TDesC &)
IMPORT_C void SetTime ( TTime &)
IMPORT_C void StartAnimationL ()
void WindowLayout ( TAknWindowLineLayout &)
Protected Member Functions
void ConstructQueryL ( TResourceReader &)
TRect DialogRect ()
TSize DialogSize ()
void DialogSizeChanged ()
void Draw (const TRect &)
void DrawEditorFrame ( CWindowGc &, TRect &)
void Layout ()
void LayoutEditor (const TLayoutMethod &)
void LayoutEditorFrame (const TLayoutMethod &)
void LayoutEditorIndicator (const TLayoutMethod &)
void LayoutImageOrAnim (const TLayoutMethod &)
void LayoutPrompt (const TLayoutMethod &)
TRect LayoutRect ()
CAknLocationEditor *& LocationEd ()
CAknLocationEditor * LocationEd ()
TTypeUid::Ptr MopSupplyObject ( TTypeUid )
CAknQueryExtension * QueryExtension ()
void SetLineWidthsL ()
void SizeChanged ()
Private Member Functions
void CreateBackspaceButtonL ()
void CreateIncAndDecButtonsL ()
void DeployFlagsL ()
CEikDialog * Dialog ()
void DoSetPromptL ()
TBool EmbeddedVirtualInput ()
IMPORT_C void * ExtensionInterface ( TUid )
void LayoutEditorForFullScreen (const TLayoutMethod &)
void LayoutPromptForFullScreen ()
void PictographCallBack ()
TInt PinCodeTimeoutCallback ( TAny *)
void PlayPinCodeTacticon ()
void ResetPinCodeTacticonTimer ()
void SetFlags ( TBitFlags16 )
TInt StaticPictographCallBack ( TAny *)
void StopPinCodeTacticonTimer ()
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
enum TLayoutMethod {
EConfQueryLayoutM , EDataQueryLayoutM , ECodeQueryLayoutM , ETimeQueryLayoutM , EDateQueryLayoutM , ECombinedCodeDataQueryLayoutM
}
enum TQueryControlFlagBitIndices { 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_C CAknQueryControl ( )

C++ Constructor.

~CAknQueryControl()

IMPORT_C ~CAknQueryControl ( ) [virtual]

C++ Destructor.

Member Functions Documentation

AttemptEmergencyCallL()

void AttemptEmergencyCallL ( )

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

CancelAnimation()

IMPORT_C TInt CancelAnimation ( )

stops animation if one present

CancelQueryL()

void CancelQueryL ( )

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

CheckNumber()

IMPORT_C TBool CheckNumber ( )

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

ComponentControl(TInt)

CCoeControl * ComponentControl ( TInt anIndex ) const [virtual]

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

Parameters

TInt anIndex The index of the control to get.

ConstructFromResourceL(TResourceReader &)

IMPORT_C void ConstructFromResourceL ( TResourceReader & aRes ) [virtual]

Second phase constructor: loads contents of array from resources.

Parameters

TResourceReader & aRes

ConstructQueryL(TResourceReader &)

void ConstructQueryL ( 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 ( TInt aLayout ) [virtual]

Get pointer to query controls control (editor)

Parameters

TInt aLayout Controls 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.

CreateBackspaceButtonL()

void CreateBackspaceButtonL ( ) [private]

Creates backspace button.

CreateIncAndDecButtonsL()

void CreateIncAndDecButtonsL ( ) [private]

Creates increment and decrement buttons.

DeployFlagsL()

void DeployFlagsL ( ) [private]

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

Dialog()

CEikDialog * Dialog ( ) const [private]

Returns pointer to dialog.

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()

void DialogSizeChanged ( ) [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()

void DoSetPromptL ( ) [private]

Call CAknTextControl::ParseTextL

Draw(const TRect &)

void Draw ( const TRect & aRect ) const [protected, virtual]

From CCoeControl Draw a control.

Parameters

const TRect & aRect The region of the control to be redrawn.

DrawEditorFrame(CWindowGc &, TRect &)

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

Draw editor frame and shadows

Parameters

CWindowGc & aGc
TRect & aRect

EditorContentIsValidL()

TBool EditorContentIsValidL ( ) const

EmbeddedVirtualInput()

TBool EmbeddedVirtualInput ( ) const [private]

Checks if this query control should contain embedded virtual keypad.

ExtensionInterface(TUid)

IMPORT_C void * ExtensionInterface ( TUid aInterface ) [private, virtual]

Parameters

TUid aInterface

FocusChanged(TDrawNow)

void FocusChanged ( TDrawNow aDrawNow ) [virtual]

From CCoeControl Added to pass-through focus-loss warnings. if not ready, this will leave.

Parameters

TDrawNow aDrawNow

GetCaption(TDes &)

void GetCaption ( TDes & aCaption ) const

Return prompt needed by FEP to query dialog

Parameters

TDes & aCaption

GetDuration()

IMPORT_C TTimeIntervalSeconds GetDuration ( ) const

Get duration from duration editor

GetFloatingPointNumberL()

IMPORT_C TReal GetFloatingPointNumberL ( ) const

Get number from floating point editor.

GetLocation(TPosition &)

IMPORT_C void GetLocation ( 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 TInt GetNumber ( ) const

Get number from number editor.

GetText(TDes &)

IMPORT_C void GetText ( TDes & aDes ) const

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

Parameters

TDes & aDes Address of variable where text returned.

GetTextEntryLength()

IMPORT_C TInt GetTextEntryLength ( ) const

Return the max length of the text in the text editor

GetTextLength()

IMPORT_C TInt GetTextLength ( ) const

Get text length from editor.

GetTime()

IMPORT_C TTime GetTime ( ) const

Get time from date or time editors

HandleControlEventL(CCoeControl *, TCoeEvent)

IMPORT_C void HandleControlEventL ( CCoeControl * aControl,
TCoeEvent aEventType
)

Parameters

CCoeControl * aControl Control who caused the event
TCoeEvent aEventType Type of the event

HandleEdwinEventL(CEikEdwin *, TEdwinEvent)

IMPORT_C void HandleEdwinEventL ( CEikEdwin * aEdwin,
TEdwinEvent aEventType
)

Parameters

CEikEdwin * aEdwin Editor who sent the event
TEdwinEvent aEventType Type of the event

HandleEdwinSizeEventL(CEikEdwin *, TEdwinSizeEvent, TSize)

IMPORT_C TBool HandleEdwinSizeEventL ( CEikEdwin * aEdwin,
TEdwinSizeEvent aEventType,
TSize aDesirableEdwinSize
)

Parameters

CEikEdwin * aEdwin Editor who's size has changed
TEdwinSizeEvent aEventType Type of the size event
TSize aDesirableEdwinSize Desirable size of the edwin

HandlePointerEventL(const TPointerEvent &)

IMPORT_C void HandlePointerEventL ( const TPointerEvent & aPointerEvent ) [virtual]

From CCoeControl . Handles pointer events

Parameters

const TPointerEvent & aPointerEvent

HandleResourceChange(TInt)

IMPORT_C void HandleResourceChange ( TInt aType ) [virtual]

Parameters

TInt aType

Layout()

void Layout ( ) [protected]

Perform layout by calling SizeChanged

LayoutEditor(const TLayoutMethod &)

void LayoutEditor ( const TLayoutMethod & aLayoutM ) [protected, virtual]

Layout the text editor

Parameters

const TLayoutMethod & aLayoutM

LayoutEditorForFullScreen(const TLayoutMethod &)

void LayoutEditorForFullScreen ( const TLayoutMethod & ) [private]

Layouts the query prompt in case of Full Screen Query.

Parameters

const TLayoutMethod &

LayoutEditorFrame(const TLayoutMethod &)

void LayoutEditorFrame ( const TLayoutMethod & aLayoutM ) [protected, virtual]

Layout the editor frame

Parameters

const TLayoutMethod & aLayoutM

LayoutEditorIndicator(const TLayoutMethod &)

void LayoutEditorIndicator ( const TLayoutMethod & aLayoutM ) [protected, virtual]

Layout the editor state indicator icons

Parameters

const TLayoutMethod & aLayoutM

LayoutImageOrAnim(const TLayoutMethod &)

void LayoutImageOrAnim ( const TLayoutMethod & aLayoutM ) [protected, virtual]

Layout the image or the animation

Parameters

const TLayoutMethod & aLayoutM

LayoutPrompt(const TLayoutMethod &)

void LayoutPrompt ( const TLayoutMethod & aLayoutM ) [protected, virtual]

Layout the query prompt

Parameters

const TLayoutMethod & aLayoutM

LayoutPromptForFullScreen()

void LayoutPromptForFullScreen ( ) [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 TSize MinimumSize ( ) [virtual]

From CCoeControl Give the control a mimimum size.

MopSupplyObject(TTypeUid)

TTypeUid::Ptr MopSupplyObject ( TTypeUid aId ) [protected]

Parameters

TTypeUid aId

NbrOfEditorLines()

IMPORT_C TInt NbrOfEditorLines ( ) const

Return number of editor lines

NbrOfPromptLines()

IMPORT_C TInt NbrOfPromptLines ( ) const

Return number of prompt lines

OfferKeyEventL(const TKeyEvent &, TEventCode)

IMPORT_C TKeyResponse OfferKeyEventL ( const TKeyEvent & aKeyEvent,
TEventCode aType
) [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.

Parameters

const TKeyEvent & aKeyEvent The key event.
TEventCode aType The type of the event: EEventKey, EEventKeyUp or EEventKeyDown.

PictographCallBack()

void PictographCallBack ( ) [private]

PinCodeTimeoutCallback(TAny *)

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

Callback for pin code timeouts for producing a tacticons.

Parameters

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

PlayPinCodeTacticon()

void PlayPinCodeTacticon ( ) [private]

Plays a tacticon. Used by the timeout callback.

PrepareForFocusLossL()

void PrepareForFocusLossL ( ) [virtual]

From CCoeControl Added to pass-through focus-loss warnings. if not ready, this will leave.

QueryExtension()

CAknQueryExtension * QueryExtension ( ) const [protected]

Get the extension object instance, if any exists.

QueryType()

TInt QueryType ( ) const [inline]

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 void ReadPromptL ( TResourceReader & aRes ) [virtual]

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

Parameters

TResourceReader & aRes resource reader pointed to a query resource

ResetPinCodeTacticonTimer()

void ResetPinCodeTacticonTimer ( ) [private]

Resets the timer for pincode query tacticon playback.

SetAndUseFlagsL(TBitFlags16)

void SetAndUseFlagsL ( TBitFlags16 aFlags )

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 void SetAnimationL ( TInt aResource )

Sets and overrides other animation

Parameters

TInt aResource

SetDuration(TTimeIntervalSeconds &)

IMPORT_C void SetDuration ( TTimeIntervalSeconds & aDuration )

Set duration to duration editor

Parameters

TTimeIntervalSeconds & aDuration Duration to editor

SetEcsCbaVisibleL(TBool)

void SetEcsCbaVisibleL ( TBool aVisible )

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)

void SetFlags ( TBitFlags16 aFlags ) [private]

This transfers CAknQueryControl's flags set by the dialog

Parameters

TBitFlags16 aFlags

SetFloatingPointNumberL(const TReal *)

IMPORT_C void SetFloatingPointNumberL ( const TReal * aNumber )

Set number to floating point editor

Parameters

const TReal * aNumber Number to editor

SetImageL(CEikImage *)

IMPORT_C void SetImageL ( CEikImage * aImage )

Sets and overrides other image or animation Takes ownership of aImage

Parameters

CEikImage * aImage

SetImageL(const TDesC &, TInt, TInt)

IMPORT_C void SetImageL ( const TDesC & aImageFile,
TInt aBmpId,
TInt aBmpMaskId
)

Sets and overrides other image or animation

Parameters

const TDesC & aImageFile
TInt aBmpId
TInt aBmpMaskId

SetLineWidthsL()

void SetLineWidthsL ( ) [protected, virtual]

Determine the line widths for the prompt, depends on layout

SetLocation(const TPosition &)

IMPORT_C void SetLocation ( 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 & aLocation Location to editor

SetMinimumAndMaximum(const TTime &, const TTime &)

IMPORT_C void SetMinimumAndMaximum ( const TTime & aMinimum,
const TTime & aMaximum
)

Set minimum and maximum time or date to editor

Parameters

const TTime & aMinimum Minimum value
const TTime & aMaximum Maximum value

SetMinimumAndMaximum(const TTimeIntervalSeconds &, const TTimeIntervalSeconds &)

IMPORT_C void SetMinimumAndMaximum ( const TTimeIntervalSeconds & aMinimumDuration,
const TTimeIntervalSeconds & aMaximumDuration
)

Set minimum and maximum duration to editor

Parameters

const TTimeIntervalSeconds & aMinimumDuration Minimum value
const TTimeIntervalSeconds & aMaximumDuration Maximum value

SetMinimumAndMaximum(TInt, TInt)

IMPORT_C void SetMinimumAndMaximum ( TInt aMinimumValue,
TInt aMaximumValue
)

Set minimum and maximum number to editor

Parameters

TInt aMinimumValue Minimum value
TInt aMaximumValue Maximum value

SetMinimumAndMaximum(const TReal &, const TReal &)

IMPORT_C void SetMinimumAndMaximum ( const TReal & aMinimumValue,
const TReal & aMaximumValue
)

Set minimum and maximum number to floating point editor

Parameters

const TReal & aMinimumValue Minimum value
const TReal & aMaximumValue Maximum value

SetNumberL(TInt)

IMPORT_C void SetNumberL ( TInt aNumber )

Set number to number editor

Parameters

TInt aNumber Number to editor

SetNumberOfEditorLines(TInt)

IMPORT_C void SetNumberOfEditorLines ( TInt aNum )

Set the number of lines in the editor.

Parameters

TInt aNum Number of lines in the editor

SetPromptL(const TDesC &)

IMPORT_C void SetPromptL ( const TDesC & aDesC ) [virtual]

Set prompt text for query. This call WrapToStringL.

Parameters

const TDesC & aDesC Text for prompt

SetQueryControlObserver(MAknQueryControlObserver *)

IMPORT_C void SetQueryControlObserver ( MAknQueryControlObserver * aQueryControlObserver )

Set observer for query control.

Parameters

MAknQueryControlObserver * aQueryControlObserver Pointer to oberver class

SetTextEntryLength(TInt)

IMPORT_C void SetTextEntryLength ( TInt aLength )

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

Parameters

TInt aLength Max length of text in editor

SetTextL(const TDesC &)

IMPORT_C void SetTextL ( const TDesC & aDesC )

Set text to text and phonenumber editor.

Parameters

const TDesC & aDesC Text for editor

SetTime(TTime &)

IMPORT_C void SetTime ( TTime & aTime )

Set date of time to editor

Parameters

TTime & aTime Time or date to editor.

SizeChanged()

void SizeChanged ( ) [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 void StartAnimationL ( )

starts animation if one present

StaticPictographCallBack(TAny *)

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

Parameters

TAny * aPtr

StopPinCodeTacticonTimer()

void StopPinCodeTacticonTimer ( ) [private]

Stops/removes the timer for pincode query tacticon playback.

WindowLayout(TAknWindowLineLayout &)

void WindowLayout ( 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]