com.google.gwt.user.client.ui
Class TextBox

java.lang.Object
  com.google.gwt.user.client.ui.UIObject
      com.google.gwt.user.client.ui.Widget
          com.google.gwt.user.client.ui.FocusWidget
              com.google.gwt.user.client.ui.TextBoxBase
                  com.google.gwt.user.client.ui.TextBox

All Implemented Interfaces:

HasAllFocusHandlers, HasAllKeyHandlers, HasAllMouseHandlers, HasBlurHandlers, HasChangeHandlers, HasClickHandlers, HasFocusHandlers, HasKeyDownHandlers, HasKeyPressHandlers, HasKeyUpHandlers, HasMouseDownHandlers, HasMouseMoveHandlers, HasMouseOutHandlers, HasMouseOverHandlers, HasMouseUpHandlers, HasMouseWheelHandlers, HasValueChangeHandlers<java.lang.String>, HasHandlers, HasDirection, EventListener, Focusable, HasFocus, HasName, HasText, HasValue<java.lang.String>, SourcesChangeEvents, SourcesClickEvents, SourcesFocusEvents, SourcesKeyboardEvents, SourcesMouseEvents

Direct Known Subclasses:

PasswordTextBox

public class TextBox
extends TextBoxBase
implements HasDirection

A standard single-line text box.

CSS Style Rules

• .gwt-TextBox { primary style }
• .gwt-TextBox-readonly { dependent style set when the text box is read-only }

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();

    // TODO(ECC) must be tested.
    tb.addKeyPressHandler(new KeyPressHandler() {

      public void onKeyPress(KeyPressEvent event) {
        if (!Character.isDigit(event.getCharCode())) {
          ((TextBox) event.getSource()).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);
  }
}

TextBox

public TextBox()

Creates an empty text box.

TextBox

protected TextBox(Element element)

This constructor may be used by subclasses to explicitly use an existing element. This element must be an <input> element whose type is 'text'.

Parameters:

element - the element to be used

wrap

public static TextBox wrap(Element element)

Creates a TextBox widget that wraps an existing <input type='text'> element. This element must already be attached to the document. If the element is removed from the document, you must call RootPanel.detachNow(Widget).

Parameters:

element - the element to be wrapped

getDirection

public HasDirection.Direction getDirection()

Description copied from interface: HasDirection

Gets the directionality of the widget.

Specified by:

getDirection in interface HasDirection

Returns:

RTL if the directionality is right-to-left, LTR if the directionality is left-to-right, or DEFAULT if the directionality is not explicitly specified

getMaxLength

public int getMaxLength()

Gets the maximum allowable length of the text box.

Returns:

the maximum length, in characters

getVisibleLength

public int getVisibleLength()

Gets the number of visible characters in the text box.

Returns:

the number of visible characters

setDirection

public void setDirection(HasDirection.Direction direction)

Description copied from interface: HasDirection

Sets the directionality for a widget.

Specified by:

setDirection in interface HasDirection

Parameters:

direction - RTL if the directionality should be set to right-to-left, LTR if the directionality should be set to left-to-right DEFAULT if the directionality should not be explicitly set

setMaxLength

public void setMaxLength(int length)

Sets the maximum allowable length of the text box.

Parameters:

length - the maximum length, in characters

setVisibleLength

public void setVisibleLength(int length)

Sets the number of visible characters in the text box.

Parameters:

length - the number of visible characters