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

クラスJTextComponent.AccessibleJTextComponent

java.lang.Object
javax.accessibility.AccessibleContext
java.awt.Component.AccessibleAWTComponent
java.awt.Container.AccessibleAWTContainer
javax.swing.JComponent.AccessibleJComponent
javax.swing.text.JTextComponent.AccessibleJTextComponent
すべての実装されたインタフェース:
Serializable, EventListener, AccessibleAction, AccessibleComponent, AccessibleEditableText, AccessibleExtendedComponent, AccessibleExtendedText, AccessibleText, CaretListener, DocumentListener
直系の既知のサブクラス:
JEditorPane.AccessibleJEditorPane, JTextArea.AccessibleJTextArea, JTextField.AccessibleJTextField
含まれているクラス:
JTextComponent
public class JTextComponent.AccessibleJTextComponent extends JComponent.AccessibleJComponent implements AccessibleText, CaretListener, DocumentListener, AccessibleAction, AccessibleEditableText, AccessibleExtendedText
このクラスはJTextComponentクラスのアクセシビリティ・サポートを実装しています。 メニューのユーザー・インタフェース要素に適したJava Accessibility APIを実装しています。

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

  • コンストラクタの詳細

    • AccessibleJTextComponent

      public AccessibleJTextComponent()
      AccessibleJTextComponentを構築します。 キャレット変更を追跡するためにリスナーを追加します。

  • メソッドの詳細

    • caretUpdate

      public void caretUpdate​(CaretEvent e)
      キャレット更新を処理します(AccessibleContext.ACCESSIBLE_CARET_PROPERTYとAccessibleContext.ACCESSIBLE_SELECTION_PROPERTYという適切なプロパティ変更イベントをトリガーする)。 これは、ドット位置を内部的に追跡します。 キャレットが移動すると、その内部位置がイベントの発生後に更新されます。
      定義:
      caretUpdate 、インタフェース: CaretListener
      パラメータ:
      e - CaretEvent

    • insertUpdate

      public void insertUpdate​(DocumentEvent e)
      ドキュメントの挿入を処理します(AccessibleContext.ACCESSIBLE_TEXT_PROPERTYという適切なプロパティ変更イベントをトリガーする)。 イベントを経由して、変更されたオフセットを追跡します。
      定義:
      insertUpdate 、インタフェース: DocumentListener
      パラメータ:
      e - DocumentEvent

    • removeUpdate

      public void removeUpdate​(DocumentEvent e)
      ドキュメントの削除を処理します(AccessibleContext.ACCESSIBLE_TEXT_PROPERTYという適切なプロパティ変更イベントをトリガーする)。 イベントを経由して、変更されたオフセットを追跡します。
      定義:
      removeUpdate 、インタフェース: DocumentListener
      パラメータ:
      e - DocumentEvent

    • changedUpdate

      public void changedUpdate​(DocumentEvent e)
      ドキュメントの削除を処理します(AccessibleContext.ACCESSIBLE_TEXT_PROPERTYという適切なプロパティ変更イベントをトリガーする)。 イベントを経由して、変更されたオフセットを追跡します。
      定義:
      changedUpdate 、インタフェース: DocumentListener
      パラメータ:
      e - DocumentEvent

    • getAccessibleStateSet

      public AccessibleStateSet getAccessibleStateSet()
      JTextComponentの状態セットを取得します。 オブジェクトのAccessibleStateSetは一意なAccessibleStateのセットから構成されます。 オブジェクトのAccessibleStateSet内の変更は、AccessibleContext.ACCESSIBLE_STATE_PROPERTYプロパティに対してPropertyChangeEventを発生させる原因になります。
      オーバーライド:
      getAccessibleStateSet 、クラス:  JComponent.AccessibleJComponent
      戻り値:
      オブジェクトの現在の状態セットを保持するAccessibleStateSetのインスタンス
      関連項目:
      AccessibleStateSet, AccessibleState, JComponent.AccessibleJComponent.addPropertyChangeListener(java.beans.PropertyChangeListener)

    • getAccessibleRole

      public AccessibleRole getAccessibleRole()
      このオブジェクトの役割を取得します。
      オーバーライド:
      getAccessibleRole 、クラス:  JComponent.AccessibleJComponent
      戻り値:
      オブジェクトの役割を記述するAccessibleRoleのインスタンス(AccessibleRole.TEXT)
      関連項目:
      AccessibleRole

    • getAccessibleText

      public AccessibleText getAccessibleText()
      このオブジェクトに関連付けられたAccessibleTextを取得します。 このクラス用のJava Accessibility APIの実装では、このオブジェクトを返します。これはオブジェクト自体ではなく、AccessibleTextインタフェースを実装します。
      オーバーライド:
      getAccessibleText、クラス: AccessibleContext
      戻り値:
      このオブジェクト
      関連項目:
      AccessibleText

    • getIndexAtPoint

      public int getIndexAtPoint​(Point p)
      ローカル座標でポイントを指定し、そのPoint下の文字のゼロから始まるインデックスを返します。 ポイントが無効な場合、このメソッドは -1を返します。
      定義:
      getIndexAtPoint、インタフェース: AccessibleText
      パラメータ:
      p - ローカル座標のPoint
      戻り値:
      ポイントp下の文字のゼロから始まるインデックス

    • getCharacterBounds

      public Rectangle getCharacterBounds​(int i)
      文字列に対する指定されたインデックスで文字のバウンディング・ボックスを決定します。 このバウンディング・ボックスはローカル座標で返されます。 インデックスが無効な場合、nullの矩形が返されます。 JTextComponentがJScrollPaneに含まれている場合、返される画面座標は「スクロールされない座標」で、この場合、結果として得られる矩形は親座標で変換されます。 ここで使用する正しいアルゴリズムは: 
       Accessible a:
 AccessibleText at = a.getAccessibleText();
 AccessibleComponent ac = a.getAccessibleComponent();
 Rectangle r = at.getCharacterBounds();
 Point p = ac.getLocation();
 r.x += p.x;
 r.y += p.y;
      ノート: JTextComponentは、このメソッドに有効なサイズ(上位オブジェクトのコンテナが有効な最上位ウィンドウである親のコンテナに追加された場合のサイズなど)を持ち、意味のある値(null以外)を返す必要があります。
      定義:
      getCharacterBounds、インタフェース: AccessibleText
      パラメータ:
      i - Stringに対するインデックス≥ 0
      戻り値:
      文字のバウンディング・ボックスの画面座標

    • getCharCount

      public int getCharCount()
      文字の数を返します(有効なインデックス)。
      定義:
      getCharCount、インタフェース: AccessibleText
      戻り値:
      文字数≥ 0

    • getCaretPosition

      public int getCaretPosition()
      キャレットのゼロから始まるオフセットを返します。 ノート: キャレットの右側の文字がオフセットと同じインデックス値を持ちます(キャレットは2つの文字の間に置かれる)。
      定義:
      getCaretPosition、インタフェース: AccessibleText
      戻り値:
      キャレットのゼロから始まるオフセット。

    • getCharacterAttribute

      public AttributeSet getCharacterAttribute​(int i)
      インデックスで指定された文字のAttributeSetを返します。
      定義:
      getCharacterAttribute、インタフェース: AccessibleText
      パラメータ:
      i - テキスト内の0から始まるインデックス
      戻り値:
      文字のAttributeSet

    • getSelectionStart

      public int getSelectionStart()
      選択したテキスト内の開始オフセットを返します。 何も選択されていないけれども、キャレットがあるときは、開始オフセットと終了オフセットが同じになります。 テキストが空の場合は0、選択箇所がない場合はキャレット位置を返します。
      定義:
      getSelectionStart、インタフェース: AccessibleText
      戻り値:
      選択箇所の先頭のテキストに対するインデックス≥ 0

    • getSelectionEnd

      public int getSelectionEnd()
      選択したテキスト内の終了オフセットを返します。 何も選択されていないけれども、キャレットがあるときは、開始オフセットと終了オフセットが同じになります。 テキストが空の場合は0、選択箇所がない場合はキャレット位置を返します。
      定義:
      getSelectionEnd、インタフェース: AccessibleText
      戻り値:
      選択箇所の末尾のテキストに対するインデックス≥ 0

    • getSelectedText

      public String getSelectedText()
      選択されているテキストの一部を返します。
      定義:
      getSelectedText、インタフェース: AccessibleText
      戻り値:
      テキスト。選択部分がない場合はnull

    • getAtIndex

      public String getAtIndex​(int part, int index)
      指定されたインデックスでの文字列を返します。 単語と単語の間にある空白は単語とみなされます。
      定義:
      getAtIndex、インタフェース: AccessibleText
      パラメータ:
      part - 取得するCHARACTER、WORD、またはSENTENCE
      index - テキスト内のインデックス
      戻り値:
      文字、単語、または文。

    • getAfterIndex

      public String getAfterIndex​(int part, int index)
      指定されたインデックスのあとの文字列を返します。 単語と単語の間にある空白は単語とみなされます。
      定義:
      getAfterIndex、インタフェース: AccessibleText
      パラメータ:
      part - 取得するCHARACTER、WORD、またはSENTENCE
      index - テキスト内のインデックス
      戻り値:
      文字、単語、または文。

    • getBeforeIndex

      public String getBeforeIndex​(int part, int index)
      指定されたインデックスの前の文字列を返します。 単語と単語の間にある空白は単語とみなされます。
      定義:
      getBeforeIndex、インタフェース: AccessibleText
      パラメータ:
      part - 取得するCHARACTER、WORD、またはSENTENCE
      index - テキスト内のインデックス
      戻り値:
      文字、単語、または文。

    • getAccessibleEditableText

      public AccessibleEditableText getAccessibleEditableText()
      このテキスト・コンポーネントのAccessibleEditableTextインタフェースを返します。
      オーバーライド:
      getAccessibleEditableText 、クラス:  AccessibleContext
      戻り値:
      AccessibleEditableTextインタフェース
      導入されたバージョン:
      1.4
      関連項目:
      AccessibleEditableText

    • setTextContents

      public void setTextContents​(String s)
      テキスト・コンテンツを指定文字列に設定します。
      定義:
      setTextContents 、インタフェース: AccessibleEditableText
      パラメータ:
      s - テキスト・コンテンツを設定する文字列
      導入されたバージョン:
      1.4

    • insertTextAtIndex

      public void insertTextAtIndex​(int index, String s)
      指定された文字列を指定されたインデックスに挿入します。
      定義:
      insertTextAtIndex 、インタフェース: AccessibleEditableText
      パラメータ:
      index - 文字列を挿入するテキストのインデックス
      s - テキストに挿入する文字列
      導入されたバージョン:
      1.4

    • getTextRange

      public String getTextRange​(int startIndex, int endIndex)
      2つのインデックス間のテキスト文字列を返します。
      定義:
      getTextRange 、インタフェース: AccessibleEditableText
      定義:
      getTextRange 、インタフェース: AccessibleExtendedText
      パラメータ:
      startIndex - テキストの開始インデックス
      endIndex - テキストの終了インデックス
      戻り値:
      インデックス間のテキスト文字列
      導入されたバージョン:
      1.4

    • delete

      public void delete​(int startIndex, int endIndex)
      2つのインデックス間のテキストを削除します。
      定義:
      delete 、インタフェース: AccessibleEditableText
      パラメータ:
      startIndex - テキストの開始インデックス
      endIndex - テキストの終了インデックス
      導入されたバージョン:
      1.4

    • cut

      public void cut​(int startIndex, int endIndex)
      2つのインデックス間のテキストを切り取り、システム・クリップボードへ格納します。
      定義:
      cut 、インタフェース: AccessibleEditableText
      パラメータ:
      startIndex - テキストの開始インデックス
      endIndex - テキストの終了インデックス
      導入されたバージョン:
      1.4

    • paste

      public void paste​(int startIndex)
      システム・クリップボードのテキストを指定したインデックスで始まるテキストにペーストします。
      定義:
      paste 、インタフェース: AccessibleEditableText
      パラメータ:
      startIndex - テキストの開始インデックス
      導入されたバージョン:
      1.4

    • replaceText

      public void replaceText​(int startIndex, int endIndex, String s)
      2つのインデックス間のテキストを、指定した文字列に置き換えます。
      定義:
      replaceText 、インタフェース: AccessibleEditableText
      パラメータ:
      startIndex - テキストの開始インデックス
      endIndex - テキストの終了インデックス
      s - 2つのインデックス間のテキストを置き換える文字列
      導入されたバージョン:
      1.4

    • selectText

      public void selectText​(int startIndex, int endIndex)
      2つのインデックス間のテキストを選択します。
      定義:
      selectText 、インタフェース: AccessibleEditableText
      パラメータ:
      startIndex - テキストの開始インデックス
      endIndex - テキストの終了インデックス
      導入されたバージョン:
      1.4

    • setAttributes

      public void setAttributes​(int startIndex, int endIndex, AttributeSet as)
      2つのインデックス間のテキストの属性を設定します。
      定義:
      setAttributes 、インタフェース: AccessibleEditableText
      パラメータ:
      startIndex - テキストの開始インデックス
      endIndex - テキストの終了インデックス
      as - 属性セット
      導入されたバージョン:
      1.4
      関連項目:
      AttributeSet

    • getTextSequenceAt

      public AccessibleTextSequence getTextSequenceAt​(int part, int index)
      指定されたindexにあるAccessibleTextSequenceを返します。
      定義:
      getTextSequenceAt 、インタフェース: AccessibleExtendedText
      パラメータ:
      part - 取得するCHARACTER、WORD、SENTENCE、LINE、またはATTRIBUTE_RUN
      index - テキスト内のインデックス
      戻り値:
      partとindexが有効な場合は、テキストを指定するAccessibleTextSequence。 それ以外の場合はnullを返す
      導入されたバージョン:
      1.6
      関連項目:
      AccessibleText.CHARACTER, AccessibleText.WORD, AccessibleText.SENTENCE, AccessibleExtendedText.LINE, AccessibleExtendedText.ATTRIBUTE_RUN

    • getTextSequenceAfter

      public AccessibleTextSequence getTextSequenceAfter​(int part, int index)
      指定されたindexの後ろのAccessibleTextSequenceを返します。
      定義:
      getTextSequenceAfter 、インタフェース: AccessibleExtendedText
      パラメータ:
      part - 取得するCHARACTER、WORD、SENTENCE、LINE、またはATTRIBUTE_RUN
      index - テキスト内のインデックス
      戻り値:
      partとindexが有効な場合は、テキストを指定するAccessibleTextSequence。 それ以外の場合はnullを返す
      導入されたバージョン:
      1.6
      関連項目:
      AccessibleText.CHARACTER, AccessibleText.WORD, AccessibleText.SENTENCE, AccessibleExtendedText.LINE, AccessibleExtendedText.ATTRIBUTE_RUN

    • getTextSequenceBefore

      public AccessibleTextSequence getTextSequenceBefore​(int part, int index)
      指定されたindexの前のAccessibleTextSequenceを返します。
      定義:
      getTextSequenceBefore 、インタフェース: AccessibleExtendedText
      パラメータ:
      part - 取得するCHARACTER、WORD、SENTENCE、LINE、またはATTRIBUTE_RUN
      index - テキスト内のインデックス
      戻り値:
      partとindexが有効な場合は、テキストを指定するAccessibleTextSequence。 それ以外の場合はnullを返す
      導入されたバージョン:
      1.6
      関連項目:
      AccessibleText.CHARACTER, AccessibleText.WORD, AccessibleText.SENTENCE, AccessibleExtendedText.LINE, AccessibleExtendedText.ATTRIBUTE_RUN

    • getTextBounds

      public Rectangle getTextBounds​(int startIndex, int endIndex)
      2つのインデックス間のテキストを囲むRectangleを返します。
      定義:
      getTextBounds 、インタフェース: AccessibleExtendedText
      パラメータ:
      startIndex - テキストの開始インデックス
      endIndex - テキストの終了インデックス
      戻り値:
      インデックスが有効な場合はテキストの境界の矩形。 それ以外の場合はnullを返す
      導入されたバージョン:
      1.6

    • getAccessibleActionCount

      public int getAccessibleActionCount()
      オブジェクトで利用可能なアクセシビリティ対応のアクションの数を返します。アクションが複数ある場合は、最初のアクションがオブジェクトの「デフォルト・アクション」と見なされます。
      定義:
      getAccessibleActionCount、インタフェース: AccessibleAction
      戻り値:
      このオブジェクト内のActionの数を示す、ゼロから始まる数
      導入されたバージョン:
      1.4

    • getAccessibleActionDescription

      public String getAccessibleActionDescription​(int i)
      指定されたオブジェクトのアクションについての説明を返します。
      定義:
      getAccessibleActionDescription、インタフェース: AccessibleAction
      パラメータ:
      i - アクションのゼロから始まるインデックス
      戻り値:
      アクションを説明する文字列
      導入されたバージョン:
      1.4
      関連項目:
      getAccessibleActionCount()

    • doAccessibleAction

      public boolean doAccessibleAction​(int i)
      オブジェクトに対して指定されたActionを実行します。
      定義:
      doAccessibleAction、インタフェース: AccessibleAction
      パラメータ:
      i - アクションのゼロから始まるインデックス
      戻り値:
      アクションが実行された場合はtrue、そうでない場合はfalse
      導入されたバージョン:
      1.4
      関連項目:
      getAccessibleActionCount()