クラス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	ドキュメント内で識別されるタグです。

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

changeSupport, enabled

修飾子と型	フィールド	説明
protected SwingPropertyChangeSupport	changeSupport	PropertyChangeListenersが登録されている場合、changeSupportフィールドがそれらを記述します。
protected boolean	enabled	アクションが使用可能かどうかを指定します。デフォルトはtrueです。

インタフェース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

修飾子と型	フィールド	説明
static final String	ACCELERATOR_KEY	アクションのアクセラレータとして使用するKeyStrokeの格納に使用されるキーです。
static final String	ACTION_COMMAND_KEY	JComponentに関連するKeymapに常駐している結果としてActionが通知されるとき作成される、ActionEventのコマンドStringの判定に使用されるキーです。
static final String	DEFAULT	現在使用されていません。
static final String	DISPLAYED_MNEMONIC_INDEX_KEY	ニーモニックの装飾が描画されるテキスト内のインデックス(NAMEプロパティで識別される)に対応するIntegerの格納に使用されるキーです。
static final String	LARGE_ICON_KEY	Iconを格納するために使用されるキーです。
static final String	LONG_DESCRIPTION	アクションに関する詳細なStringの説明を格納するために使用されるキーです。コンテキスト依存ヘルプで使用できます。
static final String	MNEMONIC_KEY	KeyEventキー・コードの1つに対応するIntegerの格納に使用されるキーです。
static final String	NAME	アクションの名前を表すStringの格納に使用するキーです。メニューまたはボタンで使われます。
static final String	SELECTED_KEY	選択された状態に対応するBooleanの格納に使用されるキーです。
static final String	SHORT_DESCRIPTION	アクションに関する短いStringの説明を格納するために使用されるキーです。ツールヒントのテキストに使用されます。
static final String	SMALL_ICON	ImageIconのような小さい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のためのカバーです。

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

elementCountToTag, findElementMatchingTag, getElementsAt, getHTMLDocument, getHTMLEditorKit

修飾子と型	メソッド	説明
protected int	elementCountToTag(HTMLDocument doc, int offset, HTML.Tag tag)	いちばん深い葉から数えて、tagを表す要素に到達するまでの要素の数を返します。
protected Element	findElementMatchingTag(HTMLDocument doc, int offset, HTML.Tag tag)	tagに一致するoffsetに位置する、いちばん深い要素を返します。
protected Element[]	getElementsAt(HTMLDocument doc, int offset)	offsetを格納する要素から成る配列を返します。
protected HTMLDocument	getHTMLDocument(JEditorPane e)	指定されたJEditorPaneのHTMLDocumentを返します。
protected HTMLEditorKit	getHTMLEditorKit(JEditorPane e)	指定されたJEditorPaneのHTMLEditorKitを返します。

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

getEditor, getStyledDocument, getStyledEditorKit, setCharacterAttributes, setParagraphAttributes

修飾子と型	メソッド	説明
protected final JEditorPane	getEditor(ActionEvent e)	アクションのターゲット・エディタを取得します。
protected final StyledDocument	getStyledDocument(JEditorPane e)	このエディタ・ペインに関連したドキュメントを取得します。
protected final StyledEditorKit	getStyledEditorKit(JEditorPane e)	このエディタ・ペインに関連したエディタ・キットを取得します。
protected final void	setCharacterAttributes(JEditorPane editor, AttributeSet attr, boolean replace)	指定された属性を文字コンテンツに適用します。
protected final void	setParagraphAttributes(JEditorPane editor, AttributeSet attr, boolean replace)	指定された属性を段落に適用します。

クラスで宣言されたメソッド TextAction

augmentList, getFocusedComponent, getTextComponent

修飾子と型	メソッド	説明
static final Action[]	augmentList(Action[] list1, Action[] list2)	コマンド・リストを一つ取得し、それをもう一つの別のコマンド・リストで拡張します。
protected final JTextComponent	getFocusedComponent()	現在フォーカスを持つテキスト・コンポーネントを取得します。
protected final JTextComponent	getTextComponent(ActionEvent e)	アクションに使用するコンポーネントを判定します。

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

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

修飾子と型	メソッド	説明
void	addPropertyChangeListener(PropertyChangeListener listener)	リスナー・リストにPropertyChangeListenerを追加します。
protected Object	clone()	abstractアクションを複製します。
protected void	firePropertyChange(String propertyName, Object oldValue, Object newValue)	バウンド・プロパティの変更の報告をサポートします。
Object[]	getKeys()	値がこのAbstractActionに設定されたキーであるObjectの配列を返します。キーに値が設定されていない場合はnullを返します。
PropertyChangeListener[]	getPropertyChangeListeners()	addPropertyChangeListener()を使用してこのAbstractActionに追加されているすべてのPropertyChangeListenerの配列を返します。
Object	getValue(String key)	指定されたキーに関連付けられたObjectを返します。
boolean	isEnabled()	アクションが使用可能な場合にtrueを返します。
void	putValue(String key, Object newValue)	指定されたキーに関連付けられたValueを設定します。
void	removePropertyChangeListener(PropertyChangeListener listener)	PropertyChangeListenerをリスナー・リストから削除します。
void	setEnabled(boolean newValue)	Actionを有効にするかどうかを設定します。

クラスオブジェクトで宣言されたメソッド

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

修飾子と型	メソッド	説明
boolean	equals(Object obj)	このオブジェクトと他のオブジェクトが等しいかどうかを示します。
protected void	finalize()	削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。 最終決定は非推奨であり、将来のリリースで削除される可能性があります。
final Class<?>	getClass()	このObjectの実行時クラスを返します。
int	hashCode()	このオブジェクトに対するハッシュ・コード値を返します。
final void	notify()	このオブジェクトのモニターで待機中のスレッドを1つ再開します。
final void	notifyAll()	このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
String	toString()	オブジェクトの文字列表現を返します。
final void	wait()	現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
final void	wait(long timeoutMillis)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
final void	wait(long timeoutMillis, int nanos)	現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

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

accept

修飾子と型	メソッド	説明
default boolean	accept(Object sender)	指定された送信者オブジェクトに対してアクションを実行するかどうかを決定します。

フィールド詳細

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