C++ default constructor.

Initialises the tone to ENoTone and the timeout to ENoTimeout .

TTone , TTimeout .

C++ default constructor.

Initialises the tone to aTone and the timeout to aTimeout .

TTone , TTimeout .

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!

TTone , TTimeout .

Destructor.

Deletes timer and control attributes. If the self pointer is not null, sets the pointer to point to NULL.

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.

Set timeout, tone, resource ID and then initialize and launch the dialog.

This method is deprecated and should not be used.

Set tone, resource ID and then initialize and launch the dialog.

This method is deprecated and should not be used.

Set note control ID, resource ID and then initialize and launch the dialog.

This method is deprecated and should not be used.

From CEikDialog .

Exits a sleeping dialog without deleting it.

From CAknControl .

From CCoeControl .

Processes the pointer event directed to the dialog.

From CCoeControl .

Handles a change to the control's resources of type aType which are shared across the environment, e.g. colors or fonts.

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

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.

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 .

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.

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.

CAknNoteControl::StartAnimationL() .

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.

CAknNoteAttributes , TTimer , SetEditableL() .

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.

User::ResetInactivityTime() .

Set timeout and tone and run the dialog.

This method is deprecated and should not be used.

Set tone and run the dialog.

This method is deprecated and should not be used.

Run the dialog.

This method is deprecated and should not be used.

Set NoteControlID and run the dialog.

This method is deprecated and should not be used.

From @ CEikDialog .

Executes a dialog.

Plays a tone (if one was defined) and simulates user activity. Forwards call to CEikDialog::RunLD() .

Sets a new label for the specified dialog.

This method is deprecated. SetTextL() method should be used instead.

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

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.

Sets an indication that memory should not be allocated.

This method is reserved for CEikAlert usage.

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.

AknLayoutUtils::LayoutControl() .

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.

SetTextNumberL() , SetTextPluralityL() .

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.

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.

SetTextNumberL() .

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.

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.

Sets the dialog timeout.

TTimeout .

Sets the dialog tone .

TTone .

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 .

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

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.

The tone played before the dialog is shown.

Application specific tones may be played by casting the application defined Sound ID (SID), to TTone .

Note control attributes.

Used for notes that are not modal. The calling application has no way of knowing when the note is deleted.

Note timeout in microseconds.

Note timeout timer.

The tone to be played.