Class RMessageWindow

class RMessageWindow : public RAnimWithUtils;

Description

A configurable window that appears for a brief time to display a message to the user and then disappears.

This is the basic class that is used by classes such as CEikonEnv and CEikMsgWin to provide information and message windows. Such higher-level classes would normally be used by client applications rather than RMessageWindow. This class can be used though to implement specialist new classes.

Note that this class is in the same library as the Clock API for implementation reasons only.

Derivation

• RAnim - Client-side handle to a server-side animation class.

• RAnimWithUtils - Utility class to support clock animation.

• RMessageWindow - A configurable window that appears for a brief time to display a message to the ...

Members

Defined in RMessageWindow:

• CancelDisplay()Cancels the display of the window.
• ConstructL(TInt,TInt,TRgb,TRgb)Performs second-phase construction.
• ConstructL(TInt,TInt,TRgb,TRgb,TRgb)Performs second-phase construction, with a window border colour.
• EMaxTextLengthMaximum length of text in the message.
• GetBorders(TMargins &)Gets the widths of the window's borders.
• RMessageWindow(RAnimDll &,const RWindowBase &)Constructor.
• SetBackgroundColor(TRgb)Sets the background colour for the window.
• SetBorderColor(TRgb)Sets the window border colour.
• SetPlinthColors(TRgb,TRgb)Sets the plinth colours.
• SetTextColor(TRgb)Sets the message text colour.
• StartDisplay(TBool,TTimeIntervalMicroSeconds32,TTimeIntervalMicroSeconds32,const TDesC &)Displays the message window for a specified time with an initial delay.
• StartDisplay(TBool,TTimeIntervalMicroSeconds32,const TDesC &)Displays the message window for a specified time.
• anonymousDefines the maximum length of text in the message.

Inherited from RAnim:

• AsyncCommandReply(TRequestStatus &,TInt,const TIpcArgs &)Sends a command and its arguments to the server-side CAnim instance asynchronous...
• Command(TInt)Sends a command to the server-side CAnim instance, and returns immediately.
• Command(TInt,const TPtrC8 &)Sends a command and its arguments to the server-side CAnim instance, and returns...
• CommandReply(TInt)Sends a command to the server-side CAnim instance, and waits for a response.
• CommandReply(TInt,const TDesC8 &,const TIpcArgs &)Sends a command and its arguments to the server-side CAnim instance, and waits f...
• CommandReply(TInt,const TPtrC8 &)Sends a command and its arguments to the server-side CAnim instance, and waits f...
• Construct(const RWindowBase &,TInt,const TDesC8 &)Completes construction of the object based on a window device, and creates the s...
• Construct(const RWindowBase &,TInt,const TDesC8 &,const TIpcArgs &)Completes construction of the object based on a window device, and creates the s...
• Construct(const RWsSprite &,TInt,const TDesC8 &)Completes construction of the Anim DLL based on a sprite.
• Construct(const RWsSprite &,TInt,const TDesC8 &,const TIpcArgs &)Completes construction of the Anim DLL based on a sprite.
• Destroy()Closes and deletes the server-side animation object.
• RAnim(RAnimDll &)Protected C++ constructor.

Inherited from RAnimWithUtils:

• Close()Closes the clock animation.

IMPORT_C RMessageWindow(RAnimDll &aAnimDll, const RWindowBase &aWindow);

Description

Constructor.

Parameters

RAnimDll &aAnimDll This RAnimDll must have been loaded with the server-side message window animation DLL, clocka.dll. const RWindowBase &aWindow Window to which to add the message window.

IMPORT_C void ConstructL(TInt aBaselineOffset, TInt aFontHandle, TRgb aBackgroundColor, TRgb aTextColor);

Description

Performs second-phase construction.

Parameters

TInt aBaselineOffset Height of window in pixels above the font's baseline. TInt aFontHandle Handle to the font to use. This can be obtained with CFbsFont::Handle()const. TRgb aBackgroundColor Window's background colour. TRgb aTextColor Message text colour.

See also:

• CFbsFont::Handle()constGets the Font and Bitmap server handle of the font.

IMPORT_C void ConstructL(TInt aBaselineOffset, TInt aFontHandle, TRgb aBackgroundColor, TRgb aTextColor, TRgb aBorderColor);

Description

Performs second-phase construction, with a window border colour.

Parameters

TInt aBaselineOffset Height of window in pixels above the font's baseline. TInt aFontHandle Handle to the font to use. This can be obtained with CFbsFont::Handle()const. TRgb aBackgroundColor Window's background colour. TRgb aTextColor Message text colour. TRgb aBorderColor Window border colour.

See also:

• CFbsFont::Handle()constGets the Font and Bitmap server handle of the font.

IMPORT_C void StartDisplay(TBool aFlash, TTimeIntervalMicroSeconds32 aInitialDelay, const TDesC &aText);

Description

Displays the message window for a specified time.

Parameters

TBool aFlash Set this to true to make the message window flash. TTimeIntervalMicroSeconds32 aInitialDelay Duration for which to display the message window. const TDesC16 &aText Text to put in the window.

IMPORT_C void StartDisplay(TBool aFlash, TTimeIntervalMicroSeconds32 aInitialDelay, TTimeIntervalMicroSeconds32 aDuration, const TDesC &aText);

Description

Displays the message window for a specified time with an initial delay.

Parameters

TBool aFlash Set this to true to make the message window flash. TTimeIntervalMicroSeconds32 aInitialDelay Initial delay before showing the window. TTimeIntervalMicroSeconds32 aDuration Duration for which to display the message window. const TDesC16 &aText Text to put in the window.

IMPORT_C void CancelDisplay();

Description

Cancels the display of the window.

IMPORT_C void GetBorders(TMargins &aBorders);

Description

Gets the widths of the window's borders.

Parameters

TMargins &aBorders On return, the widths of the window's borders

IMPORT_C void SetBackgroundColor(TRgb aBackgroundColor);

Description

Sets the background colour for the window.

Parameters

TRgb aBackgroundColor Background colour.

IMPORT_C void SetTextColor(TRgb aTextColor);

Description

Sets the message text colour.

Parameters

TRgb aTextColor Message text colour.

IMPORT_C void SetBorderColor(TRgb aBorderColor);

Description

Sets the window border colour.

Parameters

TRgb aBorderColor Window border colour.

IMPORT_C void SetPlinthColors(TRgb aTl, TRgb aBr);

Description

Sets the plinth colours.

Parameters

TRgb aTl Colour to use around the top and left borders. TRgb aBr Colour to use around the bottom and right borders.

n/a

Description

Defines the maximum length of text in the message.

EMaxTextLength Maximum length of text in the message.