javax.swing

Класс JTextPane

java.lang. Объект

java.awt. Компонент

java.awt. Контейнер

javax.swing. JComponent

javax.swing.text. JTextComponent

javax.swing. JEditorPane

javax.swing. JTextPane

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный, С возможностью прокрутки

public class JTextPane
extends JEditorPane

Текстовый компонент, который может быть повышен с атрибутами, которые представляются графически. Можно найти информацию с практическими рекомендациями и примеры использования текстовых областей в Использовании текстовых Компонентов, раздела в Учебном руководстве по Java.

Это абзацы компонентных моделей, которые составляются из выполнений символьных атрибутов уровня. Каждому абзацу можно было присоединить логический стиль к этому, которое содержит атрибуты по умолчанию, чтобы использовать если не переопределенный набором атрибутов в абзаце или выполненном символе. Компоненты и изображения могут быть встроены в поток текста.

Новые строки

Для обсуждения того, как новые строки обрабатываются, см. DefaultEditorKit.

Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.

Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

См. Также:

StyledEditorKit

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от class javax.swing. JEditorPane

JEditorPane.AccessibleJEditorPane, JEditorPane.AccessibleJEditorPaneHTML, JEditorPane.JEditorPaneAccessibleHypertextSupport

Вложенные классы/интерфейсы, наследованные от class javax.swing.text. JTextComponent

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding

Вложенные классы/интерфейсы, наследованные от class javax.swing. JComponent

JComponent. AccessibleJComponent

Вложенные классы/интерфейсы, наследованные от class java.awt. Контейнер

Контейнер. AccessibleAWTContainer

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Полевая Сводка

Поля, наследованные от class javax.swing. JEditorPane

HONOR_DISPLAY_PROPERTIES, W3C_LENGTH_UNITS

Поля, наследованные от class javax.swing.text. JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

Поля, наследованные от class javax.swing. JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, наследованные от class java.awt. Компонент

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.
JTextPane(StyledDocument doc) Создает новое JTextPane, с указанной моделью документа.

Сводка метода

Модификатор и Тип	Метод и Описание
Стиль	addStyle(String nm, Style parent) Добавляет новый стиль в логическую иерархию стиля.
protected EditorKit	createDefaultEditorKit() Создает EditorKit использовать по умолчанию.
AttributeSet	getCharacterAttributes() Выбирает символьные атрибуты в действительности в текущем расположении каре, или null.
MutableAttributeSet	getInputAttributes() Получает входные атрибуты для области.
Стиль	getLogicalStyle() Выбирает логический стиль, присвоенный абзацу, представленному текущей позицией каре, или null.
AttributeSet	getParagraphAttributes() Выбирает текущие атрибуты абзаца в действительности в расположении каре, или null если ни один.
Стиль	getStyle(String nm) Выбирает именованное не -null разработайте ранее добавленный.
StyledDocument	getStyledDocument() Выбирает модель, связанную с редактором.
protected StyledEditorKit	getStyledEditorKit() Получает набор редактора.
Строка	getUIClassID() Возвращает ID class для UI.
void	insertComponent(Component c) Вставляет компонент в документ как замена для в настоящий момент выбранного контента.
void	insertIcon(Icon g) Вставляет значок в документ как замена для в настоящий момент выбранного контента.
protected String	paramString() Возвращает строковое представление этого JTextPane.
void	removeStyle(String nm) Удаляет именованное не -null разработайте ранее добавленный к документу.
void	replaceSelection(String content) Заменяет в настоящий момент выбранный контент новым контентом, представленным данной строкой.
void	setCharacterAttributes(AttributeSet attr, boolean replace) Применяет данные атрибуты к символьному контенту.
void	setDocument(Document doc) Связывает редактора с текстовым документом.
void	setEditorKit(EditorKit kit) Устанавливает в настоящий момент установленный набор для того, чтобы обработать контент.
void	setLogicalStyle(Style s) Устанавливает логический стиль, чтобы использовать для абзаца в текущей позиции каре.
void	setParagraphAttributes(AttributeSet attr, boolean replace) Применяет данные атрибуты к абзацам.
void	setStyledDocument(StyledDocument doc) Связывает редактора с текстовым документом.

