|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.Component | +--java.awt.Container | +--javax.swing.JComponent | +--javax.swing.text.JTextComponent | +--javax.swing.JTextArea
TextArea は、プレーンテキストを表示する複数行の領域です。この処理を適切に行う java.awt.TextArea クラスとのソースの互換性を提供する軽量コンポーネントを意図しています。このコンポーネントは、java.awt.TextArea クラスにはない機能を備えています。追加機能については、スーパークラスを参照してください。より多くの機能を備えた複数行テキストクラスとして、ほかに JTextPane と JEditorPane があります。
java.awt.TextArea は内部的にスクロールを処理します。JTextArea はスクロールを管理しない点では異なりますが、Swing の Scrollable インタフェースを実装します。これで、そのインタフェースをスクロール動作が必要な場合に JScrollPane の内部に配置し、スクロールが不要な場合に直接使えるようにできます。
java.awt.TextArea は行折り返しを行う機能を備えています。これは、水平スクロールポリシーで制御されていました。スクロールは JTextArea によって直接実行されるのではないので、下位互換は別の方法で提供されなければなりません。JTextArea は、行を折り返すかどうかを制御する行折り返しのバウンドプロパティを持ちます。
java.awt.TextArea の変更を監視するには、TextEvent の TextListener を追加します。JTextComponent ベースのコンポーネントでは、DocumentEvent 経由でモデルから DocumentListeners に変更が送られます。DocumentEvent は必要に応じて、変更位置と変更の種類を提供します。コードは次のようになります。
DocumentListener myListener = ??;
JTextArea myArea = ??;
myArea.getDocument().addDocumentListener(myListener);
標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JTextArea のキーの割り当てを参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。
JTextPane
,
JEditorPane
, 直列化された形式内部クラスの概要 | |
protected class |
JTextArea.AccessibleJTextArea
オブジェクトのユーザ補助機能を取得するために使用するクラスです。 |
クラス javax.swing.text.JTextComponent から継承した内部クラス |
JTextComponent.AccessibleJTextComponent,
JTextComponent.KeyBinding |
クラス javax.swing.JComponent から継承した内部クラス |
JComponent.AccessibleJComponent |
クラス javax.swing.text.JTextComponent から継承したフィールド |
DEFAULT_KEYMAP,
FOCUS_ACCELERATOR_KEY |
クラス javax.swing.JComponent から継承したフィールド |
accessibleContext,
listenerList,
TOOL_TIP_TEXT_KEY,
ui,
UNDEFINED_CONDITION,
WHEN_ANCESTOR_OF_FOCUSED_COMPONENT,
WHEN_FOCUSED,
WHEN_IN_FOCUSED_WINDOW |
クラス java.awt.Component から継承したフィールド |
BOTTOM_ALIGNMENT,
CENTER_ALIGNMENT,
LEFT_ALIGNMENT,
RIGHT_ALIGNMENT,
TOP_ALIGNMENT |
コンストラクタの概要 | |
JTextArea()
新しい TextArea を構築します。 |
|
JTextArea(Document doc)
指定されたドキュメントモデルと、ほかの引数はすべてデフォルト (null, 0, 0) で、新しい JTextArea を構築します。 |
|
JTextArea(Document doc,
String text,
int rows,
int columns)
指定された行数と列数、および指定されたモデルで新しい JTextArea を構築します。 |
|
JTextArea(int rows,
int columns)
指定された行数と列数で新しい空の TextArea を構築します。 |
|
JTextArea(String text)
指定された表示テキストで新しい TextArea を構築します。 |
|
JTextArea(String text,
int rows,
int columns)
指定されたテキストと行数と列数で新しい TextArea を構築します。 |
メソッドの概要 | |
void |
append(String str)
指定されたテキストをドキュメントの末尾に追加します。 |
protected Document |
createDefaultModel()
モデルが明示的に指定されない場合は、構築時に使うモデルのデフォルト実装を作成します。 |
AccessibleContext |
getAccessibleContext()
この JTextArea に関連付けられている AccessibleContext を取得します。 |
int |
getColumns()
TextArea 内の列数を返します。 |
protected int |
getColumnWidth()
列幅を取得します。 |
int |
getLineCount()
領域内に収める行数を取得します。 |
int |
getLineEndOffset(int line)
指定された行の終了オフセットを取得します。 |
int |
getLineOfOffset(int offset)
コンポーネントテキストのオフセットを行番号に変換します。 |
int |
getLineStartOffset(int line)
指定された行の開始オフセットを取得します。 |
boolean |
getLineWrap()
テキスト領域の行折り返しポリシーを取得します。 |
Dimension |
getPreferredScrollableViewportSize()
このコンポーネントが JScrollPane に組み込まれている場合はビューポートの望ましいサイズを返します。 |
Dimension |
getPreferredSize()
TextArea の望ましいサイズを返します。 |
protected int |
getRowHeight()
行の高さの意味を定義します。 |
int |
getRows()
TextArea 内の行数を返します。 |
boolean |
getScrollableTracksViewportWidth()
ビューポートが常にこの Scrollable の幅を強制的にビューポートの幅に一致させようとする場合に true を返します。 |
int |
getScrollableUnitIncrement(Rectangle visibleRect,
int orientation,
int direction)
論理行または列を表示するコンポーネントは、方向の値に基づいて、新しい行または列を完全に表示するスクロール増分値を計算します。 |
int |
getTabSize()
タブを展開するのに使う文字の数を取得します。 |
String |
getUIClassID()
UI のクラス ID を返します。 |
boolean |
getWrapStyleWord()
テキスト領域が折り返し行の場合に使う折り返し書式を取得します。 |
void |
insert(String str,
int pos)
指定されたテキストを指定の位置に挿入します。 |
boolean |
isManagingFocus()
フォーカスを得たあとにタブトラバーサルをオフに設定します。 |
protected String |
paramString()
この JTextArea の文字列表現を返します。 |
protected void |
processComponentKeyEvent(KeyEvent e)
TAB イベントおよび Shift + TAB イベントを破棄することにより、awt がフォーカスのトラバースを行わないようにします。 |
void |
replaceRange(String str,
int start,
int end)
指定された開始位置から終了位置までのテキストを、新しい指定テキストで置き換えます。 |
void |
setColumns(int columns)
この TextArea の列数を設定します。 |
void |
setFont(Font f)
現在のフォントを設定します。 |
void |
setLineWrap(boolean wrap)
テキスト領域の行折り返しポリシーを設定します。 |
void |
setRows(int rows)
この TextArea の行数を設定します。 |
void |
setTabSize(int size)
タブを展開する文字数を設定します。 |
void |
setWrapStyleWord(boolean word)
テキスト領域が折り返し行の場合に使う折り返し書式を設定します。 |
クラス java.lang.Object から継承したメソッド |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
コンストラクタの詳細 |
public JTextArea()
public JTextArea(String text)
text
- 表示されるテキスト、または nullpublic JTextArea(int rows, int columns)
rows
- 行数 >= 0columns
- 列数 >= 0public JTextArea(String text, int rows, int columns)
text
- 表示されるテキスト、または nullrows
- 行数 >= 0columns
- 列数 >= 0public JTextArea(Document doc)
doc
- 使用するモデルpublic JTextArea(Document doc, String text, int rows, int columns)
doc
- 使用するモデル。ただし null の場合は、デフォルトモデルを作成するtext
- 表示されるテキスト。ない場合は nullrows
- 行数 >= 0columns
- 列数 >= 0メソッドの詳細 |
public String getUIClassID()
JComponent.getUIClassID()
,
UIDefaults.getUI(javax.swing.JComponent)
protected Document createDefaultModel()
public void setTabSize(int size)
size
- 展開する文字数getTabSize()
public int getTabSize()
public void setLineWrap(boolean wrap)
wrap
- 行が折り返されるかどうかを示すgetLineWrap()
public boolean getLineWrap()
public void setWrapStyleWord(boolean word)
word
- 行折り返しにワード境界を使うかどうかを示すgetWrapStyleWord()
public boolean getWrapStyleWord()
public int getLineOfOffset(int offset) throws BadLocationException
offset
- オフセット >= 0public int getLineCount()
public int getLineStartOffset(int line) throws BadLocationException
line
- 変換対象の行番号 >= 0public int getLineEndOffset(int line) throws BadLocationException
line
- 行 >= 0public void insert(String str, int pos)
このメソッドは、ほとんどの Swing メソッドとは違ってスレッドに対して安全です。詳細は、「Threads and Swing」を参照してください。
str
- 挿入するテキストpos
- 挿入位置 >= 0TextComponent.setText(java.lang.String)
,
replaceRange(java.lang.String, int, int)
public void append(String str)
このメソッドは、ほとんどの Swing メソッドとは違ってスレッドに対して安全です。詳細は、「Threads and Swing」を参照してください。
str
- 挿入するテキストinsert(java.lang.String, int)
public void replaceRange(String str, int start, int end)
このメソッドは、ほとんどの Swing メソッドとは違ってスレッドに対して安全です。詳細は、「Threads and Swing」を参照してください。
str
- 置換に使うテキストstart
- 開始位置 >= 0end
- 終了位置 >= startinsert(java.lang.String, int)
,
replaceRange(java.lang.String, int, int)
public boolean isManagingFocus()
protected void processComponentKeyEvent(KeyEvent e)
public int getRows()
public void setRows(int rows)
rows
- 行数 >= 0getRows()
protected int getRowHeight()
public int getColumns()
public void setColumns(int columns)
columns
- 列数 >= 0getColumns()
protected int getColumnWidth()
public Dimension getPreferredSize()
public void setFont(Font f)
f
- 現在のフォントとして使うフォントprotected String paramString()
null
にはなりません。
JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。
public boolean getScrollableTracksViewportWidth()
public Dimension getPreferredScrollableViewportSize()
JComponent.getPreferredSize()
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
getRowHeight
メソッドと getColumnWidth
メソッドが返す値を使うことができます。
JScrollPane のようなスクロール側コンテナは、ユーザが単位スクロールを要求するたびにこのメソッドを使います。
visibleRect
- ビューポート内の可視のビュー領域orientation
- SwingConstants.VERTICAL または SwingConstants.HORIZONTAL のどちらかdirection
- 上または左のスクロールではゼロより小さく、下または右のスクロールではゼロより大きいJScrollBar.setUnitIncrement(int)
,
getRowHeight()
,
getColumnWidth()
public AccessibleContext getAccessibleContext()
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |