| class CAknNoteDialog : public CEikDialog |
The note dialog.
Giving notifications.
Asking questions.
Showing progress.
CAknNoteControl, CAknNoteAttributes, CAknText
| Protected Member Functions | |
|---|---|
| IMPORT_C CAknNoteAttributes * | ControlAttributes() |
| IMPORT_C CAknNoteControl * | NoteControl() |
| IMPORT_C void | PlayTone() |
| IMPORT_C void | PostLayoutDynInitL() |
| IMPORT_C void | PreLayoutDynInitL(void) |
| IMPORT_C void | ReportUserActivity() |
| IMPORT_C void | SetNoMemoryAllocation() |
| IMPORT_C void | SetSizeAndPosition(const TSize &) |
| IMPORT_C CAknKeySoundSystem * | SoundSystem() |
| IMPORT_C TInt | StaticDeleteL(TAny *) |
| IMPORT_C void | TransferControlAttributes() |
| Private Member Functions | |
|---|---|
| IMPORT_C void | CAknNoteDialog_Reserved() |
| IMPORT_C void | CEikDialog_Reserved_1() |
| IMPORT_C void | CEikDialog_Reserved_2() |
| TInt | CallbackStartAnimationL(TAny *) |
| void | CreateExtensionL() |
| void | DbgCheckSelfPtr(CEikDialog **) |
| IMPORT_C void * | ExtensionInterface(TUid) |
| void | SetSkinBackGroundRect() |
| IMPORT_C void | SizeChanged() |
| Public Member Enumerations | |
|---|---|
| enum | TTimeout { EUndefinedTimeout = 0, ENoTimeout = 0, EShortTimeout = 1500000, ELongTimeout = 3000000, EShortestTimeout = 500000 } |
| enum | TTone { ENoTone = 0, EConfirmationTone = EAvkonSIDConfirmationTone, EWarningTone = EAvkonSIDWarningTone, EErrorTone = EAvkonSIDErrorTone } |
| Inherited Enumerations | |
|---|---|
| CCoeControl:TZoomType | |
| CEikDialog:@169 | |
| Protected Attributes | |
|---|---|
| CAknNoteAttributes * | iControlAttributes |
| CEikDialog ** | iSelfPtr |
| TInt | iTimeoutInMicroseconds |
| CPeriodic * | iTimer |
| TTone | iTone |
| Private Attributes | |
|---|---|
| CAknNoteDialogExtension * | iNoteExtension |
| Inherited Attributes | |
|---|---|
| CCoeControl::iCoeEnv | |
| CCoeControl::iContext | |
| CCoeControl::iPosition | |
| CCoeControl::iSize | |
| CEikBorderedControl::iBorder | |
| IMPORT_C | CAknNoteDialog | ( | const TTone & | aTone, |
| const TTimeout & | aTimeout = ENoTimeout | |||
| ) | ||||
| IMPORT_C | CAknNoteDialog | ( | CEikDialog ** | aSelfPtr, |
| const TTone & | aTone = ENoTone, | |||
| const TTimeout & | aTimeout = ENoTimeout | |||
| ) | ||||
C++ default constructor.
Initialises the tone to aTone and the timeout to aTimeout. Accepts a pointer to CEikDialog*. This must be the address of the dialog pointer. When the dialog deletes itself after a timeout, the address pointed to by this pointer is set to NULL. The dialog must not be on the stack, it must be on the heap!
| CEikDialog ** aSelfPtr | Pointer to the address of the dialog. |
| const TTone & aTone = ENoTone | = ENoTone The tone. |
| const TTimeout & aTimeout = ENoTimeout | = ENoTimeout The timeout (microseconds). |
| IMPORT_C | ~CAknNoteDialog | ( | ) | [virtual] |
Destructor.
Deletes timer and control attributes. If the self pointer is not null, sets the pointer to point to NULL.
| TInt | CallbackStartAnimationL | ( | TAny * | aThis | ) | [private, static] |
| TAny * aThis |
| IMPORT_C CAknNoteAttributes * | ControlAttributes | ( | ) | [protected] |
Gets the control attributes.
If the control has already been created this method return the attributes stored inside the control. If not then the local attributes are returned. The local attributes are transferred to the control in PreLayoutDynInitL().
Derived classes should use this method when trying to access the control attributes.
Control attributes.
| void | DbgCheckSelfPtr | ( | CEikDialog ** | aSelfPtr | ) | [private] |
| CEikDialog ** aSelfPtr |
| IMPORT_C TInt | ExecuteDlgLD | ( | const TTimeout | aTimeout, |
| const TTone | aTone, | |||
| TInt | aResourceID | |||
| ) | ||||
Set timeout, tone, resource ID and then initialize and launch the dialog.
This method is deprecated and should not be used.
Zero, unless it is a waiting dialog. For a waiting dialog, the return value is the ID of the button that closed the dialog, or zero if it was the cancel button (EEikBidCancel).
| IMPORT_C TInt | ExecuteDlgLD | ( | const TTone | aTone, |
| TInt | aResourceID | |||
| ) | ||||
Set tone, resource ID and then initialize and launch the dialog.
This method is deprecated and should not be used.
Zero, unless it is a waiting dialog. For a waiting dialog, the return value is the ID of the button that closed the dialog, or zero if it was the cancel button (EEikBidCancel).
| IMPORT_C TInt | ExecuteDlgLD | ( | TInt | aResourceId, |
| TInt | aNoteControlId = 0 | |||
| ) | ||||
Set note control ID, resource ID and then initialize and launch the dialog.
This method is deprecated and should not be used.
Zero, unless it is a waiting dialog. For a waiting dialog, the return value is the ID of the button that closed the dialog, or zero if it was the cancel button (EEikBidCancel).
| IMPORT_C void | ExitSleepingDialog | ( | ) |
From CEikDialog.
Exits a sleeping dialog without deleting it.
| IMPORT_C void * | ExtensionInterface | ( | TUid | aInterface | ) | [private, virtual] |
From CAknControl.
| TUid aInterface |
| IMPORT_C void | HandlePointerEventL | ( | const TPointerEvent & | aPointerEvent | ) | [virtual] |
From CCoeControl.
Processes the pointer event directed to the dialog.
| const TPointerEvent & aPointerEvent | The pointer event directed to the notedialog. |
| IMPORT_C void | HandleResourceChange | ( | TInt | aType | ) | [virtual] |
From CCoeControl.
Handles a change to the control's resources of type aType which are shared across the environment, e.g. colors or fonts.
| TInt aType | Target resource type. |
| IMPORT_C void | LayoutAndDraw | ( | ) |
Do layout and draw the note dialog.
Needed when changing control components (e.g. the text) dynamically. This is needed because the size of the dialog might change (e.g. because of bigger text displayed in more lines, etc.) Set methods call LayoutAndDraw() if there is a change that might affect the dialog layout (e.g. text becames bigger and hence requires an extra line).
Derived classes that implement this kind of methods should call LayoutAndDraw().
| IMPORT_C CAknNoteControl * | NoteControl | ( | ) | [protected] |
Gets the Note control.
Returns the first control on the active page, which is of type CAknNoteControl. If no control is found (usually because the control has not been created yet) then this method returns NULL.
Derived classes must use this method to get access to the note control.
Pointer to the note control or NULL.
| IMPORT_C TKeyResponse | OfferKeyEventL | ( | const TKeyEvent & | aKeyEvent, |
| TEventCode | aType | |||
| ) | [virtual] | |||
From CCoeControl.
Handles key events.
Any event which is not a key press is forwarded to CEikDialog::OfferKeyEventL. ' Short key press dismiss the note by calling StaticDeleteL.
StaticDeleteL() , TKeyEvent, TEventCode.
Indicates whether or not the key event was used by this control. EKeyWasConsumed if the control takes action on the key event or EKeyWasNotConsumed otherwise.
| const TKeyEvent & aKeyEvent | Key event details. |
| TEventCode aType | Type of event (key down, key press, key release, etc). |
| IMPORT_C void | PlayTone | ( | ) | [protected] |
Plays a tone.
The tone must be previously specified. The sound ID is set depending on the tone type. The tone is played using CAknKeySoundSystem::playSound(). Derived classes must call this method if they override RunLD() and they wish to play a tone.
panic
EAknPanicNullPointer
TTone , CAknKeySoundSystem, CAknNoteDialog::RunLD().
| IMPORT_C void | PostLayoutDynInitL | ( | ) | [protected, virtual] |
From CEikDialog.
Performs dynamic operations after the layout.
Called by the Uikon framework after the dialog layout is executed, this method can be overrwritten to perform specific operations.
StartAnimationL() is called.
CAknNoteControl::StartAnimationL().
| IMPORT_C void | PreLayoutDynInitL | ( | void | ) | [protected, virtual] |
From CEikDialog.
Performs dynamic operations before the layout.
Called by the Uikon framework before the dialog layout is executed, this method can be overrwritten to perform specific operations.
The control attributes are transferred to the control. The local control attributes are copied into the real control attributes. The local attributes are then deleted.
If a timeout has been specified the timer is started. The callback is StaticDeleteL.
CAknNoteAttributes, TTimer, SetEditableL().
| void |
| IMPORT_C void | ReportUserActivity | ( | ) | const [protected] |
Indicates that there is user activity.
Resets timers which are monitoring user inactivity. This will disable functionality that checks for user inactivity by listening to these timers.
Derived classes must call this method if they override RunLD() and they wish to report user activity in order to dismiss applications such as the screen saver.
| IMPORT_C TInt | RunDlgLD | ( | const TTimeout | aTimeout, |
| const TTone | aTone | |||
| ) | ||||
Set timeout and tone and run the dialog.
This method is deprecated and should not be used.
The ID of the button used to dismiss the dialog.
| IMPORT_C TInt | RunDlgLD | ( | const TTone | aTone | ) |
Set tone and run the dialog.
This method is deprecated and should not be used.
The ID of the button used to dismiss the dialog.
| const TTone aTone | Wanted alarm tone. |
| IMPORT_C TInt | RunDlgLD | ( | ) |
Run the dialog.
This method is deprecated and should not be used.
The ID of the button used to dismiss the dialog.
| IMPORT_C TInt | RunDlgLD | ( | TInt | aNoteControlId | ) |
Set NoteControlID and run the dialog.
This method is deprecated and should not be used.
The ID of the button used to dismiss the dialog.
| TInt aNoteControlId | Not used. |
| IMPORT_C TInt | RunLD | ( | ) | [virtual] |
From @ CEikDialog.
Executes a dialog.
Plays a tone (if one was defined) and simulates user activity. Forwards call to CEikDialog::RunLD().
The ID of the button used to dismiss the dialog.
| IMPORT_C void | SetCurrentLabelL | ( | TInt | aControlId, |
| const TDesC & | aLabel | |||
| ) | ||||
Sets a new label for the specified dialog.
This method is deprecated. SetTextL() method should be used instead.
| IMPORT_C void | SetIconL | ( | CEikImage * | aIcon | ) |
Sets the dialog icon.
Changes the number type icon in the note control.
Overrides the icon which was set in the resource file. The dialog takes ownership of the pointer The numbertype icon is the small icon which is bottom left in the note (thumbnail icon).
| CEikImage * aIcon | Pointer to the icon. |
| IMPORT_C void | SetImageL | ( | CEikImage * | aImage | ) |
Set the dialog image.
Change the image in the note control. Override the image which was set in the resource file. The dialog takes ownership of the pointer. The note image is the big image or icon which is top right.
| CEikImage * aImage | Pointer to the new image. |
| IMPORT_C void | SetNoMemoryAllocation | ( | ) | [protected] |
Sets an indication that memory should not be allocated.
This method is reserved for CEikAlert usage.
| IMPORT_C void | SetSizeAndPosition | ( | const TSize & | aSize | ) | [protected, virtual] |
From CEikDialog.
Sets the size and the position for the layout.
The dialog height and width are retrieved from the control (if it exists already).If it does not exist, then default values are used. The client rect is obtained from the application UI. AknLayoutUtils::LayoutControl is then executed using the client rect and the note width and height.
| const TSize & aSize | Not used. |
| IMPORT_C void | SetTextL | ( | const TDesC & | aLabel | ) |
Sets the dialog text.
This method can set a formatted text, e.g. "You have 1 new message". It can however set an unformatted text as well, e.g. "You have \%d messages". The plurality of the dialog must be previously specified - if not singular plurality is used unless there was no singular text specified in the resource file.
| const TDesC & aLabel | The note text. |
| IMPORT_C void | SetTextNumberL | ( | TInt | aNumber | ) |
Sets the number in the dialog text.
Sets a number in the note text. If the text specified in the resource file or via SetTextL() has a %d in it, e.g. "You have \%d new messages", this number is inserted at the location specified by %d.
| TInt aNumber | The number to be inserted in the text. |
| IMPORT_C void | SetTextPluralityL | ( | const TBool | isPlural | ) |
Sets the text plurality for the dialog.
Indicates whether to use plural or singular text. These texts must have been specified in the resource file.
| const TBool isPlural | ETrue if plural text should be used, EFalse otherwise. |
| IMPORT_C void | SetTextProcessing | ( | TBool | aEnabled | ) |
Enables or disables all text processing done by the dialog. This includes text wrapping, text truncation and reordering of bidirectional text.
By default, it is enabled.
If text processing is disabled, lines are broken only at explicit line end characters and they are not truncated, but drawn as long as they fit. Also, the dialog does not handle reordering of the bidirectional text.
This method must be called before the text is set.
| TBool aEnabled | Enables or disables all text processing. |
| IMPORT_C void | SetTextWrapping | ( | TBool | aEnabled | ) |
Enables or disables text wrapping.
Enables or disables text wrapping depending on the values of aEnabled (true enables text wrapping). When text wrapping is disabled a new line in the note dialog starts only after a newline character in the note text. If a line does not fit into the dialog width it is clipped (the last character is replaced with an ellipsis sign).
This method must be called before SetTextL as it only influences the wrapping of text that it is yet to be set via API.
| TBool aEnabled | ETrue for enabling text wrapping, EFalse for disabling it. |
| IMPORT_C void | SetTimeout | ( | const TTimeout & | aTimeout | ) |
Sets the dialog timeout.
TTimeout .
| const TTimeout & aTimeout | The dialog timeout. |
| IMPORT_C void | SetTone | ( | const TTone & | aTone | ) |
Sets the dialog tone .
TTone .
| const TTone & aTone | The dialog tone. |
| IMPORT_C CAknKeySoundSystem * | SoundSystem | ( | ) | const [protected] |
Gets the used sound system.
Calls iEikonEnv->AppUi()->KeySounds() and returns the pointer returned by the called method. If there is no application UI return NULL.
CAknKeySoundSystem, CAknAppUi.
Pointer to the used CAknKeySoundSystem or NULL.
panic
EAknPanicNullPointer
| IMPORT_C TInt | StaticDeleteL | ( | TAny * | aThis | ) | [protected, static] |
Deletes the note dialog.
Called when the timer completes, this method deletes the dialog. A reinterpret_cast to CAknNoteDialog* is performed on aThis. If the dialog is not a sleeping note then it is deleted. If it is a sleeping dialog then the timer is stopped, OkToExitL() is called with KErrCancel and ExitSleepingDialog is executed.
TTimer, OkToExitL(), ExitSleepingDialog().
Always returns EFalse.
| TAny * aThis | Pointer to the dialog. |
| IMPORT_C void | TransferControlAttributes | ( | ) | [protected] |
Transfers the control attributes from the dialog to the control.
Must be called by derived classes in PreLayoutDynInitL() if this method is not called then the set of API methods that were invoked before the control is created will not work.
The timeout in microseconds for automatically deleting the dialog.
| EUndefinedTimeout = 0 |
Deprecated (not used). |
| ENoTimeout = 0 | |
| EShortTimeout = 1500000 | |
| ELongTimeout = 3000000 | |
| EShortestTimeout = 500000 |
The tone played before the dialog is shown.
Application specific tones may be played by casting the application defined Sound ID (SID), to TTone.
| ENoTone = 0 |
No tone is played. |
| EConfirmationTone = EAvkonSIDConfirmationTone |
A confirmation tone is played. |
| EWarningTone = EAvkonSIDWarningTone |
A warning tone is played. |
| EErrorTone = EAvkonSIDErrorTone |
An error tone is played. |
| CAknNoteAttributes * | iControlAttributes | [protected] |
Note control attributes.
| CEikDialog ** | iSelfPtr | [protected] |
Used for notes that are not modal. The calling application has no way of knowing when the note is deleted.