Behaviour
A readonly text field for showing text in a variety of fonts and formatting.

When building a rich text field that contains formatted text, you specify a
list of offsets. These offsets define the boundaries of the various
formatting regions for the field's text. The first offset position in the
list marks the beginning of the field's text (thus is zero), and the last
offset position in the list marks the end of the field's text (this is equal
to the field's text length).

The field also has an attribute list, corresponding to the regions
described in the offset list. (The attribute list thus has one less element
in it than the offset list.) Each element's value in the attribute list is an
index into the fonts list.

The fonts list contains the various formatting styles used by the field's
contained text. Any font element with a null value that's used by the
attribute list simply indicates that the field should draw the text region
using the default font.

You can also build a RichTextField with a list of cookie objects
corresponding to various regions, as determined by the offsets list. If you
are using a cookies list, it is highly recommended to assign one element to each
region, thus the list is recommended to have one less element than the offset list.

You can use the Field.NON_FOCUSABLE style to build a rich text field that
cannot accept the focus.
See the BlackBerry Application Developer Guide Volume 1 for more information on formatting text in a RichTextField.

IllegalArgumentException - If one of the parameters is invalid (for
instance an offsets array with the final position not equal to the length
of the text, or an attributes array that is not one less in length than
the offsets array).

IllegalArgumentException - If one of the parameters is invalid (for
instance an offsets array with the final position not equal to the length
of the text, or an attributes array that is not one less in length than
the offsets array).

moveFocus

public int moveFocus(int amount,
int status,
int time)

Handles moving focus within this field.

This field's manager invokes this method to prompt this field to
handle a focus move event. If the event is an ALT-roll, then the focus
move happens horizontally (character by character); otherwise, the focus
movement happens vertically (line by line).

If this field has an empty text buffer, then this method returns the
entire scroll amount. Otherwise, it just returns any scroll amount not
used when the focus leaves the field.

IllegalArgumentException - If one of the parameters is invalid (for
instance an offsets array with the final position not equal to the length
of the text, or an attributes array that is not one less in length than
the offsets array).

IllegalArgumentException - If one of the parameters is invalid (for
instance an offsets array with the final position not equal to the length
of the text, or an attributes array that is not one less in length than
the offsets array).