TAknTextDecorationMetrics Class Reference

API published in: S60 3rd Ed

Link against: uiklaf.lib avkon.lib fontutils.lib

Capability Information

Required Capabilities

None


#include <akntextdecorationmetrics.h>

Detailed Description

This class contains information to decorate a text with highlights, cursors and margins.

Construction is performed driven by metrics and style derived from the various object that are used in the different contstructors. The metrics used are height, weight, and posture.

From Series 60 font id, the current layout is accessed to provide metrics and style info. From a CFont object, the font's own accessible metrics and styles are accessed (e.g. HeightInPixels()) From a TFontSpec object, the height and style are extracted via its APIs.


Public Member Functions

IMPORT_C  TAknTextDecorationMetrics (TInt aFontId)
  Construct the object with values that are correct for the given font identifier.
IMPORT_C  TAknTextDecorationMetrics (const CFont *aFont)
  Construct the object with values that are correct for the given Symbian Font A null pointer passed in will result in a default set of metrics.
IMPORT_C  TAknTextDecorationMetrics (const TAknFontSpecification &aFontSpecification)
  Construct the object with values that are correct for the given Series 60 Font Specification.
IMPORT_C void  GetLeftAndRightMargins (TInt &aLeft, TInt &aRight) const
  Fetch the values in pixels for the distances reserved for cursor and highlights that extend beyond the font's rendering area (where the glyphs draw).
IMPORT_C void  GetTopAndBottomMargins (TInt &aTop, TInt &aBottom) const
  Fetch the values in pixels for the distances reserved for cursor and highlights that extend beyond the font's rendering area (where the glyphs draw).
IMPORT_C TInt  CursorWidth () const
  Width of the cursor in pixels.
IMPORT_C TInt  BaselineToUnderlineOffset () const
  Offset distance measured from the bottom of the baseline row of pixels to the bottom of the underline.
IMPORT_C TInt  UnderlineHeight () const
  Height (i.e.

Constructor & Destructor Documentation

IMPORT_C TAknTextDecorationMetrics::TAknTextDecorationMetrics TInt  aFontId  ) 
 

Construct the object with values that are correct for the given font identifier.

Parameters:
A  Series 60 Font id
IMPORT_C TAknTextDecorationMetrics::TAknTextDecorationMetrics const CFont *  aFont  ) 
 

Construct the object with values that are correct for the given Symbian Font A null pointer passed in will result in a default set of metrics.

Parameters:
A  generic Symbian font object pointer
IMPORT_C TAknTextDecorationMetrics::TAknTextDecorationMetrics const TAknFontSpecification aFontSpecification  ) 
 

Construct the object with values that are correct for the given Series 60 Font Specification.

This constructor depends upon the font height and boldness being set in the font specifcation object.

Parameters:
A  Series 60 font specification

Member Function Documentation

IMPORT_C TInt TAknTextDecorationMetrics::BaselineToUnderlineOffset  )  const
 

Offset distance measured from the bottom of the baseline row of pixels to the bottom of the underline.

E.g. if this method returns 3, and the underline height is 1, then there are 2 pixel rows of gap between the baseline of glyphs and the underline.

The baseline referred to is the natural baseline of the glyph, not the formal baseline reported by the font. To draw the underline, it may be necessary, depending on how the font is compounded, to find the baseline (i.e. ascent) of individual character codes' glyphs.

Returns:
Offset distance measured from bottom of glyphs baseline to bottom of underline graphics
IMPORT_C TInt TAknTextDecorationMetrics::CursorWidth  )  const
 

Width of the cursor in pixels.

This width is to be used when cursor is drawn rather than an image.

Returns:
Width of the cursor in pixels.
IMPORT_C void TAknTextDecorationMetrics::GetLeftAndRightMargins TInt &  aLeft,
TInt &  aRight
const
 

Fetch the values in pixels for the distances reserved for cursor and highlights that extend beyond the font's rendering area (where the glyphs draw).

Values are positive for any normal margin - one that is outside the glyphs area.

Parameters:
aLeft  number of extra columns of pixels left of glyphs for additional graphics
aRight  number of extra rows of pixels right of glyphs for additional graphics
IMPORT_C void TAknTextDecorationMetrics::GetTopAndBottomMargins TInt &  aTop,
TInt &  aBottom
const
 

Fetch the values in pixels for the distances reserved for cursor and highlights that extend beyond the font's rendering area (where the glyphs draw).

Values are positive for any normal margin - one that is outside the glyphs area.

Parameters:
aTop  number of extra rows of pixels above font ascent for additional graphics
aTop  number of extra rows of pixels below font descent for additional graphics
IMPORT_C TInt TAknTextDecorationMetrics::UnderlineHeight  )  const
 

Height (i.e.

thickness) of the drawing of the underline Positive for any visible line. e.g. a value of 1, means one row of pixels is drawn.

Returns:
Number of rows pixels in the underline graphics

The documentation for this class was generated from the following file:

Copyright © Nokia Corporation 2001-2008
Back to top