Symbian
Symbian OS Library

SYMBIAN OS V9.3

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



Location: TXTFRMAT.H
Link against: etext.lib

Class TCharFormatMask

class TCharFormatMask;

Description

Masks the character format attributes which are involved when setting and sensing character formatting.

Used in conjunction with an object of class TCharFormat.

When setting formatting, only the attributes which are set in the mask should participate in the relevant function. When sensing formatting, on return, the mask indicates which attributes were sensed from the format layer, and were not taken from the default values.

Members

Defined in TCharFormatMask:
AttribIsSet(), ClearAll(), ClearAttrib(), IsNull(), SetAll(), SetAttrib(), TCharFormatMask(), operator!=(), operator==()


Construction and destruction


TCharFormatMask()

inline TCharFormatMask();

Description

The default C++ constructor constructs a character format mask, initialising all bits to zero.

[Top]


Member functions


SetAttrib()

inline void SetAttrib(TTextFormatAttribute aAttribute);

Description

Sets a single attribute flag in the character format mask.

Parameters

TTextFormatAttribute aAttribute

The attribute flag to set.


ClearAttrib()

inline void ClearAttrib(TTextFormatAttribute aAttribute);

Description

Clears a single attribute flag in the character format mask.

Parameters

TTextFormatAttribute aAttribute

The attribute flag to clear.


AttribIsSet()

inline TBool AttribIsSet(TTextFormatAttribute aAttribute) const;

Description

Tests whether an attribute flag is set.

Parameters

TTextFormatAttribute aAttribute

The character format attribute to test for.

Return value

TBool

ETrue if the flag is set, EFalse if not.


SetAll()

IMPORT_C void SetAll();

Description

Sets all attribute flags in the character format mask.


ClearAll()

IMPORT_C void ClearAll();

Description

Clears all attribute flags in the character format mask.


IsNull()

inline TBool IsNull() const;

Description

Tests whether the mask is NULL, indicating that no flags have been set.

Return value

TBool

ETrue if mask is NULL, EFalse if not NULL.


operator==()

IMPORT_C TBool operator==(const TCharFormatMask &aMask) const;

Description

Compares two character format masks for equality.

Parameters

const TCharFormatMask &aMask

The mask to compare.

Return value

TBool

ETrue if all flags are the same in both masks. EFalse if any differ.


operator!=()

inline TBool operator!=(const TCharFormatMask &aMask) const;

Description

Compares two paragraph format masks for inequality.

Parameters

const TCharFormatMask &aMask

The mask to compare.

Return value

TBool

ETrue if any flags are different. EFalse if all flags are the same.