epoc32/include/mw/aknquerycontrol.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
parent 2 2fe1408b6811
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h) This is the epoc32/include tree with the "platform" subtrees removed, and all but a selected few mbg and rsg files removed.

/*
* Copyright (c) 2002-2008 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  Implementation of Query control and List query control.
*
*/


#ifndef AKNQUERYCONTROL_H
#define AKNQUERYCONTROL_H

//  INCLUDES
#include <AknControl.h>
#include <gulbordr.h>

#include <eikedwin.h>
#include <eikseced.h>
#include <eikmfne.h>
#include <Aknnumseced.h>
#include <AknNumEdwin.h>
#include <eikfpne.h>

#include <eikimage.h>   
#include <eikedwob.h>

#include <AknUtils.h>
#include <AknPanic.h>

#include <aknipfed.h>
#include <lbsposition.h>

//  FORWARD DECLARATIONS
class CAknQueryControl;
class TAknQueryEcsObserver;
class CAknEcsDetector;
class CAknBitmapAnimation;
class CAknTextControl;
class CAknQueryEditIndicator;
class MLAFIndex;
class MAknEditingStateIndicator;
class TInetAddr;
class CAknQueryExtension;
class TAknWindowLineLayout;
class CAknButton;
class CAknQueryControlExtension;
class CAknLocationEditor;
/**
* MAknQueryControlObserver
*   Callback class for CAknQueryDialog
*/
class MAknQueryControlObserver
    {
public:
    /**
    * Enumeration for query control events
    */
    enum TQueryControlEvent
        {
        EQueryControltSizeChanging,
        EQueryControlEditorStateChanging,
        EEmergencyCallAttempted
        };

    /**
    * Enumeration for editor validation status
    */
    enum TQueryValidationStatus
        {
        EEditorValueValid = KErrNone,
        EEditorValueTooSmall,
        EEditorValueTooLarge,
        EEditorValueNotParsed,
        EEditorEmpty
        };

public:
    /**
    * Gets called when editor sends size event
    */
    virtual TBool HandleQueryEditorSizeEventL(CAknQueryControl* aQueryControl, TQueryControlEvent aEventType)=0;
    /**
    * Gets called when editor sends state event
    */
    virtual TBool HandleQueryEditorStateEventL(CAknQueryControl* aQueryControl, TQueryControlEvent aEventType, TQueryValidationStatus aStatus)=0;
    };

/**
 * The control for a query dialog.
 *
 * Manage layout of elements in a query dialog:- the text, the image 
 * and the editors.
 *
 * @see CAknQueryDialog, CAknText
 */
