JavaTM 2 Platform
Standard Ed. 5.0

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, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SHORT_DESCRIPTION, SMALL_ICON
 
コンストラクタの概要
HTMLEditorKit.InsertHTMLTextAction(String name, String html, HTML.Tag parentTag, HTML.Tag addTag)
           
HTMLEditorKit.InsertHTMLTextAction(String name, String html, HTML.Tag parentTag, HTML.Tag addTag, HTML.Tag alternateParentTag, HTML.Tag alternateAddTag)
           
 
メソッドの概要
 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
 

フィールドの詳細

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 内の代替タグです。

コンストラクタの詳細

HTMLEditorKit.InsertHTMLTextAction

public HTMLEditorKit.InsertHTMLTextAction(String name,
                                          String html,
                                          HTML.Tag parentTag,
                                          HTML.Tag addTag)

HTMLEditorKit.InsertHTMLTextAction

public HTMLEditorKit.InsertHTMLTextAction(String name,
                                          String html,
                                          HTML.Tag parentTag,
                                          HTML.Tag addTag,
                                          HTML.Tag alternateParentTag,
                                          HTML.Tag alternateAddTag)
メソッドの詳細

insertHTML

protected void insertHTML(JEditorPane editor,
                          HTMLDocument doc,
                          int offset,
                          String html,
                          int popDepth,
                          int pushDepth,
                          HTML.Tag addTag)
HTMLEditorKit.insertHTML のためのカバーです。例外は、RuntimeException にラップされた上でスローされます。


insertAtBoundary

protected void insertAtBoundary(JEditorPane editor,
                                HTMLDocument doc,
                                int offset,
                                Element insertElement,
                                String html,
                                HTML.Tag parentTag,
                                HTML.Tag addTag)
境界に挿入するときに呼び出されます。このメソッドは、ポップの数を調べ、次に、実行する必要があるプッシュの数を調べてから、insertHTML を呼び出します。

導入されたバージョン:
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 を呼び出します。


actionPerformed

public void actionPerformed(ActionEvent ae)
HTML をドキュメントに挿入します。

パラメータ:
ae - イベント

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。