Programming Wireless Devices with the Java2 Platform

10.4 TextField

A TextField is an editable text component that may be placed in a Form. The TextField API is exactly the same as that of TextBox. The only difference is the inherited functionality: TextField inherits from Item whereas TextBox inherits from Screen. Thus, as with TextBox, a TextField has a maximum size, input constraints and input mode (see Section 9.2, "TextBox"), a label, and a String value. The contents of a TextField can be either edited in-line in Form, or the Form may just present static text with a user operation to activate a separate editing view that allows the contents to be edited. The TextField contents within a Form are wrapped.

Devices dictate how many lines a TextField consumes. In some devices, the TextField height can grow dynamically based on the content.

An example:

TextField textField =
    new TextField("Photo caption:",
        "", 32, TextField.ANY);
form.append(textField);