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:
- HasDirection, EventListener, HasFocus, HasName, HasText, SourcesChangeEvents, SourcesClickEvents, SourcesFocusEvents, SourcesKeyboardEvents
- 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();
// 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)) && (keyCode != (char) KEY_TAB)
&& (keyCode != (char) KEY_BACKSPACE)
&& (keyCode != (char) KEY_DELETE) && (keyCode != (char) KEY_ENTER)
&& (keyCode != (char) KEY_HOME) && (keyCode != (char) KEY_END)
&& (keyCode != (char) KEY_LEFT) && (keyCode != (char) KEY_UP)
&& (keyCode != (char) KEY_RIGHT) && (keyCode != (char) KEY_DOWN)) {
// 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);
}
}
Constructor Summary |
TextBox()
Creates an empty text box. |
Methods inherited from class com.google.gwt.user.client.ui.TextBoxBase |
addChangeListener, cancelKey, getCursorPos, getImpl, getName, getSelectedText, getSelectionLength, getText, isReadOnly, onBrowserEvent, removeChangeListener, selectAll, setCursorPos, setKey, setName, setReadOnly, setSelectionRange, setText, setTextAlignment |
Methods inherited from class com.google.gwt.user.client.ui.FocusWidget |
addClickListener, addFocusListener, addKeyboardListener, getFocusImpl, getTabIndex, isEnabled, removeClickListener, removeFocusListener, removeKeyboardListener, setAccessKey, setElement, setEnabled, setFocus, setTabIndex |
Methods inherited from class com.google.gwt.user.client.ui.UIObject |
addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, setElement, setHeight, setPixelSize, setSize, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkEvents, toString, unsinkEvents |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
TextBox
public TextBox()
- Creates an empty text box.
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