Методы, наследованные от class 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

Методы, наследованные от class javax.swing.text. JTextComponent

addCaretListener, addInputMethodListener, 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, moveCaretPosition, paste, print, print, print, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setUI, updateUI, viewToModel, write

Методы, наследованные от class javax.swing. JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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, 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

Методы, наследованные от class java.awt. Контейнер

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

Методы, наследованные от class java.awt. Компонент

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, 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, getPeer, 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, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

JTextPane

public JTextPane()

Создает новое JTextPane. Новый экземпляр StyledEditorKit создается и устанавливается, и набор модели документа к null.

JTextPane

public JTextPane(StyledDocument doc)

Создает новое JTextPane, с указанной моделью документа. Новый экземпляр javax.swing.text.StyledEditorKit создается и устанавливается.

Параметры:

doc - модель документа

Деталь метода

getUIClassID

public String getUIClassID()

Возвращает ID class для UI.

Переопределения:

getUIClassID в class JEditorPane

Возвраты:

строка "TextPaneUI"

См. Также:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setDocument

public void setDocument(Document doc)

Связывает редактора с текстовым документом. Это должно быть a StyledDocument.

Переопределения:

setDocument в class JTextComponent

Параметры:

doc - документ дисплею/редактированию

Броски:

IllegalArgumentException - если doc не может быть сужен к a StyledDocument который является необходимым типом модели для этого текстового компонента

См. Также:

JTextComponent.getDocument()

setStyledDocument

public void setStyledDocument(StyledDocument doc)

Связывает редактора с текстовым документом. В настоящий момент зарегистрированная фабрика используется, чтобы создать представление для документа, который выводится на экран редактором.

Параметры:

doc - документ дисплею/редактированию

getStyledDocument

public StyledDocument getStyledDocument()

Выбирает модель, связанную с редактором.

Возвраты:

модель

replaceSelection

public void replaceSelection(String content)

Заменяет в настоящий момент выбранный контент новым контентом, представленным данной строкой. Если нет никакого выбора, это составляет вставку данного текста. Если нет никакого заменяющего текста, это составляет удаление текущего выбора. Заменяющему тексту определят атрибуты в настоящий момент для ввода в точке вставки. Если документ не доступен для редактирования, звуковой сигнал и возврат.

Переопределения:

replaceSelection в class JEditorPane

Параметры:

content - контент, чтобы заменить выбор

insertComponent

public void insertComponent(Component c)

Вставляет компонент в документ как замена для в настоящий момент выбранного контента. Если нет никакого выбора, компонент эффективно вставляется в текущей позиции каре. Это представляется в ассоциированном документе как атрибут одного символа контента.

Данный компонент является фактическим компонентом, используемым JTextPane. Так как компоненты не могут быть дочерним элементом больше чем одного контейнера, этот метод не должен использоваться в ситуациях, где модель совместно используется текстовыми компонентами.

Компонент помещается относительно текстовой базовой линии согласно значению, возвращенному Component.getAlignmentY. Для компонентов Swing это значение может быть удобно установлено, используя метод JComponent.setAlignmentY. Например, устанавливая значение 0.75 заставит 75 процентов компонента быть выше базовой линии, и 25 процентов компонента, чтобы быть ниже базовой линии.

Параметры:

c - компонент, чтобы вставить

insertIcon

public void insertIcon(Icon g)

Вставляет значок в документ как замена для в настоящий момент выбранного контента. Если нет никакого выбора, значок эффективно вставляется в текущей позиции каре. Это представляется в ассоциированном документе как атрибут одного символа контента.

Параметры:

g - значок, чтобы вставить

См. Также:

Icon

addStyle

public Style addStyle(String nm,
                      Style parent)

Добавляет новый стиль в логическую иерархию стиля. Решение атрибутов стиля от вверх дном так атрибут, определенный в дочернем элементе, переопределит атрибут, определенный в родителе.