class CAknQueryControl : public CAknControl , public MEikEdwinObserver , public MEikEdwinSizeObserver , public MCoeControlObserver
    {
public:

	DECLARE_TYPE_ID(0x10283143)    
    
    public:
        /**
        * 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
        */
        enum TQueryControlFlagBitIndices
            {
            /** Query supports emergency calls.
            */
            EEmergencyCallsEnabledByAPI,
            /** Query doesn't support emergency calls.
            */
            EEmergencyCallsDisabledByAPI,
            /** Predictive text input is allowed in the query.
            */
            EPredictiveTextEntryPermitted,
            /** Editor indicators are not shown in the query.
            */
            EEditorIndicatorOff,
            /** Additional support to ECS for CBA label change.
            *   Must be enabled for touch full screen query for the
            *   ECS to function properly.
            */
            EEmergencyCallsCBASupport
            };

        /**
         * Layout for queries can be done
         * using the following methods. Each
         * method is specified in a LAF section
         */
        enum TLayoutMethod 
            {
            EConfQueryLayoutM,             ///LAYOUT according to LAF specs for conf queries
            EDataQueryLayoutM,             ///LAYOUT according to LAF specs for data queries
            ECodeQueryLayoutM,             ///LAYOUT accoridng to LAF specs for code queries
            ETimeQueryLayoutM,             ///LAYOUT according to LAF specs for time queries
            EDateQueryLayoutM,             ///LAYOUT according to LAF specs for date queries
            ECombinedCodeDataQueryLayoutM  ///LAYOUT according to LAF specs for combined code and data queries
            };

    public:  // Constructors and destructor

        /**
         * C++ Constructor.
         */
        IMPORT_C CAknQueryControl();

        /**
         * C++ Destructor.
         */
        IMPORT_C virtual ~CAknQueryControl();

        /**
         * Second phase constructor: loads contents of array from resources.
         *
         * @param aRea      resource reader pointed to a 
         *                  query resource.
         */
        IMPORT_C void ConstructFromResourceL(TResourceReader& aRes);

    public: // New functions

        /**
        * Set observer for query control.
        *
        * @param aQueryControlObserver  Pointer to oberver class 
        */
        IMPORT_C void SetQueryControlObserver(MAknQueryControlObserver* aQueryControlObserver);

        /**
        * Read prompt text from resource and call SetPrompt if there was text for prompt.
        *
        * @param aRes   resource reader pointed to a query resource
        */
        IMPORT_C virtual void ReadPromptL(TResourceReader& aRes);

        /**
        * Set prompt text for query. This call WrapToStringL.
        *
        * @param aDesC  Text for prompt
        */
        IMPORT_C virtual void SetPromptL(const TDesC& aDesC);

        /**
        * Get text from text, secret text, numeric secret text snd phonenumber editor.
        * 
        * @param aDes   Address of variable where text returned.
        */
        IMPORT_C void GetText(TDes& aDes) const;

        /**
        * Get time from date or time editors
        * 
        * @return Returns data from editor.
        */
        IMPORT_C TTime GetTime() const;

        /**
        * Get number from number editor.
        * 
        * @return Returns number from editor
        */
        IMPORT_C TInt GetNumber() const;

        /**
        * Get number from floating point editor.
        * 
        * @return Returns number from editor
        */
        IMPORT_C TReal GetFloatingPointNumberL() const;

        /**
        * Get duration from duration editor
        * 
        * @return Return duration from editor.
        */
        IMPORT_C TTimeIntervalSeconds GetDuration() const;


		/**
		 * Get location from location editor
		 *
		 * Modifies aLocation in such way that either
		 * longitude or latitude will change.
		 */
  	    IMPORT_C void GetLocation(TPosition &aLocation) const;

        /**
        * Set text to text and phonenumber editor.
        * 
        * @param aDesC Text for editor
        */
        IMPORT_C void SetTextL(const TDesC& aDesC);

        /**
        * Set date of time to editor
        * 
        * @param aTime Time or date to editor.
        */
        IMPORT_C void SetTime(TTime& aTime);

        /**
        * Set duration to duration editor
        * 
        * @param aDuration  Duration to editor
        */
        IMPORT_C void SetDuration(TTimeIntervalSeconds& aDuration);

        /**
        * Set number to number editor
        * @param aNumber    Number to editor
        *
        */
        IMPORT_C void SetNumberL(TInt aNumber);

         /**
        * Set number to floating point editor
        * @param aNumber    Number to editor
        *
        */
        IMPORT_C void SetFloatingPointNumberL(const TReal* aNumber);

		/**
		* 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.
		*
		* @param aLocation Location to editor
		*
		*/
		IMPORT_C void SetLocation(const TPosition &aLocation);

        /**
        * Set max length of text to text editor. This will override length from resource
        * @param aLength    Max length of text in editor
        * 
        */
        IMPORT_C void SetTextEntryLength(TInt aLength);

        /**
        * Return the max length of the text in the text editor
        * @return max text length
        */
        IMPORT_C TInt GetTextEntryLength() const;

        /**
        * Set minimum and maximum time or date to editor
        * @param aMinimum   Minimum value 
        * @param aMaximum   Maximum value
        * 
        */
        IMPORT_C void SetMinimumAndMaximum(const TTime& aMinimum, const TTime& aMaximum);

        /**
        * Set minimum and maximum duration to editor
        * @param aMinimumDuration   Minimum value
        * @param aMaximumDuration   Maximum value
        */
        IMPORT_C void SetMinimumAndMaximum(const TTimeIntervalSeconds& aMinimumDuration, const TTimeIntervalSeconds& aMaximumDuration);

        /**
        * Set minimum and maximum number to editor
        * @param aMinimumValue   Minimum value
        * @param aMaximumValue   Maximum value
        */
        IMPORT_C void SetMinimumAndMaximum(TInt aMinimumValue, TInt aMaximumValue);


        /**
        * Checks if the given number in the editor is within the maximum and minimum values.
        */
        IMPORT_C TBool CheckNumber();
        
        /**
        * Set the number of lines in the editor.
        *
        * @param aNum Number of lines in the editor
        */
        IMPORT_C void SetNumberOfEditorLines(TInt aNum);

        /**
        * Set minimum and maximum number to floating point editor
        * @param aMinimumValue   Minimum value
        * @param aMaximumValue   Maximum value
        */
        IMPORT_C void SetMinimumAndMaximum(const TReal& aMinimumValue, const TReal& aMaximumValue);
        /**
        * Get text length from editor.
        * 
        * @return Length of text from editor
        */
        IMPORT_C TInt GetTextLength() const;

        /**
        * Return number of editor lines
        *
        * @return Number lines in the editor
        */

        IMPORT_C TInt NbrOfEditorLines() const;


        /**
        * Return number of prompt lines
        * 
        * @return Number of lines in the prompt
        */
        IMPORT_C TInt NbrOfPromptLines() const;

        /**
        * Get pointer to query controls control (editor)
        *
        * @param aLayout    Controls layout (for one line queries use
        *                   EDataLayout, ECodeLayout... and for
        *                   multiline queries use
        *                   EMultiDataFirstEdwin, EMultiDataSecondEdwin...)
        * @return           Pointer to control, NULL if not found 
        */
        IMPORT_C virtual CCoeControl* ControlByLayoutOrNull(TInt aLayout);

        /**
        * Sets and overrides other image or animation
        * Takes ownership of aImage
        */
        IMPORT_C void SetImageL(CEikImage* aImage);

        /**
        * Sets and overrides other image or animation
        */
        IMPORT_C void SetImageL(const TDesC& aImageFile,
                                TInt aBmpId, TInt aBmpMaskId);
        /**
        * Sets and overrides other animation
        * 
        */
        IMPORT_C void SetAnimationL(TInt aResource);

        /**
        * starts animation if one present
        * 
        */
        IMPORT_C void StartAnimationL();

        /**
        * stops animation if one present
        * 
        * @return error code
        */
        IMPORT_C TInt CancelAnimation();

        /**
        * This cancels the query.  Used when the query control has to get abandon the query
        * for some reason
        */
        void CancelQueryL();

        /**
        *   @return true if the content of the editor is valid, false otherwise
        */
        TBool EditorContentIsValidL() const;

        /**
        * 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.
        * 
        * @param flag pattern to set and then act on.
        */
        void SetAndUseFlagsL( TBitFlags16 aFlags );

    public: // Functions from CCoeControl
    
        /**
        * 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.  
        * @param aKeyEvent  The key event.
        * @param aType      The type of the event: EEventKey, EEventKeyUp or EEventKeyDown.
        * @return           Indicates whether or not the key event was used by this control.
        */
        IMPORT_C TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent, TEventCode aType);

        /**
        * From CCoeControl  Give the control a mimimum size. 
        * 
        * @return           The minimum size required by the control.
        */
        IMPORT_C TSize MinimumSize();

        /**
        * From CCoeControl  Added to pass-through focus-loss warnings.
        *                   if not ready, this will leave.
        * @return           Indicates whether or not the key event was used by this control.
        */
        void PrepareForFocusLossL();

        /**
        * From CCoeControl  Added to pass-through focus-loss warnings.
        *                   if not ready, this will leave.
        * @return           Indicates whether or not the key event was used by this control.
        */
        void FocusChanged(TDrawNow aDrawNow);
        
        /**
        * From MEikEdwinObserver
        *
        * @param aEdwin     Editor who sent the event
        * @param aEventType Type of the event
        */
        IMPORT_C void HandleEdwinEventL(CEikEdwin* aEdwin,TEdwinEvent aEventType);

    public:// Functions from MEikEdwinSizeObserver

        /**
        * From MEikEdwinObserver
        *
        * @param aEdwin                 Editor who's size has changed
        * @param aEventType             Type of the size event
        * @param aDesirableEdwinSize    Desirable size of the edwin
        */
        IMPORT_C TBool HandleEdwinSizeEventL(CEikEdwin* aEdwin, TEdwinSizeEvent aEventType, TSize aDesirableEdwinSize);

    public:// Functions from MCoeControlObserver

        /**
        * From MCoeControlObserver
        * @param aControl   Control who caused the event
        * @param aEventType Type of the event
        */
        IMPORT_C void HandleControlEventL(CCoeControl* aControl,TCoeEvent aEventType);

    public:
        /**
        * @return 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
        */
        inline TInt QueryType() const { return iQueryType; } 

        /**
        * Return window layout depending on Layout 
        * Window layout is done by the dialog
        */
        virtual void WindowLayout( TAknWindowLineLayout& aLayout ) const;
    
    public:// Functions from CCoeControl
        /**
        * From CCoeControl  Count number of controls contained in a compound control.  
        *  
        * @return           The number of component controls contained by this control.           
        */
        TInt CountComponentControls() const;

        /**
        * From CCoeControl  Get the components of a compound control.
        *                   It returns one of the control's component controls, identified by aIndex.
        * @param anIndex    The index of the control to get.        
        * @return           The component control with an index of aIndex.
        */
        CCoeControl* ComponentControl(TInt anIndex) const;

        /**
        * From CCoeControl.     
        * Handles pointer events
        */
    	IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
    	
    	IMPORT_C void HandleResourceChange(TInt aType); 

    public:
        /**
         * Manage indexes into LAF tables
         */
        class TIndex 
        {   
        public:     
            TIndex(TInt aNumberOfPromptLines);  
        
        public: 
            TInt PromptLine() const;    
            
        public: 
            TInt DQPWindowTextsLine2(TInt aLineNum) const;  
            TInt PNWindow() const;  
            TInt PQDWindow(TInt aLineNum) const;    
            TInt PQCWindow() const;
            
        private:    
            void SelfTest() const;  

        private:    
            TInt  iNumberOfPromptLines; 
        };  

    protected:
        /**
        * From CCoeControl  Respond to size changed. This function is called by CONE whenever SetExtentL(), 
        *                   SetSizeL(), SetRectL(), SetCornerAndSizeL(), or SetExtentToWholeScreenL() 
        *                   are called on the control.   
        */
        void SizeChanged();

        /**
        * From CCoeControl  Draw a control.  
        *
        * @param aRect      The region of the control to be redrawn.   
        */
        void Draw(const TRect& aRect) const;

        /**
        * From MObjectProvider
        */
        TTypeUid::Ptr MopSupplyObject(TTypeUid aId);

        /**
        * Perform layout by calling SizeChanged 
        *   
        */
        void Layout();

    protected:
        /**
         * Determine the line widths for the prompt, depends on layout
         */
        virtual void SetLineWidthsL();

        /**
         * After having read the query type from resource. This method is
         * called in CostructFromResourceL()
         *
         * @see ConstructFromResourceL()
         */
        virtual void ConstructQueryL(TResourceReader& aRes);

        /**
         * Layout rectangle (shift up and left by margins)
         */
        virtual TRect LayoutRect();

        /**
         * 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
         */
        TRect DialogRect() const;

        /**
         * Return the size of the dialog. This equals to the control 
         * size plus the margins.
         */
        TSize DialogSize() const;
        
        /**
         * Calculates the size of the dialog. This can be determined
         * using LAF values and is equal to the control size plus
         * the margins.
         */
        void DialogSizeChanged();

    protected:
        /**
         * Layout the query prompt
         */
        virtual void LayoutPrompt(const TLayoutMethod& aLayoutM);

        /**
         * Layout the image or the animation
         */
        virtual void LayoutImageOrAnim(const TLayoutMethod& aLayoutM);
        
        /**
         * Layout the text editor
         */
        virtual void LayoutEditor(const TLayoutMethod& aLayoutM);

        /**
         * Layout the editor frame
         */
        virtual void LayoutEditorFrame(const TLayoutMethod& aLayoutM);

        /**
         * Layout the editor state indicator icons
         */
        virtual void LayoutEditorIndicator(const TLayoutMethod& aLayoutM);

    protected:

        /**
        * Get the extension object instance, if any exists.
        */
        CAknQueryExtension* QueryExtension() const;

        /**
        * Draw editor frame and shadows
        */
        void DrawEditorFrame(CWindowGc& aGc,TRect& aRect) const;
    
    private:        

        /**
        * This transfers CAknQueryControl's flags set by the dialog
        * 
        * @param flag pattern to set 
        *
        */
        void SetFlags( TBitFlags16 aFlags );

        /** 
        * This acts on the Query control flags that are set from CAknQueryDialog
        *
        */
        void DeployFlagsL();

        /**
        * Call CAknTextControl::ParseTextL
        *
        */
        void DoSetPromptL();

        static TInt StaticPictographCallBack( TAny* aPtr );
        void PictographCallBack();
        
        /**
        * Checks if this query control should contain embedded virtual keypad.
        *
        * @return ETrue if embedded virtual keypad should be used.
        */
        TBool EmbeddedVirtualInput() const;
        
        /**
        * Returns pointer to dialog.
        *
        * @return Pointer to dialog if it exists.
        */
        CEikDialog* Dialog() const;
        
        /**
        * Creates increment and decrement buttons.
        *
        */
        void CreateIncAndDecButtonsL();
        
        /**
        * Creates backspace button.
        *
        */
        void CreateBackspaceButtonL();
        
        /**
        * Layouts the query prompt in case of Full Screen Query.
        *
        */
        void LayoutEditorForFullScreen( const TLayoutMethod& /*aLayoutM*/ );
        
        /**
        * Layout the text editor in case of Full Screen Query.
        *
        */
        void LayoutPromptForFullScreen();

        /**
         * Callback for pin code timeouts for producing a tacticons.
         *
         * @param aThis Pointer to this object, which is used to 
         * play tacticon.
         */
        static TInt PinCodeTimeoutCallback( TAny* aThis );
        
        /**
         * Plays a tacticon. Used by the timeout callback.
         */
        void PlayPinCodeTacticon();

        /**
         * Resets the timer for pincode query tacticon playback.
         */
        void ResetPinCodeTacticonTimer();

        /**
         * Stops/removes the timer for pincode query tacticon playback.
         */
        void StopPinCodeTacticonTimer();

    private:
        /**
        * From CAknControl
        */
        IMPORT_C void* ExtensionInterface( TUid aInterface );
	protected:
		CAknLocationEditor *&LocationEd();
		CAknLocationEditor *LocationEd() const;
    
    public:       
        /**
        *   Return prompt needed by FEP to query dialog
        */
        void GetCaption( TDes& aCaption ) const;
        
        /**
        * Sets the ECS CBA visibility in the query.
        * 
        * TBool  aVisible  @c ETrue if an ECS number is entered to the
        *                  query, @c EFalse otherwise.
        */ 
        void SetEcsCbaVisibleL( TBool aVisible );
        
        /**
        * Attempts to make an emergency call if a valid emergency
        * number has been entered to the query.
        */
        void AttemptEmergencyCallL();
        
    protected:
        /// Control for prompt text
        CAknTextControl*  iPrompt;
        /// Editor indicator icons 
        CAknQueryEditIndicator*  iEditIndicator;
        /// Edwin editor
        CEikEdwin*               iEdwin;
        /// Date editor
        CEikDateEditor*          iDateEdwin;
        /// Time editor
        CEikTimeEditor*          iTimeEdwin;
        /// Duration editor
        CEikDurationEditor*      iDurationEdwin;
        /// Secret editor
        CEikSecretEditor*        iSecretEd;
        /// Integer editor
        CAknIntegerEdwin*        iNumberEdwin; 
        /// Numeric secret editor
        CAknNumericSecretEditor* iPinEdwin;
        // Floating point editor
        CEikFloatingPointEditor* iFloatingPointEditor;
        // Image
        CEikImage*               iImage;
        /// Control id
        TInt                     iControl;
        // Layoutrect for Mfne
        TAknLayoutRect           iLayoutMfne;
        // Emergency call detector
        CAknEcsDetector*         iEcsDetector;
        // Emergency call observer
        TAknQueryEcsObserver*    iEcsObserver;
        // Flags for emergency call support and other things
        TBitFlags16              iFlags;
        TUint16                  iSpare_1; // padding
        // Animation
        CAknBitmapAnimation*     iAnimation;
        // Pointer to query control observer
        MAknQueryControlObserver* iQueryControlObserver;
        // Query type
        TInt                      iQueryType;
        // Layout rect for editor's vertical shadow
        TAknLayoutRect            iEditorVerShadow;
        // Layout rect for editor's horizontal shadow
        TAknLayoutRect            iEditorHorShadow;
        // Layout rect for editor's frame
        TAknLayoutRect            iEditorFrame;
    
        TInt       iNumberOfEditorLines; ///Maximum number of lines in the editor

        TBool      iHasEditor;   //False for confirmation queries (default), 
                                 //true for all other queries 

        CArrayFixFlat<TInt>* iLineWidths; ///Widths of prompt lines (in pixels)
        
        CAknButton* iIncreaseValueButton;  //Reserved for plus button for MFNE editors
        CAknButton* iDecreaseValueButton;  //Reserved for minus button for MFNE editors

        TSize iDialogSize;                 // Dialog size
	private:
		CAknQueryControlExtension *iExtension;
    private:
        TInt iSpare[1];
    };



