Class TextArea
A text box that allows multiple lines of text to be entered.

CSS Style Rules
Example
public class TextBoxExample implements EntryPoint {
public void onModuleLoad() {
// Make some text boxes. The password text box is identical to the text
// box, except that the input is visually masked by the browser.
PasswordTextBox ptb = new PasswordTextBox();
TextBox tb = new TextBox();
// Let's disallow non-numeric entry in the normal text box.
tb.addKeyboardListener(new KeyboardListenerAdapter() {
public void onKeyPress(Widget sender, char keyCode, int modifiers) {
if (!Character.isDigit(keyCode)) {
// TextBox.cancelKey() suppresses the current keyboard event.
((TextBox)sender).cancelKey();
}
}
});
// Let's make an 80x50 text area to go along with the other two.
TextArea ta = new TextArea();
ta.setCharacterWidth(80);
ta.setVisibleLines(50);
// Add them to the root panel.
VerticalPanel panel = new VerticalPanel();
panel.add(tb);
panel.add(ptb);
panel.add(ta);
RootPanel.get().add(panel);
}
}
Constructors
Methods
Constructor Detail
TextArea
public TextArea()
Creates an empty text area.
Method Detail
getCharacterWidth
public int getCharacterWidth()
Gets the requested width of the text box (this is not an exact value, as
not all characters are created equal).
Return Value
the requested width, in characters
getCursorPos
public int getCursorPos()
Gets the current position of the cursor (this also serves as the beginning
of the text selection).
Return Value
the cursor's position
getSelectionLength
public int getSelectionLength()
Gets the length of the current text selection.
Return Value
the text selection length
getVisibleLines
public int getVisibleLines()
Gets the number of text lines that are visible.
Return Value
the number of visible lines
setCharacterWidth
public void setCharacterWidth(int width)
Sets the requested width of the text box (this is not an exact value, as
not all characters are created equal).
Parameters
- width
- the requested width, in characters
setSelectionRange
public void setSelectionRange(int pos, int length)
Sets the range of text to be selected.
Parameters
- pos
- the position of the first character to be selected
- length
- the number of characters to be selected
setVisibleLines
public void setVisibleLines(int lines)
Sets the number of text lines that are visible.
Parameters
- lines
- the number of visible lines