RIM Device Java Library: Class Font

Font also contains metrics, since rendering characteristics are not abstracted on small device platforms. Currently, the font system assumes that all Fonts have roman baselines.

The horizontal space taken up by the glyph itself is called the glyph width. More important is the total width used to display the glyph, called the advance.

The total vertical space used to display the glyph (the block height is equal to the leading plus the ascent (the space reserved to draw the glyph above the baseline) plus the descent (the space reserved to draw the glyph below the baseline).

Font sizes always refer to the font's block height (in the case of the shown example, 10), and are always measured in pixels.

Field Summary
	`static int`	`APPLICATION` In a global event, check this flag to see if the change was an application or a global one.
	`static int`	`BOLD` Bold font style modifier
	`static int`	`DOTTED_UNDERLINED` Dotted underlined font style modifier (UNDERLINED must be specified as well)
	`static long`	`GUID_FONT_CHANGED` The GUID for the global event sent when the system font changes.
	`static int`	`ITALIC` Italic font style modifier
	`static int`	`PLAIN` Plain font style
	`static int`	`UNDERLINED` Underlined font style modifier

Method Summary
	`Font`	`derive(int style)` Derives a font with a given style and the current size.
	`Font`	`derive(int style, int height)` Derives a font of a given style and size.
	`Font`	`derive(int style, int height, int units)` Derives a font of a given style and size.
	`Font`	`derive(int style, int height, int units, int antialiasMode, int effects)` Derives a font of a given style and size , antialias mode and glyph effects Like `derive(int)`, except you can also specify a new font size as well as style.
	`Font`	`derive(int style, int height, int units, int antialiasMode, int effects, int[] transform)` Derives a font of a given style and size , antialias mode and glyph effects and affine transformation Like `derive(int)`, except you can also specify a new font size as well as style.
	`Font`	`derive(int style, int height, int units, int antialiasMode, int effects, int A, int B, int C, int D, int Tx, int Ty)` Derives a font of a given style and size , antialias mode and glyph effects and affine transformation Like `derive(int)`, except you can also specify a new font size as well as style.
	`int`	`getAdvance(char c)` Determines particular glyph width.
	`int`	`getAdvance(char[] text, int offset, int length)` Determines advance of a character array's substring.
	`int`	`getAdvance(String text)` Determines advance of a text string.
	`int`	`getAdvance(StringBuffer text, int offset, int length)` Determines advance of a string buffer's substring.
	`int`	`getAdvance(String text, int offset, int length)` Determines advance of a text string's substring.
	`int`	`getAscent()` Retrieves this font's ascent height.
	`int`	`getBaseline()` Retrieve this font's baseline position.
	`static Font`	`getDefault()` Retrieves the default font.
	`int`	`getDescent()` Retrieves this font's descender height.
	`FontFamily`	`getFontFamily()` Retrieves the font family containing this font.
	`int`	`getHeight()` Retrieves this font's height.
	`int`	`getLeading()` Retrieve this font's leading.
	`int`	`getStyle()` Retrieves this font's style.
	`boolean`	`isBold()` Indicates if this font is bold.
	`boolean`	`isItalic()` Indicates if this font is italic.
	`boolean`	`isPlain()` Indicates if this font is plain.
	`boolean`	`isUnderlined()` Indicates if this font is underlined.
	`static void`	`setDefaultFont(Font defaultFont)` Sets the default font for this application.
	`String`	`toString()` Retrieves font name as a string.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

derive

public Font derive(int style)

Derives a font with a given style and the current size.

Use derive to retrieve a new font derived from this font. For isntance, if this font is a plain font, you can retrieve the bold version with derive(this.BOLD).

This method doesn't make up new fonts out of whole cloth: if the font doesn't already exist in the system, then this method simply returns this font.

Parameters:: style - New style desired.
Returns:: Derived font, if it exists; otherwise, returns this font.
Since:: JDE 3.7.0