/**
 * The extended control for a query dialog.
 * ip and fixed point editors
 *
 * Manage layout of elements in a query dialog:- the text, the image 
 * and the editors.
 *
 * @see CAknQueryDialog, CAknText
 * @since 2.1
 */ 

class CAknExtQueryControl : public CAknQueryControl
    {
    
    public:  // Constructors and destructor

        /**
         * C++ Constructor.
         */
        IMPORT_C CAknExtQueryControl();

        /**
         * C++ Destructor.
         */
        IMPORT_C virtual ~CAknExtQueryControl();      

    public: //New functions

        /**
        * Get ip address from ip editor.
        * 
        * @return Returns data from editor
        */
        IMPORT_C TInetAddr GetInetAddress() const;

        /**
        * Set ip address to editor
        * 
        * @param aInetAddress to editor.
        */
        IMPORT_C void SetInetAddress(TInetAddr& aInetAddress);

        /**
        * Get number from fixed point editor.
        * 
        * @return Returns number from editor
        */
        IMPORT_C TInt GetFixedPointNumber() const;

         /**
        * Set number to fixed point editor
        * @param aNumber    Number to editor
        *
        */
        IMPORT_C void SetFixedPointNumberL(const TInt* aNumber);


    public: // from CAknQueryControl

        /**
        * Set minimum and maximum ip address to editor
        * @param aMinimum   Minimum value 
        * @param aMaximum   Maximum value
        * 
        */
        IMPORT_C void SetMinimumAndMaximum(const TInetAddr& aMinimumAddress, const TInetAddr& aMaximumAddress);

        /**
        * Set minimum and maximum fixed point number to editor
        * @param aMinimumValue   Minimum value
        * @param aMaximumValue   Maximum value
        */
        IMPORT_C void SetMinimumAndMaximum(TInt aMinimumValue, TInt aMaximumValue);


        /**
        * Get pointer to query controls control (editor)
        *
        * @param aLayout    Controls layout (for one line queries use
        *                   EDataLayout, ECodeLayout... and for
        *                   multiline queries use
        *                   EMultiDataFirstEdwin, EMultiDataSecondEdwin...)
        * @return           Pointer to control, NULL if not found 
        */
        IMPORT_C virtual CCoeControl* ControlByLayoutOrNull(TInt aLayout);

        /**
        *   @return true if the content of the editor is valid, false otherwise
        */
        TBool EditorContentIsValidL() const;

        /**
        * 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.
        * 
        * @param flag pattern to set and then act on.
        */
        void SetAndUseFlagsL( TBitFlags16 aFlags );

    public: // Functions from CCoeControl

        /**
        * From CCoeControl  Added to pass-through focus-loss warnings.
        *                   if not ready, this will leave.
        * @return           Indicates whether or not the key event was used by this control.
        */
        void PrepareForFocusLossL();

        /**
        * From CCoeControl  Added to pass-through focus-loss warnings.
        *                   if not ready, this will leave.
        * @return           Indicates whether or not the key event was used by this control.
        */
        void FocusChanged(TDrawNow aDrawNow);
        

    public:// Functions from MCoeControlObserver

        /**
        * From MCoeControlObserver
        * @param aControl   Control who caused the event
        * @param aEventType Type of the event
        */
        IMPORT_C void HandleControlEventL(CCoeControl* aControl,TCoeEvent aEventType);

    
    public:// Functions from CCoeControl
        /**
        * From CCoeControl  Count number of controls contained in a compound control.  
        *  
        * @return           The number of component controls contained by this control.           
        */
        TInt CountComponentControls() const;

        /**
        * From CCoeControl  Get the components of a compound control.
        *                   It returns one of the control's component controls, identified by aIndex.
        * @param anIndex    The index of the control to get.        
        * @return           The component control with an index of aIndex.
        */
        CCoeControl* ComponentControl(TInt anIndex) const;

    	/**
    	* From CCoeControl. Handles pointer event.
    	* @param aPointerEvent Pointer event to be handled.
    	*/
    	IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);    

    public:
        /**
         * Manage indexes into LAF tables
         */
        class TIndex 
        {   
        public:     
            TIndex(TInt aNumberOfPromptLines);  
        
        public: 
            TInt PromptLine() const;    
            
        public: 
            TInt DQPWindowTextsLine2(TInt aLineNum) const;  
            TInt PNWindow() const;  
            TInt PQDWindow(TInt aLineNum) const;    
            
        private:    
            void SelfTest() const;  

        private:    
            TInt  iNumberOfPromptLines; 
        };  


    protected:
        
        /**
         * After having read the query type from resource. This method is
         * called in CostructFromResourceL()
         *
         * @see ConstructFromResourceL()
         */
        virtual void ConstructQueryL(TResourceReader& aRes);

    protected:
                
        /**
         * Layout the text editor
         */
        virtual void LayoutEditor(const TLayoutMethod& aLayoutM);

    private:

        /**
        * From CAknControl
        */
        IMPORT_C void* ExtensionInterface( TUid aInterface );        

    private:

        /**
        * This transfers CAknQueryControl's flags set by the dialog
        * 
        * @param flag pattern to set 
        *
        */
        void SetFlags( TBitFlags16 aFlags );

        /** 
        * This acts on the Query control flags that are set from CAknQueryDialog
        *
        */
        void DeployFlagsL();

        static TInt StaticPictographCallBack( TAny* aPtr );
        void PictographCallBack();

    protected:
        // editors
        CAknIpFieldEditor*      iIpEditor;
        CEikFixedPointEditor*   iFixedPointEditor;
    private:

        TAny*                   iSpare_1;
        TAny*                   iSpare_2;
    };


#endif