モジュール java.desktop
パッケージ 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

        @Deprecated
protected 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 - イベント