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

クラスHTMLEditorKit.InsertHTMLTextAction

java.lang.Object
javax.swing.AbstractAction
javax.swing.text.TextAction
javax.swing.text.StyledEditorKit.StyledTextAction
javax.swing.text.html.HTMLEditorKit.HTMLTextAction
javax.swing.text.html.HTMLEditorKit.InsertHTMLTextAction
すべての実装されたインタフェース:
ActionListener, Serializable, Cloneable, EventListener, Action
含まれているクラス:
HTMLEditorKit
public static class HTMLEditorKit.InsertHTMLTextAction extends HTMLEditorKit.HTMLTextAction
InsertHTMLTextActionは、既存のHTMLドキュメントに任意のHTML文字列を挿入するために使用できます。 HTML.Tagsは、2つ以上指定する必要があります。 1つめのタグparentTagは、要素の追加先となるドキュメント内で親を識別します。 2つめのタグaddTagは、ドキュメントに追加されるHTML文字列内の1つめのタグを識別します。 1つ留意すべき点は、渡されたHTML文字列内に必要なタグがない場合でも、パーサーによって適切なタグがすべて生成されることです。

たとえば、本文中に表を挿入するためのアクションを作成する必要があるとします。 この場合、parentTagはHTML.Tag.BODY、addTagはHTML.Tag.TABLEとなり、文字列は<table><tr><td></td></tr></table>などとなります。

また、代替のparentTagおよびaddTagを提供するオプションもあります。 これらのタグは、オフセットの位置にparentTagがない場合に調べられることになります。

  • フィールド詳細

    • html

      protected String html
      挿入されるHTMLです。

    • parentTag

      protected HTML.Tag parentTag
      ドキュメント内で識別されるタグです。

    • addTag

      protected HTML.Tag addTag
      タグの追加の始点となる、HTML内のタグです。

    • alternateParentTag

      protected HTML.Tag alternateParentTag
      parentTagが見つからない場合に、ドキュメント内で識別される代替タグです。

    • alternateAddTag

      protected HTML.Tag alternateAddTag
      parentTagがなく、alternateParentTagがある場合に、タグの追加の始点となる、HTML内の代替タグです。

  • コンストラクタの詳細

    • InsertHTMLTextAction

      public InsertHTMLTextAction​(String name, String html, HTML.Tag parentTag, HTML.Tag addTag)
      新しいInsertHTMLTextActionを作成します。
      パラメータ:
      name - アクションの名前
      html - HTML文字列
      parentTag - 親タグ
      addTag - ドキュメントに挿入する最初のタグ

    • InsertHTMLTextAction

      public InsertHTMLTextAction​(String name, String html, HTML.Tag parentTag, HTML.Tag addTag, HTML.Tag alternateParentTag, HTML.Tag alternateAddTag)
      新しいInsertHTMLTextActionを作成します。
      パラメータ:
      name - アクションの名前
      html - HTML文字列
      parentTag - 親タグ
      addTag - ドキュメントに挿入する最初のタグ
      alternateParentTag - 別の親タグ
      alternateAddTag - 代替タグ

  • メソッドの詳細

    • insertHTML

      protected void insertHTML​(JEditorPane editor, HTMLDocument doc, int offset, String html, int popDepth, int pushDepth, HTML.Tag addTag)
      HTMLEditorKit.insertHTMLのためのカバーです。 例外は、RuntimeExceptionにラップされた上でスローされます。
      パラメータ:
      editor - JEditorPaneのインスタンス
      doc - 挿入先のドキュメント
      offset - HTMLの挿入位置のオフセット
      html - HTML文字列
      popDepth - 挿入の前に生成されるElementSpec.EndTagTypesタグの数
      pushDepth - 終了タグの生成後、挿入前に生成されるElementSpec.JoinNextDirectionの方向を持つElementSpec.StartTagTypeタグの数
      addTag - ドキュメントに挿入する最初のタグ

    • insertAtBoundary

      protected void insertAtBoundary​(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)
      境界に挿入するときに呼び出されます。 このメソッドは、ポップの数を調べ、次に、実行する必要があるプッシュの数を調べてから、insertHTMLを呼び出します。
      パラメータ:
      editor - JEditorPaneのインスタンス
      doc - HTMLDocumentのインスタンス
      offset - 開始オフセット
      insertElement - Elementのインスタンス
      html - HTML文字列
      parentTag - 親タグ
      addTag - ドキュメントに挿入する最初のタグ
      導入されたバージョン:
      1.3

    • insertAtBoundry

      @Deprecatedprotected void insertAtBoundry​(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)
      非推奨。
      Java 2プラットフォームv1.3以降は、insertAtBoundaryを使用してください。
      境界に挿入するときに呼び出されます。 このメソッドは、ポップの数を調べ、次に、実行する必要があるプッシュの数を調べてから、insertHTMLを呼び出します。
      パラメータ:
      editor - JEditorPaneのインスタンス
      doc - HTMLDocumentのインスタンス
      offset - 開始オフセット
      insertElement - Elementのインスタンス
      html - HTML文字列
      parentTag - 親タグ
      addTag - ドキュメントに挿入する最初のタグ

    • actionPerformed

      public void actionPerformed​(ActionEvent ae)
      HTMLをドキュメントに挿入します。
      パラメータ:
      ae - イベント