#include <mw/AknQueryDialog.h>
| class CAknMultiLineDataQueryDialog : public CAknQueryDialog |
| Protected Attributes | |
|---|---|
| TDes16 * | iSecondText |
| TDes16 * | iText |
| Protected Member Functions | |
|---|---|
| CAknMultiLineDataQueryDialog(const TTone &) | |
| CAknMultiLineDataQueryDialog * | DoNewL(T1 &, T2 &, const TTone &) |
| virtual IMPORT_C void | DoSetPromptL() |
| IMPORT_C CAknMultilineQueryControl * | FirstControl() |
| T & | FirstData(const T &) |
| const T & | FirstData(const T &) |
| virtual IMPORT_C void | HandleResourceChange(TInt) |
| virtual IMPORT_C TBool | NeedToDismissQueryL(const TKeyEvent &) |
| virtual IMPORT_C TBool | OkToExitL(TInt) |
| virtual IMPORT_C void | PreLayoutDynInitL() |
| virtual IMPORT_C CAknQueryControl * | QueryControl() |
| virtual IMPORT_C CAknPopupHeadingPane * | QueryHeading() |
| IMPORT_C CAknMultilineQueryControl * | SecondControl() |
| T & | SecondData(const T &) |
| const T & | SecondData(const T &) |
| IMPORT_C TPtrC | SecondPrompt() |
| void | SetDataL(T1 &, T2 &) |
| virtual IMPORT_C void | UpdateLeftSoftKeyL() |
| Inherited Enumerations | |
|---|---|
| CAknQueryDialog:TTone | |
| CCoeControl:TZoomType | |
| CEikDialog:@121 | |
Query dialog with data input on more than one line (2 lines at the moment).
Object of this class is created by using NewL method and by passing parameters as appropriate.
Attention: When deriving from this class, you must call SetDataL() during second phase construction.
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.
Enumeration values: ENoTone No tone is played. EConfirmationTone A confirmation tone is played. EWarningTone A warning tone is played. EErrorTone An error tone is played.
| TDes16 * | iSecondText | [protected] |
Deprecated do not use A text of the secondline. DeprecatedUse data access template methods instead.
| TDes16 * | iText | [protected] |
Deprecated - use data access template methods instead A text of the first line. DeprecatedUse data access template methods instead.
| IMPORT_C | CAknMultiLineDataQueryDialog | ( | const TTone & | aTone | ) | [protected] |
C++ default constructor.
| Parameter | Description |
|---|---|
| aTone | Reference to TTone enumeration. |
| IMPORT_C | CAknMultiLineDataQueryDialog | ( | TTime * | aTime, |
| TTime * | aTime2, | |||
| TDesC * | aPrompt = NULL, | |||
| TDesC * | aPrompt2 = NULL, | |||
| const TTone & | aTone = ENoTone | |||
| ) | ||||
Constructor.
| Parameter | Description |
|---|---|
| aTime | First line parameter. |
| aTime2 | Second line parameter. |
| aPrompt | First prompt value. NULL in default. |
| aPrompt2 | Second prompt value. NULL in default. |
| aTone | Reference to TTone enum. Default is ENoTone. |
| IMPORT_C | CAknMultiLineDataQueryDialog | ( | TDes * | aDataText, |
| TDes * | aDataText2, | |||
| TDesC * | aPrompt = NULL, | |||
| TDesC * | aPrompt2 = NULL, | |||
| const TTone & | aTone = ENoTone | |||
| ) | ||||
Constructor.
| Parameter | Description |
|---|---|
| aDataText | First line parameter. |
| aDataText2 | Second line parameter. |
| aPrompt | First prompt value. NULL in default. |
| aPrompt2 | Second prompt value. NULL in default. |
| aTone | Reference to TTone enum. Default is ENoTone. |
| IMPORT_C | CAknMultiLineDataQueryDialog | ( | TDes * | aDataText, |
| TTime * | aTime, | |||
| TDesC * | aPrompt = NULL, | |||
| TDesC * | aPrompt2 = NULL, | |||
| const TTone & | aTone = ENoTone | |||
| ) | ||||
Constructor.
| Parameter | Description |
|---|---|
| aDataText | First line parameter. |
| aTime | Second line parameter. |
| aPrompt | First prompt value. NULL in default. |
| aPrompt2 | Second prompt value. NULL in default. |
| aTone | Reference to TTone enum. Default is ENoTone. |
| IMPORT_C | CAknMultiLineDataQueryDialog | ( | TDes * | aDataText, |
| TInt * | aNumber, | |||
| TDesC * | aPrompt = NULL, | |||
| TDesC * | aPrompt2 = NULL, | |||
| const TTone & | aTone = ENoTone | |||
| ) | ||||
Constructor.
| Parameter | Description |
|---|---|
| aDataText | First line parameter. |
| aNumber | Second line parameter. |
| aPrompt | First prompt value. NULL in default. |
| aPrompt2 | Second prompt value. NULL in default. |
| aTone | Reference to TTone enum. Default is ENoTone. |
| IMPORT_C | CAknMultiLineDataQueryDialog | ( | TDes * | aDataText, |
| TTimeIntervalSeconds * | aDuration, | |||
| TDesC * | aPrompt = NULL, | |||
| TDesC * | aPrompt2 = NULL, | |||
| const TTone & | aTone = ENoTone | |||
| ) | ||||
Constructor.
| Parameter | Description |
|---|---|
| aDataText | First line parameter. |
| aDuration | Second line parameter. |
| aPrompt | First prompt value. NULL in default. |
| aPrompt2 | Second prompt value. NULL in default. |
| aTone | Reference to TTone enum. Default is ENoTone. |
| IMPORT_C | CAknMultiLineDataQueryDialog | ( | TTime * | aTime, |
| TTimeIntervalSeconds * | aDuration, | |||
| TDesC * | aPrompt = NULL, | |||
| TDesC * | aPrompt2 = NULL, | |||
| const TTone & | aTone = ENoTone | |||
| ) | ||||
Constructor.
| Parameter | Description |
|---|---|
| aTime | First line parameter. |
| aDuration | Second line parameter. |
| aPrompt | First prompt value. NULL in default. |
| aPrompt2 | Second prompt value. NULL in default. |
| aTone | Reference to TTone enum. Default is ENoTone. |
| IMPORT_C | CAknMultiLineDataQueryDialog | ( | TInt * | aNumber, |
| TInt * | aNumber2, | |||
| TDesC * | aPrompt = NULL, | |||
| TDesC * | aPrompt2 = NULL, | |||
| const TTone & | aTone = ENoTone | |||
| ) | ||||
Constructor.
| Parameter | Description |
|---|---|
| aNumber | First line parameter. |
| aNumber2 | Second line parameter. |
| aPrompt | First prompt value. NULL in default. |
| aPrompt2 | Second prompt value. NULL in default. |
| aTone | Reference to TTone enum. Default is ENoTone. |
| CAknMultiLineDataQueryDialog * | DoNewL | ( | T1 & | aData1, |
| T2 & | aData2, | |||
| const TTone & | aTone | |||
| ) | [protected, static, inline] | |||
Utility function called by NewL() method - should really be private but it is left here to show to people extending this class what their NewL() method should do.
Creates new instance of the multiline dialog.
| Parameter | Description |
|---|---|
| aData1 | First line parameter. |
| aData2 | Second line parameter. |
| aTone | Reference to TTone enum. |
| IMPORT_C void | DoSetPromptL | ( | ) | [protected, virtual] |
Reimplemented from CAknQueryDialog::DoSetPromptL()
Sets the prompt inside the query control.
| IMPORT_C CAknMultilineQueryControl * | FirstControl | ( | ) | const [protected] |
Access to 1st query control
Returns: Pointer to the control of the first line.
| T & | FirstData | ( | const T & | ) | [protected, inline] |
Data access.
Derived class can use this method to get access to the query data. The query data is a reference stored in TAknQueryData, see aknquerydata.h
The client ultimately owns the data this reference references and so it should never need to call these methods.
Derived class however, might need to set or get the data and hence this method have been provided. The derived class is responsible for choosing the correct type, if not the cast will fail.
| const T & | FirstData | ( | const T & | ) | const [protected, inline] |
Data access.
Derived class can use this method to get access to the query data. The query data is a reference stored in TAknQueryData, see aknquerydata.h
The client ultimately owns the data this reference references and so it should never need to call these methods.
Derived class however, might need to set or get the data and hence this method have been provided. The derived class is responsible for choosing the correct type, if not the cast will fail.
| IMPORT_C void | HandlePointerEventL | ( | const TPointerEvent & | aPointerEvent | ) | [virtual] |
Reimplemented from CAknQueryDialog::HandlePointerEventL(const TPointerEvent &)
From CCoeControl.
Handles pointer events.
| Parameter | Description |
|---|---|
| aPointerEvent | The pointer event. |
| IMPORT_C void | HandleResourceChange | ( | TInt | aType | ) | [protected, virtual] |
Reimplemented from CEikDialog::HandleResourceChange(TInt)
From CCoeControl.
Handles a change to the control's resources. The types of resources handled are those which are shared across the environment, e.g. colours or fonts.
| Parameter | Description |
|---|---|
| aType | A message UID value. The most common is KEikMessageColorSchemeChange which controls get when the colour scheme is changed. Other examples include: KEikMessageFadeAllWindows, KEikMessageUnfadeWindows, KEikMessageZoomChange, KEikMessageVirtualCursorStateChange, KEikMessageCapsLock, KEikMessagePrepareForSave. |
Reimplemented from CAknQueryDialog::NeedToDismissQueryL(const TKeyEvent &)
Allows dismissing of queries. Same as base class implementation only take into consideration both controls
| IMPORT_C CAknMultiLineDataQueryDialog * | NewL | ( | TTime & | aTime1, |
| TTime & | aTime2, | |||
| TTone | aTone = ENoTone | |||
| ) | [static] | |||
Creates a new instance of a multiline dialog.
| Parameter | Description |
|---|---|
| aTime1 | First line parameter. |
| aTime2 | Second line parameter. |
| aTone | Reference to TTone enumeration. Default is ENoTone. |
Returns: Pointer to a multiline dialog object.
| IMPORT_C CAknMultiLineDataQueryDialog * | NewL | ( | TDes & | aText1, |
| TDes & | aText2, | |||
| TTone | aTone = ENoTone | |||
| ) | [static] | |||
Creates a new instance of a multiline dialog.
| Parameter | Description |
|---|---|
| aText1 | First line parameter. |
| aText2 | Second line parameter. |
| aTone | Reference to TTone enumeration. Default is ENoTone. |
Returns: Pointer to a multiline dialog object.
| IMPORT_C CAknMultiLineDataQueryDialog * | NewL | ( | TDes & | aText1, |
| TTime & | aTime2, | |||
| TTone | aTone = ENoTone | |||
| ) | [static] | |||
Creates a new instance of a multiline dialog.
| Parameter | Description |
|---|---|
| aText1 | First line parameter. |
| aTime2 | Second line parameter. |
| aTone | Reference to TTone enumeration. Default is ENoTone. |
Returns: Pointer to a multiline dialog object.
| IMPORT_C CAknMultiLineDataQueryDialog * | NewL | ( | TDes & | aText1, |
| TInt & | aNum2, | |||
| TTone | aTone = ENoTone | |||
| ) | [static] | |||
Creates a new instance of a multiline dialog.
| Parameter | Description |
|---|---|
| aText1 | First line parameter. |
| aNum2 | Second line parameter. |
| aTone | Reference to TTone enumeration. Default is ENoTone. |
Returns: Pointer to a multiline dialog object.
| IMPORT_C CAknMultiLineDataQueryDialog * | NewL | ( | TDes & | aText1, |
| TTimeIntervalSeconds & | aDur2, | |||
| TTone | aTone = ENoTone | |||
| ) | [static] | |||
Creates a new instance of a multiline dialog.
| Parameter | Description |
|---|---|
| aText1 | First line parameter. |
| aDur2 | Second line parameter. |
| aTone | Reference to TTone enumeration. Default is ENoTone. |
Returns: Pointer to a multiline dialog object.
| IMPORT_C CAknMultiLineDataQueryDialog * | NewL | ( | TTime & | aTime1, |
| TTimeIntervalSeconds & | aDur2, | |||
| TTone | aTone = ENoTone | |||
| ) | [static] | |||
Creates a new instance of a multiline dialog.
| Parameter | Description |
|---|---|
| aTime1 | First line parameter. |
| aDur2 | Second line parameter. |
| aTone | Reference to TTone enumeration. Default is ENoTone. |
Returns: Pointer to a multiline dialog object.
| IMPORT_C CAknMultiLineDataQueryDialog * | NewL | ( | TInt & | aNum1, |
| TInt & | aNum2, | |||
| TTone | aTone = ENoTone | |||
| ) | [static] | |||
Creates a new instance of a multiline dialog.
| Parameter | Description |
|---|---|
| aNum1 | First line parameter. |
| aNum2 | Second line parameter. |
| aTone | Reference to TTone enumeration. Default is ENoTone. |
Returns: Pointer to multiline dialog object.
| IMPORT_C CAknMultiLineDataQueryDialog * | NewL | ( | TPosition & | aPos, |
| TTone | aTone = ENoTone | |||
| ) | [static] | |||
Creates a new instance of a multiline dialog.
| Parameter | Description |
|---|---|
| aPos | Position parameter. |
| aTone | Reference to TTone enumeration. Default is ENoTone. |
Returns: Pointer to multiline dialog object.
Reimplemented from CAknQueryDialog::OkToExitL(TInt)
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.
| Parameter | Description |
|---|---|
| aButtonId | The ID of the button that was activated. |
Returns: ETrue if the dialog should exit and EFalse if it should not exit.
| IMPORT_C void | PreLayoutDynInitL | ( | ) | [protected, virtual] |
Reimplemented from CAknQueryDialog::PreLayoutDynInitL(void)
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. Note:
Control values that should not influence the sizing and layout are set using PostLayoutDynInitL().
| IMPORT_C CAknQueryControl * | QueryControl | ( | ) | const [protected, virtual] |
Reimplemented from CAknQueryDialog::QueryControl()const
Gets a querycontrol.
Returns: Pointer to the control of the first line.
| IMPORT_C CAknPopupHeadingPane * | QueryHeading | ( | ) | const [protected, virtual] |
Reimplemented from CAknQueryDialog::QueryHeading()const
Not implemented.
Returns: NULL.
| IMPORT_C CAknMultilineQueryControl * | SecondControl | ( | ) | const [protected] |
Access to 2nd query control
Returns: Pointer to the control of the second line.
| T & | SecondData | ( | const T & | ) | [protected, inline] |
Data access.
Derived class can use this method to get access to the query data. The query data is a reference stored in TAknQueryData, see aknquerydata.h
The client ultimately owns the data this reference references and so it should never need to call these methods.
Derived class however, might need to set or get the data and hence this method have been provided. The derived class is responsible for choosing the correct type, if not the cast will fail.
| const T & | SecondData | ( | const T & | ) | const [protected, inline] |
Data access.
Derived class can use this method to get access to the query data. The query data is a reference stored in TAknQueryData, see aknquerydata.h
The client ultimately owns the data this reference references and so it should never need to call these methods.
Derived class however, might need to set or get the data and hence this method have been provided. The derived class is responsible for choosing the correct type, if not the cast will fail.
| IMPORT_C TPtrC | SecondPrompt | ( | ) | const [protected] |
Prompts access for derived classes.
Returns: Pointer to the data of the second line.
| void | SetDataL | ( | T1 & | aData1, |
| T2 & | aData2 | |||
| ) | [protected, inline] | |||
Sets the query data for the first and the second line. Must be called by derived classes during second phase construction (NewL() method).
| IMPORT_C void | SetMaxLengthOfFirstEditor | ( | TInt | aFirstTextEditorMaxLength | ) |
Sets a max length for the first editor in a query.
| Parameter | Description |
|---|---|
| aFirstTextEditorMaxLength | Max length for editor |
| IMPORT_C void | SetMaxLengthOfSecondEditor | ( | TInt | aSecondTextEditorMaxLength | ) |
Sets a max length for the second editor in a query.
| Parameter | Description |
|---|---|
| aSecondTextEditorMaxLength | Max length for editor. |
| IMPORT_C void | UpdateLeftSoftKeyL | ( | ) | [protected, virtual] |
Reimplemented from CAknQueryDialog::UpdateLeftSoftKeyL()
If the query text is ok (retrieved form query controls) the left soft key is displayed, otherwise it is hidden.