ActiveRichTextField(String text)
Creates a new ActiveRichTextField instance from provided string after
scanning for active "links".
ActiveRichTextField(String text,
int[] offsets,
byte[] attributes,
Font[] fonts,
int[] foregroundColors,
int[] backgroundColors,
long style)
Creates a new ActiveRichTextField instance from provided formatted string
and style flags after scanning for active "links".
ActiveRichTextField(String text,
long style)
Creates a new ActiveRichTextField instance from provided string and style
flags after scanning for active "links".
Method Summary
protected void
drawFocus(Graphics graphics,
boolean on)
Draws the focus indicator for this field.
protected int
drawText(Graphics graphics,
String text,
int offset,
int len,
int x,
int y,
int flags,
int width)
Handles smileys, then hands off to RichTextField#drawText.
getContextMenuContext()
Retrieves the context object to be passed to
net.rim.device.apps.api.ui.CookieProviderUtilities#getFocusVerbs
to fetch the context menu verbs.
setAttributes(int[] colorForeground,
int[] colorBackground)
Sets new colour attributes for this field.
static void
setScanFlags(int flags)
Sets flags that govern scanning functionality.
void
setText(String text)
Provides new text for this field to show.
void
setText(String text,
int[] offsets,
byte[] attributes,
Font[] fonts)
Provides new, formatted text for this field to show, with associated cookies.
void
setText(String text,
int[] offsets,
byte[] attributes,
Font[] fonts,
int[] foregroundColors,
int[] backgroundColors)
Provides new, formatted and coloured text for this field to show, with
associated cookies.
Methods inherited from class net.rim.device.api.ui.component.RichTextField
This method populates the context menu with cut, copy, and paste
entries if appropriate. Inheriting classes should always invoke the
parent class's version of this method, to ensure the full population of
the context menu.
Cookie for provided region, or null if no cookie exists for the
region.
Since:
JDE 4.0.2
Category:
Framework: This element may be called by the underlying framework. Members that are invoked by the framework may not behave exactly as documented.
keyDown
protected boolean keyDown(int keycode,
int time)
Handles key down events.
If Keypad.KEY_APPLICATION is pressed while the cursor is over an
active region, this method dispatches to the appropriate application key
verb for that region; otherwise, this method hands the event up to the
parent.
text - New text to show in this field; this text is re-parsed
against the original patterns array to determine whether the active
regions have changed.
Since:
JDE 4.0.2
setText
public void setText(String text,
int[] offsets,
byte[] attributes,
Font[] fonts)
Provides new, formatted text for this field to show, with associated cookies.
text - New text to show in this field; this text is re-parsed
against the original patterns array to determine whether the active
regions have changed.
offsets - List of character offsets that mark formatting changes.
attributes - List that associates this field's formatting regions
with the font formats used.
Provides new, formatted and coloured text for this field to show, with
associated cookies.
Parameters:
text - New text to show in this field; this text is re-parsed
against the original patterns array to determine whether the active
regions have changed.
offsets - List of character offsets that mark formatting changes.
attributes - List that associates this field's formatting regions
with the font formats used.
fonts - List of fonts formats for this field.
foregroundColors - List of foreground colors for this field.
backgroundColors - List of background colors for this field.
Since:
JDE 4.0.2
scrollVertically
protected int scrollVertically(int amount)
Moves the cursor position vertically.
This method moves the cursor position up and down lines within this
field. If the cursor reaches the first line, or last line, in this field,
it will not wrap around the entire field.
Just before the first vertical scroll, this method remembers the
distance of the cursor from the left edge of the field (in pixels). When
it scrolls, it places the cursor over the character on the new line that
is as close as possible to the offset it remembers from its original
position.
If there is another cookie within a line either way of the current
position, this method jumps so that the current position is on top of
the new cookie.
Overrides:
scrollVertically in class net.rim.device.api.ui.component.TextField
Parameters:
amount - Amount by which to scroll (positive means down, negative
up).
This field's manager invokes this method after painting the field,
in order to overpaint the focus indictor. By default, this method simply
inverts the pixels in the focus's extent.
Note that if currently selecting more than one character in this
field, then the focus region occupies the entire extent of the selected
field.
This method also highlights current cookie regions as appropriate.
Overrides:
drawFocus in class net.rim.device.api.ui.component.TextField
Parameters:
graphics - Graphics context for drawing the focus.
on - If true, focus is over an active region, and entire active text
gets highlighted and then cursor superimposed over that; otherwise focus
painting happens as normal.
Note that this method always succeeds, even if zero characters are
copied onto the clipboard. If at least one character exists in the
selection to copy, then this method overwrites the clipboard's previous
contents.
Overrides:
selectionCopy in class net.rim.device.api.ui.component.TextField
Copyright 1999-2004 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved. Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. Copyright 2002-2003 Nokia Corporation All Rights Reserved. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