Параметры:

nm - имя стиля (должно быть уникальным в пределах набора именованных стилей). Имя может быть null если стиль является неназванным, но вызывающая сторона ответственна за управление ссылкой, возвращенной, поскольку неназванный стиль не может быть выбран по имени. Неназванный стиль может быть полезным для вещей как переопределения символьного атрибута такой как найдено в выполненном стиле.

parent - родительский стиль. Это может быть null если неуказанные атрибуты не должны быть разрешены в некотором другом стиле.

Возвраты:

новое Style

removeStyle

public void removeStyle(String nm)

Удаляет именованное не -null разработайте ранее добавленный к документу.

Параметры:

nm - имя стиля, чтобы удалить

getStyle

public Style getStyle(String nm)

Выбирает именованное не -null разработайте ранее добавленный.

Параметры:

nm - имя стиля

Возвраты:

Style

setLogicalStyle

public void setLogicalStyle(Style s)

Устанавливает логический стиль, чтобы использовать для абзаца в текущей позиции каре. Если атрибуты не будут явно установлены для символа и атрибутов абзаца, то они решат через логический стиль, присвоенный абзацу, который в термине может решить через некоторую иерархию, абсолютно независимую от иерархии элемента в документе.

Параметры:

s - логический стиль, чтобы присвоиться к абзацу, или null ни для какого стиля

getLogicalStyle

public Style getLogicalStyle()

Выбирает логический стиль, присвоенный абзацу, представленному текущей позицией каре, или null.

Возвраты:

Style

getCharacterAttributes

public AttributeSet getCharacterAttributes()

Выбирает символьные атрибуты в действительности в текущем расположении каре, или null.

Возвраты:

атрибуты, или null

setCharacterAttributes

public void setCharacterAttributes(AttributeSet attr,
                                   boolean replace)

Применяет данные атрибуты к символьному контенту. Если есть выбор, атрибуты применяются к диапазону выбора. Если нет никакого выбора, атрибуты применяются к входному набору атрибута, который определяет атрибуты для любого нового текста, который вставляется.

Параметры:

attr - атрибуты

replace - если это правда, затем замените существующие атрибуты сначала

getParagraphAttributes

public AttributeSet getParagraphAttributes()

Выбирает текущие атрибуты абзаца в действительности в расположении каре, или null если ни один.

Возвраты:

атрибуты

setParagraphAttributes

public void setParagraphAttributes(AttributeSet attr,
                                   boolean replace)

Применяет данные атрибуты к абзацам. Если есть выбор, атрибуты применяются к абзацам, которые пересекают выбор. Если нет никакого выбора, атрибуты применяются к абзацу в текущей позиции каре.

Параметры:

attr - не -null атрибуты

replace - если это правда, замените существующие атрибуты сначала

getInputAttributes

public MutableAttributeSet getInputAttributes()

Получает входные атрибуты для области.

Возвраты:

атрибуты

getStyledEditorKit

protected final StyledEditorKit getStyledEditorKit()

Получает набор редактора.

Возвраты:

набор редактора

createDefaultEditorKit

protected EditorKit createDefaultEditorKit()

Создает EditorKit использовать по умолчанию. Это реализуется, чтобы возвратиться javax.swing.text.StyledEditorKit.

Переопределения:

createDefaultEditorKit в class JEditorPane

Возвраты:

набор редактора

setEditorKit

public final void setEditorKit(EditorKit kit)

Устанавливает в настоящий момент установленный набор для того, чтобы обработать контент. Это - связанное свойство, которое устанавливает тип контента редактора.

Переопределения:

setEditorKit в class JEditorPane

Параметры:

kit - требуемое поведение редактора

Броски:

IllegalArgumentException - если набор не является a StyledEditorKit

См. Также:

JEditorPane.getEditorKit()

paramString

protected String paramString()

Возвращает строковое представление этого JTextPane. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null.

Переопределения:

paramString в class JEditorPane

Возвраты:

строковое представление этого JTextPane