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

インタフェースDocumentListener

すべてのスーパー・インタフェース:
EventListener
既知のすべての実装クラス:
JEditorPane.AccessibleJEditorPane, JEditorPane.AccessibleJEditorPaneHTML, JEditorPane.JEditorPaneAccessibleHypertextSupport, JPasswordField.AccessibleJPasswordField, JTextArea.AccessibleJTextArea, JTextComponent.AccessibleJTextComponent, JTextField.AccessibleJTextField
public interface DocumentListener
extends EventListener
オブザーバがテキスト・ドキュメントへの変更の通知を受け取るように登録するためのインタフェースです。

Documentインタフェース(AbstractDocument)のデフォルト実装は非同期的な変更をサポートしています。 この機能が使用された場合、つまり変更がSwingイベント・スレッド以外のスレッドで行われた場合は、変更スレッドを経由してリスナーに通知されます。 つまり、非同期的な更新がなされるときには、このインタフェースの実装がスレッド・セーフである必要があります。

DocumentEvent通知はJavaBeansのイベント・モデルに基づいています。 リスナーへの通知の順序は保証されず、Documentの変更前にすべてのリスナーに通知する必要があります。 つまり、DocumentListenerの実装はイベントのソース(関連したDocument)を変更しません。

関連項目:
Document, StyledDocument, DocumentEvent

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    void changedUpdate​(DocumentEvent e)
    属性または属性セットが変更されたことを通知します。
    void insertUpdate​(DocumentEvent e)
    ドキュメントへの挿入があったことを通知します。
    void removeUpdate​(DocumentEvent e)
    ドキュメントの一部が削除されたことを通知します。

  • メソッドの詳細

    • insertUpdate

      void insertUpdate​(DocumentEvent e)
      ドキュメントへの挿入があったことを通知します。 新しく挿入された領域は、DocumentEventが指定する範囲により制限されます。
      パラメータ:
      e - ドキュメント・イベント

    • removeUpdate

      void removeUpdate​(DocumentEvent e)
      ドキュメントの一部が削除されたことを通知します。 範囲は、ビューが最後に(つまり固定位置が更新される前に)何を表示したかで指定されます。
      パラメータ:
      e - ドキュメント・イベント

    • changedUpdate

      void changedUpdate​(DocumentEvent e)
      属性または属性セットが変更されたことを通知します。
      パラメータ:
      e - ドキュメント・イベント