モジュール java.desktop
パッケージ javax.swing

クラスJTextArea

java.lang.Object
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

@JavaBean(defaultProperty="UIClassID", description="A multi-line area that displays plain text.") public class JTextArea extends JTextComponent
JTextAreaは、プレーン・テキストを表示する複数行の領域です。 この処理を適切に行うjava.awt.TextAreaクラスとのソースの互換性を提供する軽量コンポーネントとして用意されています。 テキスト・コンポーネントの詳細および例については、「The Java Tutorial」の「Using Text Components」を参照してください。

このコンポーネントは、java.awt.TextAreaクラスにはない機能を備えています。 追加機能については、スーパー・クラスを参照してください。 より多くの機能を備えた複数行テキスト・クラスとして、ほかにJTextPaneJEditorPaneがあります。

java.awt.TextAreaは内部的にスクロールを処理します。 JTextAreaはスクロールを管理しない点では異なりますが、SwingのScrollableインタフェースを実装します。 これにより、そのインタフェースをスクロール動作が必要な場合にJScrollPaneの内部に配置し、スクロールの動作が不要な場合に直接使えるようにできます。

java.awt.TextAreaは行折返しを行う機能を備えています。 これは、水平スクロール・ポリシーで制御されていました。 スクロールはJTextAreaによって直接実行されないため、下位互換性は別の方法で提供される必要があります。 JTextAreaには、行を折り返すかどうかを制御する行折返しのバウンド・プロパティがあります。 デフォルトでは、行折返しプロパティはfalse (折り返さない)に設定されています。

java.awt.TextAreaには、適切なサイズを指定するために使用されるrowsおよびcolumnsの2つのプロパティがあります。 JTextAreaはこれらのプロパティを使って、java.awt.TextAreaで提供される機能と一致するようにJScrollPaneの内部にビュー・ポートを配置する際の適切なサイズを示します。 JTextAreaには、テキストすべての表示に必要となる最適なサイズが用意されているので、ビュー・ポートはJScrollPaneの内部で適切に機能します。 rowsまたはcolumnsの値が0のとき、その軸に沿った最適なサイズが、同じ軸に沿ったビュー・ポートの適切なサイズに使用されます。

java.awt.TextAreaの変更を監視するには、TextEventTextListenerを追加します。 JTextComponentベースのコンポーネントでは、DocumentEvent経由でモデルからDocumentListenersに変更が送られます。 DocumentEventは、必要に応じて、変更位置と変更の種類を提供します。 この部分のコードは次のようになります。

    DocumentListener myListener = ??;
    JTextArea myArea = ??;
    myArea.getDocument().addDocumentListener(myListener);
 
Newlines
改行の処理方法については、DefaultEditorKitを参照してください。

警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beansパッケージに追加されました。 XMLEncoderを参照してください。

導入されたバージョン:
1.2
関連項目: