- すべての実装されたインタフェース:
ImageObserver
,MenuContainer
,Serializable
,Accessible
,Scrollable
@JavaBean(description="A text component that can be marked up with attributes that are graphically represented.") public class JTextPane extends JEditorPane
グラフィックで表現される属性でマークアップできるテキスト・コンポーネントです。 使用方法およびテキスト・ペインの例については、『The Java Tutorial』の「Using Text Components」を参照してください。
このコンポーネントは、文字レベル属性の並びから構成される段落をモデル化します。 各段落には、段落または文字の並びに設定される属性によってオーバーライドされないかぎり使用される、デフォルト属性を収めた論理書式が付属しています。 コンポーネントとイメージは、テキストの中に組み込むことができます。
- Newlines
- 改行の処理方法については、DefaultEditorKitを参照してください。
警告: Swingはスレッドに対して安全ではありません。 詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後のSwingリリースと互換ではなくなる予定です。 現在の直列化のサポートは、短期間の格納や、同じバージョンのSwingを実行するアプリケーション間のRMIに適しています。 1.4では、すべてのJavaBeansの長期ストレージのサポートがjava.beans
パッケージに追加されました。 XMLEncoder
を参照してください。
- 導入されたバージョン:
- 1.2
- 関連項目:
-
ネストされたクラスのサマリー
クラス javax.swing.JEditorPaneで宣言されたネストされたクラス/インタフェース
JEditorPane.AccessibleJEditorPane, JEditorPane.AccessibleJEditorPaneHTML, JEditorPane.JEditorPaneAccessibleHypertextSupport
クラス javax.swing.text.JTextComponentで宣言されたネストされたクラス/インタフェース
JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding
クラス javax.swing.JComponentで宣言されたネストされたクラス/インタフェース
JComponent.AccessibleJComponent
クラス java.awt.Containerで宣言されたネストされたクラス/インタフェース
Container.AccessibleAWTContainer
クラス java.awt.Componentで宣言されたネストされたクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
フィールドのサマリー
クラス javax.swing.JEditorPaneで宣言されたフィールド
HONOR_DISPLAY_PROPERTIES, W3C_LENGTH_UNITS
クラス javax.swing.text.JTextComponentで宣言されたフィールド
DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY
クラス javax.swing.JComponentで宣言されたフィールド
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
クラス java.awt.Componentで宣言されたフィールド
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
インタフェース java.awt.image.ImageObserverで宣言されたフィールド
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
コンストラクタのサマリー
コンストラクタ説明新しいJTextPane
を作成します。JTextPane
(StyledDocument doc) 指定されたドキュメント・モデルを使用して、新しいJTextPane
を作成します。 -
メソッドのサマリー
修飾子と型メソッド説明論理書式階層に新しい書式を追加します。protected EditorKit
デフォルトで使うEditorKit
を作成します。現在のキャレット位置で有効な文字属性がある場合はそれを取得します。ない場合はnull
を返します。ペインの入力属性を返します。現在のキャレット位置で表される段落に割り当てられている論理書式がある場合はそれを取得します。ない場合はnull
を返します。キャレット位置で有効な現在の段落属性がある場合はそれを取得します。ない場合はnull
を返します。それまでに追加されていたnull
でない名前付き書式を取得します。エディタに関連したモデルを取り出します。protected final StyledEditorKit
エディタ・キットを返します。UIのクラスIDを返します。void
現在選択されている内容の置換としてドキュメントにコンポーネントを挿入します。void
insertIcon
(Icon g) 現在選択されているコンテンツの置換後の内容としてドキュメントにアイコンを挿入します。protected String
このJTextPane
の文字列表現を返します。void
removeStyle
(String nm) それまでにドキュメントに追加されていたnull
でない名前付き書式を削除します。void
replaceSelection
(String content) 現在選択されているコンテンツを、渡された文字列が示す新しいコンテンツで置き換えます。void
setCharacterAttributes
(AttributeSet attr, boolean replace) 指定された属性を文字コンテンツに適用します。void
setDocument
(Document doc) エディタをテキスト・ドキュメントに関連付けます。final void
setEditorKit
(EditorKit kit) コンテンツを処理するために現在インストールされているキットを設定します。void
段落に使う論理書式を現在のキャレット位置に設定します。void
setParagraphAttributes
(AttributeSet attr, boolean replace) 指定された属性を段落に適用します。void
エディタをテキスト・ドキュメントに関連付けます。クラス javax.swing.JEditorPaneで宣言されたメソッド
addHyperlinkListener, createEditorKitForContentType, fireHyperlinkUpdate, getAccessibleContext, getContentType, getEditorKit, getEditorKitClassNameForContentType, getEditorKitForContentType, getHyperlinkListeners, getPage, getPreferredSize, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getStream, getText, read, registerEditorKitForContentType, registerEditorKitForContentType, removeHyperlinkListener, scrollToReference, setContentType, setEditorKitForContentType, setPage, setPage, setText
クラス javax.swing.text.JTextComponentで宣言されたメソッド
addCaretListener, addKeymap, copy, cut, fireCaretUpdate, getActions, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getPrintable, getScrollableBlockIncrement, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, modelToView2D, moveCaretPosition, paste, print, print, print, read, removeCaretListener, removeKeymap, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setUI, updateUI, viewToModel, viewToModel2D, write
クラス javax.swing.JComponentで宣言されたメソッド
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
クラス java.awt.Containerで宣言されたメソッド
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
クラス java.awt.Componentで宣言されたメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
コンストラクタの詳細
-
JTextPane
public JTextPane()新しいJTextPane
を作成します。StyledEditorKit
の新しいインスタンスが生成および設定され、ドキュメント・モデルはnull
に設定されます。 -
JTextPane
public JTextPane(StyledDocument doc) 指定されたドキュメント・モデルを使用して、新しいJTextPane
を作成します。javax.swing.text.StyledEditorKit
の新しいインスタンスが生成および設定されます。- パラメータ:
doc
- ドキュメント・モデル
-
-
メソッドの詳細
-
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()UIのクラスIDを返します。- オーバーライド:
getUIClassID
、クラスJEditorPane
- 戻り値:
- 文字列「TextPaneUI」
- 関連項目:
-
setDocument
public void setDocument(Document doc) エディタをテキスト・ドキュメントに関連付けます。 これはStyledDocument
である必要があります。- オーバーライド:
setDocument
、クラスJTextComponent
- パラメータ:
doc
- 表示および編集するドキュメント- 例外:
IllegalArgumentException
-doc
をこのテキスト・コンポーネントに必要な型のモデルであるStyledDocument
にナロー変換できない場合- 関連項目:
-
setStyledDocument
public void setStyledDocument(StyledDocument doc) エディタをテキスト・ドキュメントに関連付けます。 現在登録済のファクトリを使用すると、ドキュメントのビューを構築できます。このドキュメントは、エディタによって表示されます。- パラメータ:
doc
- 表示および編集するドキュメント
-
getStyledDocument
public StyledDocument getStyledDocument()エディタに関連したモデルを取り出します。- 戻り値:
- モデル
-
replaceSelection
public void replaceSelection(String content) 現在選択されているコンテンツを、渡された文字列が示す新しいコンテンツで置き換えます。 選択領域がない場合は、指定されたテキストの挿入と同等です。 置換後のテキストがない場合、現在の選択領域の削除と同等です。 置換後のテキストには、挿入時に入力用に現在定義されている属性が設定されます。 ドキュメントが編集できない状態であれば、ビープ音が鳴って復帰します。- オーバーライド:
replaceSelection
、クラスJEditorPane
- パラメータ:
content
- 選択範囲を置き換えるコンテンツ
-
insertComponent
public void insertComponent(Component c) 現在選択されている内容の置換としてドキュメントにコンポーネントを挿入します。 選択範囲がない場合、コンポーネントは事実上、キャレットの現在の位置に挿入されます。 これは、関連したドキュメントでコンテンツの1文字の属性として表現されます。指定されるコンポーネントは、JTextPaneが使う実際のコンポーネントです。 コンポーネントは複数のコンテナの子になることはできないため、複数のテキスト・コンポーネントでモデルを共用する場合は、このメソッドを使わないでください。
コンポーネントは、
Component.getAlignmentY
によって返された値に従って、テキスト・ベースラインに相対的に配置されます。 Swingコンポーネントの場合、JComponent.setAlignmentY
メソッドを使うと、この値を簡単に設定できます。 たとえば、値を0.75
に設定すると、コンポーネントの75パーセントがベースラインの上に、25パーセントがベースラインの下になります。- パラメータ:
c
- 挿入されるコンポーネント
-
insertIcon
public void insertIcon(Icon g) 現在選択されているコンテンツの置換後の内容としてドキュメントにアイコンを挿入します。 選択範囲がない場合、アイコンは事実上、キャレットの現在の位置に挿入されます。 これは、関連したドキュメントでコンテンツの1文字の属性として表現されます。- パラメータ:
g
- 挿入されるアイコン- 関連項目:
-
addStyle
論理書式階層に新しい書式を追加します。 書式の属性は下から上に向かって解釈処理されるので、子で指定された属性は親で指定された属性をオーバーライドします。- パラメータ:
nm
- 書式の名前(名前付き書式のコレクション内で一意である必要がある)。 この名前は、書式に名前が付いていない場合はnull
も可能だが、呼出し側は名前のない書式を名前で取得できないときに返される参照を管理する必要がある。 名前のない書式は、スタイル・ランで見られるような文字属性のオーバーライドなどで便利な場合がある。parent
- 親書式。 指定されていない属性がほかの書式で解釈処理される必要がない場合はnull
も可。- 戻り値:
- 新しい
Style
-
removeStyle
public void removeStyle(String nm) それまでにドキュメントに追加されていたnull
でない名前付き書式を削除します。- パラメータ:
nm
- 削除される書式の名前
-
getStyle
それまでに追加されていたnull
でない名前付き書式を取得します。- パラメータ:
nm
- 書式の名前- 戻り値:
Style
-
setLogicalStyle
public void setLogicalStyle(Style s) 段落に使う論理書式を現在のキャレット位置に設定します。 属性が文字属性や段落属性として明示的に設定されない場合は、段落に割り当てられた論理書式を介して属性が解釈処理され、次にドキュメント内の要素階層から完全に独立した階層を介して論理書式が解釈処理されます。- パラメータ:
s
- 段落に割り当てる論理書式。書式なしの場合はnull
-
getLogicalStyle
public Style getLogicalStyle()現在のキャレット位置で表される段落に割り当てられている論理書式がある場合はそれを取得します。ない場合はnull
を返します。- 戻り値:
Style
-
getCharacterAttributes
@BeanProperty(bound=false) public AttributeSet getCharacterAttributes()現在のキャレット位置で有効な文字属性がある場合はそれを取得します。ない場合はnull
を返します。- 戻り値:
- 属性または
null
-
setCharacterAttributes
public void setCharacterAttributes(AttributeSet attr, boolean replace) 指定された属性を文字コンテンツに適用します。 選択がある場合、属性はその選択範囲に適用されます。 選択がない場合、属性は、挿入される新しいテキストの属性を定義する入力属性セットに適用されます。- パラメータ:
attr
- 属性replace
- trueの場合、既存の属性が最初に置き換えられる
-
getParagraphAttributes
@BeanProperty(bound=false) public AttributeSet getParagraphAttributes()キャレット位置で有効な現在の段落属性がある場合はそれを取得します。ない場合はnull
を返します。- 戻り値:
- 属性
-
setParagraphAttributes
public void setParagraphAttributes(AttributeSet attr, boolean replace) 指定された属性を段落に適用します。 選択範囲がある場合、属性はその選択範囲と交わる段落に適用されます。 選択範囲がない場合、属性は現在のキャレット位置にある段落に適用されます。- パラメータ:
attr
-null
以外の属性replace
- trueの場合、既存の属性が最初に置き換えられる
-
getInputAttributes
@BeanProperty(bound=false) public MutableAttributeSet getInputAttributes()ペインの入力属性を返します。- 戻り値:
- 属性
-
getStyledEditorKit
protected final StyledEditorKit getStyledEditorKit()エディタ・キットを返します。- 戻り値:
- エディタ・キット
-
createDefaultEditorKit
protected EditorKit createDefaultEditorKit()デフォルトで使うEditorKit
を作成します。 これを実装すると、javax.swing.text.StyledEditorKit
が返されます。- オーバーライド:
createDefaultEditorKit
、クラスJEditorPane
- 戻り値:
- エディタ・キット
-
setEditorKit
public final void setEditorKit(EditorKit kit) コンテンツを処理するために現在インストールされているキットを設定します。 これは、エディタのコンテンツ形式を確定するバウンド・プロパティです。- オーバーライド:
setEditorKit
、クラスJEditorPane
- パラメータ:
kit
- 望ましいエディタ動作- 例外:
IllegalArgumentException
- キットがStyledEditorKit
ではない場合- 関連項目:
-
paramString
protected String paramString()このJTextPane
の文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、null
にはできません。- オーバーライド:
paramString
、クラスJEditorPane
- 戻り値:
- この
JTextPane
の文字列表現
-