#include <textbase.h>
class CTypefaceStore : public CBase |
Protected Attributes | |
---|---|
CArrayFixFlat< TFontAccess > * | iFontAccess |
Public Member Functions | |
---|---|
~CTypefaceStore() | |
IMPORT_C TInt | BaselineOffset(TInt, TFontPrintPosition) |
pure virtual TInt | FontHeightInTwips(TInt, TInt) |
pure virtual TInt | GetNearestFontInTwips(CFont *&, const TFontSpec &) |
pure virtual TInt | GetNearestFontToDesignHeightInTwips(CFont *&, const TFontSpec &) |
pure virtual TInt | GetNearestFontToMaxHeightInTwips(CFont *&, const TFontSpec &, TInt) |
pure virtual TInt | NumTypefaces() |
IMPORT_C void | ReleaseFont(CFont *) |
IMPORT_C TInt | SuperSubHeight(TInt, TFontPrintPosition) |
pure virtual void | TypefaceSupport(TTypefaceSupport &, TInt) |
Protected Member Functions | |
---|---|
CTypefaceStore() | |
IMPORT_C void | AddFontL(CFont *) |
IMPORT_C void | ConstructL() |
IMPORT_C TBool | IncrementFontCount(const CFont *) |
Typeface store abstract base interface.
This class provides the interface to a store for typefaces.
See also CFontStore.
CArrayFixFlat< TFontAccess > * | iFontAccess | [protected] |
A list of fonts accessed by clients of the typeface store, which pairs a font with a count of the number of clients accessing the font.
Implemented as an array of TFontAccess objects.
An object is added to this array for every font accessed. If the font is released by all clients, and the access count drops to zero, the font is removed from the list.
IMPORT_C | CTypefaceStore | ( | ) | [protected] |
IMPORT_C | ~CTypefaceStore | ( | ) |
IMPORT_C void | AddFontL | ( | CFont * | aFont | ) | [protected] |
IMPORT_C TInt | BaselineOffset | ( | TInt | aHeight, |
TFontPrintPosition | aPos | |||
) | [static] |
IMPORT_C void | ConstructL | ( | ) | [protected] |
Gets the height of the font with specified height and typeface indices, in twips.
The value returned is rounded up or down to the nearest font height in twips.
Parameters | |
---|---|
aTypefaceIndex | A typeface index number, in the range: 0 to (NumTypefaces() - 1). |
aHeightIndex | A font height index number. |
Gets the font which is the nearest to the given font specification.
When the font is no longer needed, call ReleaseFont().
Note that this deprecated function is replaced by the new GetNearestFontToDesignHeightInTwips() yielding (virtually) the same result. However clients are strongly encouraged to use the new GetNearestFontToMaxHeightInTwips() function instead. This will guarantee that every character within any given text string will fit within the given amount of twips, whereas the design height is an aesthetic unit decided by the font designer without strict physical meaning, which may result in cropped characters.
DeprecatedUse GetNearestFontToDesignHeightInTwips
Parameters | |
---|---|
aFont | On return, contains a pointer to the nearest font. |
aFontSpec | The specification of the font to be matched. |
Gets the font which is the nearest to the given font specification.
When the font is no longer needed, call ReleaseFont().
This new function replaces the deprecated GetNearestFontInTwips() yielding (virtually) the same result. However clients are strongly encouraged to use the new GetNearestFontToMaxHeightInTwips() function instead. This will guarantee that every character within any given text string will fit within the given amount of twips, whereas the design height is an aesthetic unit decided by the font designer without strict physical meaning, which may result in cropped characters.
Parameters | |
---|---|
aFont | On return, contains a pointer to the nearest font. |
aFontSpec | The specification of the font to be matched. |
TInt | GetNearestFontToMaxHeightInTwips | ( | CFont *& | aFont, |
const TFontSpec & | aFontSpec, | |||
TInt | aMaxHeight | |||
) | [pure virtual] |
Gets the font which is the nearest to the given font specification.
When the font is no longer needed, call ReleaseFont().
The font and bitmap server returns a pointer to the nearest matching font from those available. Matches to max height of font - this does its best to return a font that will fit within the maximum height specified (but note that variations due to hinting algorithms may rarely result in this height being exceeded by up to one pixel). Problems can also be encountered with bitmap fonts where the typeface exists but doesn't have a font small enough.
Parameters | |
---|---|
aFont | On return, contains a pointer to the nearest font. |
aFontSpec | The specification of the font to be matched. |
aMaxHeight | The maximum height within which the font must fit. |
TInt | NumTypefaces | ( | ) | const [pure virtual] |
Gets the number of typefaces supported by the typeface store.
IMPORT_C void | ReleaseFont | ( | CFont * | aFont | ) |
IMPORT_C TInt | SuperSubHeight | ( | TInt | aHeight, |
TFontPrintPosition | aPos | |||
) | [static] |
void | TypefaceSupport | ( | TTypefaceSupport & | aTypefaceSupport, |
TInt | aTypefaceIndex | |||
) | const [pure virtual] |
Gets typeface information for a specified typeface index.
This information is returned in aTypefaceSupport, and includes the typeface name and typeface attributes, the number of font heights, the maximum and minimum font heights, and whether it is a scaleable typeface.
Parameters | |
---|---|
aTypefaceSupport | On return, if the function executed successfully, this object contains the typeface information. |
aTypefaceIndex | A typeface index number, in the range: zero to (NumTypefaces() - 1). |