Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: CLOCK.H
Link against: clock.lib

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

Members

Defined in RMessageWindow:
CancelDisplay(), ConstructL(), ConstructL(), EMaxTextLength, GetBorders(), RMessageWindow(), SetBackgroundColor(), SetBorderColor(), SetPlinthColors(), SetTextColor(), StartDisplay(), StartDisplay(), anonymous

Inherited from RAnim:
AsyncCommandReply(), Command(), CommandReply(), Construct(), Destroy()

Inherited from RAnimWithUtils:
Close()


Construction and destruction


RMessageWindow()

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.


ConstructL()

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

TRgb aBackgroundColor

Window's background colour.

TRgb aTextColor

Message text colour.

See also:


ConstructL()

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

TRgb aBackgroundColor

Window's background colour.

TRgb aTextColor

Message text colour.

TRgb aBorderColor

Window border colour.

See also:

[Top]


Member functions


StartDisplay()

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 TDesC &aText

Text to put in the window.


StartDisplay()

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 TDesC &aText

Text to put in the window.


CancelDisplay()

IMPORT_C void CancelDisplay();

Description

Cancels the display of the window.


GetBorders()

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


SetBackgroundColor()

IMPORT_C void SetBackgroundColor(TRgb aBackgroundColor);

Description

Sets the background colour for the window.

Parameters

TRgb aBackgroundColor

Background colour.


SetTextColor()

IMPORT_C void SetTextColor(TRgb aTextColor);

Description

Sets the message text colour.

Parameters

TRgb aTextColor

Message text colour.


SetBorderColor()

IMPORT_C void SetBorderColor(TRgb aBorderColor);

Description

Sets the window border colour.

Parameters

TRgb aBorderColor

Window border colour.


SetPlinthColors()

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.

[Top]


Member enumerations


Enum anonymous

n/a

Description

Defines the maximum length of text in the message.

EMaxTextLength

Maximum length of text in the message.