モジュール 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がない場合に調べられることになります。

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected HTML.Tag	addTag	タグの追加の始点となる、HTML内のタグです。
protected HTML.Tag	alternateAddTag	parentTagがなく、alternateParentTagがある場合に、タグの追加の始点となる、HTML内の代替タグです。
protected HTML.Tag	alternateParentTag	parentTagが見つからない場合に、ドキュメント内で識別される代替タグです。
protected String	html	挿入されるHTMLです。
protected HTML.Tag	parentTag	ドキュメント内で識別されるタグです。

クラスjavax.swing.AbstractActionで宣言されたフィールド

changeSupport, enabled

インタフェースjavax.swing.Actionで宣言されているフィールド

ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, DISPLAYED_MNEMONIC_INDEX_KEY, LARGE_ICON_KEY, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SELECTED_KEY, SHORT_DESCRIPTION, SMALL_ICON

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
InsertHTMLTextAction(String name, String html, HTML.Tag parentTag, HTML.Tag addTag)	新しいInsertHTMLTextActionを作成します。
InsertHTMLTextAction(String name, String html, HTML.Tag parentTag, HTML.Tag addTag, HTML.Tag alternateParentTag, HTML.Tag alternateAddTag)	新しいInsertHTMLTextActionを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	actionPerformed(ActionEvent ae)	HTMLをドキュメントに挿入します。
protected void	insertAtBoundary(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)	境界に挿入するときに呼び出されます。
protected void	insertAtBoundry(JEditorPane editor, HTMLDocument doc, int offset, Element insertElement, String html, HTML.Tag parentTag, HTML.Tag addTag)	非推奨。 Java 2プラットフォームv1.3以降は、insertAtBoundaryを使用してください。
protected void	insertHTML(JEditorPane editor, HTMLDocument doc, int offset, String html, int popDepth, int pushDepth, HTML.Tag addTag)	HTMLEditorKit.insertHTMLのためのカバーです。

クラスjavax.swing.text.html.HTMLEditorKit.HTMLTextActionで宣言されたメソッド

elementCountToTag, findElementMatchingTag, getElementsAt, getHTMLDocument, getHTMLEditorKit

クラスjavax.swing.text.StyledEditorKit.StyledTextActionで宣言されたメソッド

getEditor, getStyledDocument, getStyledEditorKit, setCharacterAttributes, setParagraphAttributes

クラスjavax.swing.text.TextActionで宣言されたメソッド

augmentList, getFocusedComponent, getTextComponent

クラスjavax.swing.AbstractActionで宣言されたメソッド

addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled

クラスjava.lang.Objectで宣言されたメソッド

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェースjavax.swing.Actionで宣言されたメソッド

accept

フィールド詳細

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