public class HTMLEditorKit extends StyledEditorKit implements Accessible
HTML EditorKit はいくつかの目標を持って提供されており、これは HTML をモデル化する手法に反映されています。そうした目標が、クラスの設計に実質的な影響を与えています。
HTML のモデル化は、HTMLDocument
クラスで提供されています。HTML のモデル化については、そのドキュメントに記載されています。編集のサポートは、主に text パッケージで提供されます。
HTMLFactory
クラスによって提供されます。ビューのセットを変更するには、HTMLFactory をサブクラス化または置き換えた上で、getViewFactory メソッドを実装し直して別のファクトリを返すようにします。
JEditorPane.setPage
を使ってロードする場合に非同期でロードされるドキュメントを生成します。これは、ドキュメントのプロパティーによって制御されます。createDefaultDocument
メソッドをオーバーライドすれば、プロパティーを変更できます。作業のバッチ処理は、HTMLDocument.HTMLReader
クラスによって行われます。実際の作業は、text パッケージ内の DefaultStyledDocument
および AbstractDocument
クラスによって行われます。
この機能のサポートは、StyleSheet
クラスによって提供されます。HTML の表現は、EditorKit の StyleSheet プロパティーの設定によって、自由に変えることができます。
修飾子と型 | クラスと説明 |
---|---|
static class |
HTMLEditorKit.HTMLFactory
HTML 用のビューを作成するファクトリです。
|
static class |
HTMLEditorKit.HTMLTextAction
HTML を既存のドキュメントに挿入するのに便利ないくつかの簡易メソッドを提供する abstract アクションです。
|
static class |
HTMLEditorKit.InsertHTMLTextAction
InsertHTMLTextAction は、既存の HTML ドキュメントに任意の HTML 文字列を挿入するために使用できます。
|
static class |
HTMLEditorKit.LinkController
関連付けられたコンポーネントを監視し、必要に応じてその上でハイパーリンクイベントを発生させるクラスです。
|
static class |
HTMLEditorKit.Parser
パーサーがサポートするインタフェースです。
|
static class |
HTMLEditorKit.ParserCallback
構文解析の結果が、これらのコールバックメソッドを呼び出します。
|
StyledEditorKit.AlignmentAction, StyledEditorKit.BoldAction, StyledEditorKit.FontFamilyAction, StyledEditorKit.FontSizeAction, StyledEditorKit.ForegroundAction, StyledEditorKit.ItalicAction, StyledEditorKit.StyledTextAction, StyledEditorKit.UnderlineAction
DefaultEditorKit.BeepAction, DefaultEditorKit.CopyAction, DefaultEditorKit.CutAction, DefaultEditorKit.DefaultKeyTypedAction, DefaultEditorKit.InsertBreakAction, DefaultEditorKit.InsertContentAction, DefaultEditorKit.InsertTabAction, DefaultEditorKit.PasteAction
修飾子と型 | フィールドと説明 |
---|---|
static String |
BOLD_ACTION
ボールド処理識別子です。
|
static String |
COLOR_ACTION
色選択処理識別子です。色は引数として渡されます。
|
static String |
DEFAULT_CSS
タグ表示を設定するデフォルトの CSS (Cascading Style Sheet) ファイルです。
|
static String |
FONT_CHANGE_BIGGER
次サイズへのフォント拡大識別子です。
|
static String |
FONT_CHANGE_SMALLER
次サイズへのフォント縮小識別子です。
|
static String |
IMG_ALIGN_BOTTOM
イメージを下端にそろえます。
|
static String |
IMG_ALIGN_MIDDLE
イメージを中央にそろえます。
|
static String |
IMG_ALIGN_TOP
イメージを上端にそろえます。
|
static String |
IMG_BORDER
イメージを境界にそろえます。
|
static String |
ITALIC_ACTION
イタリック処理識別子です。
|
static String |
LOGICAL_STYLE_ACTION
論理スタイル選択処理識別子です。論理スタイルは引数として渡されます。
|
static String |
PARA_INDENT_LEFT
段落の左インデント処理識別子です。
|
static String |
PARA_INDENT_RIGHT
段落の右インデント処理識別子です。
|
backwardAction, beepAction, beginAction, beginLineAction, beginParagraphAction, beginWordAction, copyAction, cutAction, defaultKeyTypedAction, deleteNextCharAction, deleteNextWordAction, deletePrevCharAction, deletePrevWordAction, downAction, endAction, endLineAction, EndOfLineStringProperty, endParagraphAction, endWordAction, forwardAction, insertBreakAction, insertContentAction, insertTabAction, nextWordAction, pageDownAction, pageUpAction, pasteAction, previousWordAction, readOnlyAction, selectAllAction, selectionBackwardAction, selectionBeginAction, selectionBeginLineAction, selectionBeginParagraphAction, selectionBeginWordAction, selectionDownAction, selectionEndAction, selectionEndLineAction, selectionEndParagraphAction, selectionEndWordAction, selectionForwardAction, selectionNextWordAction, selectionPreviousWordAction, selectionUpAction, selectLineAction, selectParagraphAction, selectWordAction, upAction, writableAction
コンストラクタと説明 |
---|
HTMLEditorKit()
HTMLEditorKit を構築し、StyleContext を作成して、スタイルシートをロードします。
|
修飾子と型 | メソッドと説明 |
---|---|
Object |
clone()
編集キットのコピーを作成します。
|
Document |
createDefaultDocument()
この型のエディタに適している未初期化テキストストレージモデルを作成します。
|
protected void |
createInputAttributes(Element element, MutableAttributeSet set)
element の AttributeSet 内のキーと値のペアを set にコピーします。 |
void |
deinstall(JEditorPane c)
キットが JEditorPane から削除されているときに呼び出されます。
|
AccessibleContext |
getAccessibleContext()
このエディタキットに関連付けられた AccessibleContext を返します
|
Action[] |
getActions()
エディタのコマンドリストを取り出します。
|
String |
getContentType()
このキットがサポートするデータの MIME タイプを返します。
|
Cursor |
getDefaultCursor()
デフォルトのカーソルを返します。
|
MutableAttributeSet |
getInputAttributes()
書式付き編集アクションに使用される入力属性を返します。
|
Cursor |
getLinkCursor()
ハイパーリンク上で使用するカーソルを返します。
|
protected HTMLEditorKit.Parser |
getParser()
HTML ストリームの読み込みに使用するパーサーを取得します。
|
StyleSheet |
getStyleSheet()
HTML 要素の描画に使用されているスタイルセットを返します。
|
ViewFactory |
getViewFactory()
このキットが作成した任意のモデルのビューを作成するのに適したファクトリを取得します。
|
void |
insertHTML(HTMLDocument doc, int offset, String html, int popDepth, int pushDepth, HTML.Tag insertTag)
既存のドキュメントに HTML を挿入します。
|
void |
install(JEditorPane c)
キットが JEditorPane にインストールされるときに呼び出されます。
|
boolean |
isAutoFormSubmission()
html フォームの送信が自動的に処理されるか、
FormSubmitEvent がトリガーされるだけかを示します。 |
void |
read(Reader in, Document doc, int pos)
指定されたストリームからコンテンツを挿入します。
|
void |
setAutoFormSubmission(boolean isAuto)
html フォームの送信が自動的に処理されるか、
FormSubmitEvent がトリガーされるだけかを示します。 |
void |
setDefaultCursor(Cursor cursor)
デフォルトのカーソルを設定します。
|
void |
setLinkCursor(Cursor cursor)
リンク上で使用するカーソルを設定します。
|
void |
setStyleSheet(StyleSheet s)
各種の HTML 要素の描画に使用されるスタイルセットを設定します。
|
void |
write(Writer out, Document doc, int pos, int len)
このタイプのコンテンツハンドラに適した形式で、ドキュメントからストリームへコンテンツを書き込みます。
|
getCharacterAttributeRun
createCaret, read, write
public static final String DEFAULT_CSS
public static final String LOGICAL_STYLE_ACTION
public HTMLEditorKit()
public String getContentType()
text/html
タイプをサポートします。getContentType
、クラス: DefaultEditorKit
public ViewFactory getViewFactory()
getViewFactory
、クラス: StyledEditorKit
public Document createDefaultDocument()
createDefaultDocument
、クラス: StyledEditorKit
public void read(Reader in, Document doc, int pos) throws IOException, BadLocationException
doc
が HTMLDocument のインスタンスである場合、HTML 3.2 テキストを読み込みます。空でないドキュメントへの HTML の挿入は、body 要素の内側にする必要があります。本文に挿入しない場合、例外がスローされます。空でないドキュメントへ挿入する場合、body の外側のタグ (head、title) はすべて削除されます。read
、クラス: DefaultEditorKit
in
- 読み込み元のストリームdoc
- 挿入先pos
- コンテンツを配置するドキュメント内の位置IOException
- 入出力エラーが発生した場合BadLocationException
- pos がドキュメント内の無効な位置を表す場合RuntimeException
- pos が無効な場合 (結果的に BadLocationException になる)public void insertHTML(HTMLDocument doc, int offset, String html, int popDepth, int pushDepth, HTML.Tag insertTag) throws BadLocationException, IOException
doc
- 挿入先のドキュメントoffset
- HTML の挿入位置のオフセットpopDepth
- 挿入の前に生成される ElementSpec.EndTagTypes タグの数pushDepth
- 終了タグの生成後、挿入前に生成される ElementSpec.JoinNextDirection の方向を持つ ElementSpec.StartTagType タグの数insertTag
- ドキュメントへの挿入を開始する最初のタグRuntimeException
- pos が無効な場合 (結果的に BadLocationException になる)BadLocationException
IOException
public void write(Writer out, Document doc, int pos, int len) throws IOException, BadLocationException
write
、クラス: DefaultEditorKit
out
- 書き込み先のストリームdoc
- 書き込み元pos
- コンテンツを取得するドキュメント内の位置len
- 書き出す量IOException
- 入出力エラーが発生した場合BadLocationException
- pos がドキュメント内の無効な位置を表す場合public void install(JEditorPane c)
install
、クラス: StyledEditorKit
c
- JEditorPanepublic void deinstall(JEditorPane c)
deinstall
、クラス: StyledEditorKit
c
- JEditorPanepublic void setStyleSheet(StyleSheet s)
public StyleSheet getStyleSheet()
public Action[] getActions()
getActions
、クラス: StyledEditorKit
protected void createInputAttributes(Element element, MutableAttributeSet set)
element
の AttributeSet 内のキーと値のペアを set
にコピーします。このメソッドは、コンポーネント、アイコン、要素名の各属性はコピーしません。サブクラスでは、どの属性をコピーしてどの属性をコピーしないかを変更することもできます。ただし、最初に set
内のすべての属性を必ず削除してください。このメソッドは、キャレットが別の位置に移動するたびに呼び出されます。
createInputAttributes
、クラス: StyledEditorKit
public MutableAttributeSet getInputAttributes()
getInputAttributes
、クラス: StyledEditorKit
public void setDefaultCursor(Cursor cursor)
public Cursor getDefaultCursor()
public void setLinkCursor(Cursor cursor)
public Cursor getLinkCursor()
public boolean isAutoFormSubmission()
FormSubmitEvent
がトリガーされるだけかを示します。setAutoFormSubmission(boolean)
public void setAutoFormSubmission(boolean isAuto)
FormSubmitEvent
がトリガーされるだけかを示します。デフォルトでは、true に設定されます。isAutoFormSubmission()
, FormSubmitEvent
public Object clone()
clone
、クラス: StyledEditorKit
Cloneable
protected HTMLEditorKit.Parser getParser()
public AccessibleContext getAccessibleContext()
getAccessibleContext
、インタフェース: Accessible
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.