| class CAknMessageQueryDialog : public CAknQueryDialog |
Message query dialog.
The dialog contains text that can be scrolled page by page.
If you want to use links and/or bold text among message you must use SetMessageTextL method. Formatting text does not work through resource file. If there are incorrect/misplaced tags or tags are within each other, dialog will leave.
| Public Member Functions | |
|---|---|
| CAknMessageQueryDialog(const TTone) | |
| CAknMessageQueryDialog(TDesC *, TDesC *) | |
| CAknMessageQueryDialog(TDesC *, TDesC *, CEikImage *) | |
| CAknMessageQueryDialog(TDesC *, TDesC *, const TTone) | |
| CAknMessageQueryDialog(TDesC *, TDesC *, CEikImage *, const TTone) | |
| CAknMessageQueryDialog() | |
| ~CAknMessageQueryDialog() | |
| void | CheckLinkTappedL(TAny *) |
| IMPORT_C void | HandlePointerEventL(const TPointerEvent &) |
| IMPORT_C CAknMessageQueryDialog * | NewL(TDesC &, const TTone &) |
| IMPORT_C TKeyResponse | OfferKeyEventL(const TKeyEvent &, TEventCode) |
| IMPORT_C void | ProcessCommandL(TInt) |
| IMPORT_C void | SetHeaderText(TDesC *) |
| IMPORT_C void | SetHeaderText(const TDesC &) |
| IMPORT_C void | SetHeaderTextL(const TDesC &) |
| IMPORT_C void | SetLink(TCallBack &) |
| IMPORT_C void | SetLinkTextL(const TDesC &) |
| IMPORT_C void | SetMessageText(TDesC *) |
| IMPORT_C void | SetMessageText(const TDesC &) |
| IMPORT_C void | SetMessageTextL(const TDesC &) |
| void | UpdateSoftkeyLabels() |
| Protected Member Functions | |
|---|---|
| IMPORT_C void | PostLayoutDynInitL() |
| IMPORT_C void | PreLayoutDynInitL() |
| IMPORT_C void | SetSizeAndPosition(const TSize &) |
| Private Member Functions | |
|---|---|
| IMPORT_C void | CAknDialog_Reserved() |
| IMPORT_C void | CAknQueryDialog_Reserved() |
| IMPORT_C void | CEikDialog_Reserved_1() |
| IMPORT_C void | CEikDialog_Reserved_2() |
| TInt | CountLinks() |
| void | CreateExtensionL() |
| TBool | ExecuteLinkL() |
| IMPORT_C void * | ExtensionInterface(TUid) |
| TBool | GetNextTagL(TMsgQueryTag &) |
| TInt | LastLinkInArray() |
| TInt | LinksInArray() |
| void | ParseMessageTxtL() |
| void | RegisterPointerEventObserver(TBool) |
| void | SetMsgFormattingL(TMsgQueryTag) |
| TBool | SetNextLinkTextLocationL(const TDesC *) |
| TBool | TaggedMessageL() |
| Inherited Enumerations | |
|---|---|
| CAknQueryDialog:TTone | |
| CCoeControl:TZoomType | |
| CEikDialog:@169 | |
| Private Attributes | |
|---|---|
| TDesC * | iHeader |
| CEikImage * | iHeaderImage |
| TDesC * | iMessage |
| CAknMessageQueryDialogExtension * | iMsgQueryExtension |
| IMPORT_C | CAknMessageQueryDialog | ( | const TTone | aTone | ) |
C++ default constructor.
| const TTone aTone | Tone played with the dialog. |
| IMPORT_C | CAknMessageQueryDialog | ( | TDesC * | aMessage, |
| TDesC * | aHeader | |||
| ) | ||||
C++ default constructor.
| IMPORT_C | CAknMessageQueryDialog | ( | TDesC * | aMessage, |
| TDesC * | aHeader, | |||
| CEikImage * | aHeaderImage | |||
| ) | ||||
C++ default constructor.
| IMPORT_C | CAknMessageQueryDialog | ( | TDesC * | aMessage, |
| TDesC * | aHeader, | |||
| const TTone | aTone | |||
| ) | ||||
C++ default constructor.
| IMPORT_C | CAknMessageQueryDialog | ( | TDesC * | aMessage, |
| TDesC * | aHeader, | |||
| CEikImage * | aHeaderImage, | |||
| const TTone | aTone | |||
| ) | ||||
C++ default constructor.
| void | CheckLinkTappedL | ( | TAny * | aParams | ) |
Checks if a link is tapped. If yes and the pointer event was of type TPointerEvent::EButton1Up, then calls the callback for the tapped link.
S60 3.2
| TAny * aParams | information on the position tapped and the pointer event |
| void | CreateExtensionL | ( | ) | [private] |
If the dialog does not have an extension create one.
S60 2.8
| TBool | ExecuteLinkL | ( | ) | [private] |
Execute the current link. The link is dehighlighted after the execution. ETrue if the link was executed successfully. EFalse if no link is selected or there is no control object.
| IMPORT_C void * | ExtensionInterface | ( | TUid | aInterface | ) | [private, virtual] |
From CAknControl
| TUid aInterface |
| TBool | GetNextTagL | ( | TMsgQueryTag & | aTag | ) | [private] |
| TMsgQueryTag & aTag |
| IMPORT_C void | HandlePointerEventL | ( | const TPointerEvent & | aPointerEvent | ) | [virtual] |
From CCoeControl.
Handles pointer events
| const TPointerEvent & aPointerEvent | The pointer event. |
| IMPORT_C CAknMessageQueryDialog * | NewL | ( | TDesC & | aMessage, |
| const TTone & | aTone = ENoTone | |||
| ) | [static] | |||
Two-phased constructor.
| IMPORT_C TKeyResponse | OfferKeyEventL | ( | const TKeyEvent & | aKeyEvent, |
| TEventCode | ||||
| ) | [virtual] | |||
From CCoeControl.
Handles key events.
If a control wishes to process key events, it should implement this function. The implementation must ensure that the function returns EKeyWasNotConsumed if it does not do anything in response to a key event, otherwise, other controls or dialogs may be prevented from receiving the key event. If it is able to process the event it should return EKeyWasConsumed.
Indicates whether or not the key event was used by this control.
| const TKeyEvent & aKeyEvent | The key event. |
| TEventCode |
| IMPORT_C void | PostLayoutDynInitL | ( | ) | [protected, virtual] |
From CEikDialog
Not implemented.
| IMPORT_C void | PreLayoutDynInitL | ( | ) | [protected, virtual] |
From CEikDialog.
Should be derived to perform pre-layout dialog initialisation.
This function is called by the dialog framework before the dialog is sized and laid out. It may be overloaded to initialise the control values that should influence sizing and layout, the default implementation is empty.
| IMPORT_C void | ProcessCommandL | ( | TInt | aCommandId | ) | [virtual] |
From MEikCommandObserver.
Acts on the menu selection if menu is showing - pass on to client if not processed here.
Responds to EAknSoftkeyView and EAknSoftkeyEmpty commands.
S60 3.0
| TInt aCommandId |
| void | RegisterPointerEventObserver | ( | TBool | aRegister | ) | [private] |
Register/Unregister an observer to extendedinputcapabilities. Registering is done so that we can receive pointer events from edwin.
S60 3.2
| TBool aRegister |
| IMPORT_C void | SetHeaderText | ( | TDesC * | aHeader | ) |
Sets the dialogs header texts.
| TDesC * aHeader | Text to be inserter into the dialogs header. |
| IMPORT_C void | SetHeaderText | ( | const TDesC & | aHeader | ) |
Sets the dialogs header texts.
| const TDesC & aHeader | Text to be inserter into the dialogs header. |
| IMPORT_C void | SetHeaderTextL | ( | const TDesC & | aHeader | ) |
Sets header text.
use Heading() + CAknPopupHeadingPane API instead
| const TDesC & aHeader | Message query header text |
| IMPORT_C void | SetLink | ( | TCallBack & | aCallBack | ) |
Binds a callback to your link so that the dialog knows which callback to call when a link is activated by the user.
S60 2.8
| TCallBack & aCallBack | Points to function which is executed when a link is activated by a user. |
| IMPORT_C void | SetLinkTextL | ( | const TDesC & | aLinkText | ) |
use tags within text instead.
Changes the first occurance of aLinkText to a link within the Message. If you have many links with the same name, the method will set the links in the order you call them. Before you set a new link you have to bind the previous one with a callback by calling SetLink() function.
Note that you don't have to call this function if you have already marked your links between tags <AknMessageQuery link>=""> and </AknMessageQuery> in the Message. In that case only SetLink() method is used.
S60 2.8
| const TDesC & aLinkText | Link text inside message. |
| IMPORT_C void | SetMessageText | ( | TDesC * | aMessage | ) |
Sets the dialogs texts.
| TDesC * aMessage | Text to be inserter into the dialog. |
| IMPORT_C void | SetMessageText | ( | const TDesC & | aMessage | ) |
Sets the dialogs texts.
| const TDesC & aMessage | Text to be inserter into the dialog. |
| IMPORT_C void | SetMessageTextL | ( | const TDesC & | aMessage | ) |
Sets message text. If you have links in your message you can mark link texts between tags <AknMessageQuery link>=""> and </AknMessageQuery> in the message text. For links see also SetLink. Bold text can be achieved using tags <AknMessageQuery bold>=""> and </AknMessageQuery>
| const TDesC & aMessage | Message text inside query. Insert '\n' to get new line. |
| void | SetMsgFormattingL | ( | TMsgQueryTag | aTag | ) | [private] |
| TMsgQueryTag aTag |
| TBool | SetNextLinkTextLocationL | ( | const TDesC * | aLinkText | ) | [private] |
| const TDesC * aLinkText |
| IMPORT_C void | SetSizeAndPosition | ( | const TSize & | aSize | ) | [protected, virtual] |
From CEikDialog
Sets the size and position of the dialog.
Positions the dialog in the centre of the screen by default.
| const TSize & aSize | Not used. |
| void | UpdateSoftkeyLabels | ( | ) |
Update softkey labels depending on whether any link is highlighted. If a link is highlighted, the labels change to "View - <Empty>". If no link i highlighted, the labels change to their previous values ( Ok - Cancel ).