javax.swing

Класс JEditorPane

java.lang. Объект

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

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

javax.swing. JComponent

javax.swing.text. JTextComponent

javax.swing. JEditorPane

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

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

Прямые Известные Подклассы:

JTextPane

public class JEditorPane
extends JTextComponent

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

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

По умолчанию следующие типы контента известны:

текст/плоскость

Простой текст, который является значением по умолчанию данный тип, не распознается. Набор, используемый в этом случае, является расширением DefaultEditorKit это производит обернутое представление простого текста.

текст/HTML

Текст HTML. Набор, используемый в этом случае, является классом javax.swing.text.html.HTMLEditorKit который оказывает поддержку HTML 3.2.

text/rtf

Текст RTF. Набор, используемый в этом случае, является классом javax.swing.text.rtf.RTFEditorKit который оказывает ограниченную поддержку Rich Text Format.

Есть несколько способов загрузить контент в этот компонент.

1. setText метод может использоваться, чтобы инициализировать компонент от строки. В этом случае ток EditorKit будет использоваться, и тип контента, как будут ожидать, будет иметь этот тип.
2. read метод может использоваться, чтобы инициализировать компонент от a Reader. Отметьте, что, если тип контента является HTML, относительные ссылки (например, для вещей как изображения) не могут быть разрешены, если <основной> тег не используется или свойство Base на HTMLDocument устанавливается. В этом случае ток EditorKit будет использоваться, и тип контента, как будут ожидать, будет иметь этот тип.
3. setPage метод может использоваться, чтобы инициализировать компонент от URL. В этом случае тип контента будет определен от URL, и зарегистрированного EditorKit поскольку тот тип контента будет установлен.

Некоторые виды контента могут оказать поддержку гиперссылки, генерируя события гиперссылки. HTML EditorKit генерирует события гиперссылки если JEditorPane не доступно для редактирования (JEditorPane.setEditable(false); был вызван). Если бы фреймы HTML встраиваются в документ, типичный ответ должен был бы изменить часть действующего документа. Следующий фрагмент кода является возможной реализацией слушателя гиперссылки, которая обрабатывает события фрейма HTML особенно, и просто выводит на экран любые другие активированные гиперссылки.

 class Hyperactive implements HyperlinkListener {
 
 public void hyperlinkUpdate(HyperlinkEvent e) {
 if (e.getEventType() == HyperlinkEvent.EventType.ACTIVATED) {
 JEditorPane pane = (JEditorPane) e.getSource();
 if (e instanceof HTMLFrameHyperlinkEvent) {
 HTMLFrameHyperlinkEvent  evt = (HTMLFrameHyperlinkEvent)e;
 HTMLDocument doc = (HTMLDocument)pane.getDocument();
 doc.processHTMLFrameHyperlinkEvent(evt);
 } else {
 try {
 pane.setPage(e.getURL());
 } catch (Throwable t) {
 t.printStackTrace();
 }
 }
 }
 }
 }

 

Для получения информации о настройка, как текст/HTML представляется, пожалуйста, см. W3C_LENGTH_UNITS и HONOR_DISPLAY_PROPERTIES

Культурно зависимая информация в некоторых документах обрабатывается через механизм, названный кодировкой символов. Кодировка символов является однозначным отображением элементов набора символов (буквы, идеограммы, цифры, символы, или функции управления) к определенным числовым кодовым обозначениям. Это представляет способ, которым хранится файл. Кодировки символов в качестве примера являются ISO-8859-1, ISO-8859-5, Shift-jis, Euc-jp, и UTF-8. Когда файл передают к агенту пользователя (JEditorPane) это преобразовывается в набор символов документа (ISO 10646 иначе Unicode).

Есть многократные способы заставить отображение наборов символов происходить с JEditorPane.

1. Один путь состоит в том, чтобы определить набор символов как параметр типа MIME. Это будет установлено звонком setContentType метод. Если контент загружается setPage метод тип контента будет установлен согласно спецификации URL. Это файл загружается непосредственно, тип контента, как ожидали бы, будет установлено до загрузки.
2. Иначе набор символов может быть определен, находится в документе непосредственно. Это требует чтения документа до определения набора символов, который требуется. Чтобы обработать это, ожидается что EditorKitРабота.read бросает a ChangedCharSetException который будет пойман. Чтение тогда перезапускается с новым Читателем, который использует набор символов, определенный в ChangedCharSetException (который является IOException).

Новые строки

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

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

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

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

Вложенные Классы

Модификатор и Тип	Класс и Описание
protected class	JEditorPane. AccessibleJEditorPane Этот класс реализует поддержку доступности JEditorPane класс.
protected class	JEditorPane. AccessibleJEditorPaneHTML Этот класс оказывает поддержку для AccessibleHypertext, и используется в экземплярах где EditorKit установленный в этом JEditorPane экземпляр HTMLEditorKit.
protected class	JEditorPane.JEditorPaneAccessibleHypertextSupport Что возвращается AccessibleJEditorPaneHTML.getAccessibleText.

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

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding

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

JComponent. AccessibleJComponent

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

Контейнер. AccessibleAWTContainer

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

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

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

Поля

Модификатор и Тип	Поле и Описание
static String	HONOR_DISPLAY_PROPERTIES Ключ для клиентского свойства, используемого, чтобы указать, используются ли шрифт по умолчанию и цвет переднего плана от компонента, если шрифт или цвет переднего плана не определяются в стилизованном тексте.
static String	W3C_LENGTH_UNITS Ключ для клиентского свойства, используемого, чтобы указать, используются ли w3c совместимые модули длины для рендеринга html.

Поля javax.swing.text унаследованный от класса. JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

Поля javax.swing унаследованный от класса. JComponent

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

Поля java.awt унаследованный от класса. Компонент

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, наследованные от интерфейса java.awt.image. ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Сводка конструктора

Конструкторы

Конструктор и Описание
JEditorPane() Создает новое JEditorPane.
JEditorPane(String url) Создает a JEditorPane основанный на строке, содержащей спецификацию URL.
JEditorPane(String type, String text) Создает a JEditorPane это было инициализировано к данному тексту.
JEditorPane(URL initialPage) Создает a JEditorPane основанный на указанном URL для ввода.

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

Методы

Модификатор и Тип	Метод и Описание
void	addHyperlinkListener(HyperlinkListener listener) Добавляет слушатель гиперссылки для уведомления о любых изменениях, например когда ссылка выбирается и вводится.
protected EditorKit	createDefaultEditorKit() Создает набор редактора по умолчанию (PlainEditorKit) поскольку, когда компонент сначала создается.
static EditorKit	createEditorKitForContentType(String type) Создает обработчик для данного типа от реестра по умолчанию наборов редактора.
void	fireHyperlinkUpdate(HyperlinkEvent e) Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
AccessibleContext	getAccessibleContext() Связали AccessibleContext с этим JEditorPane.
Строка	getContentType() Получает тип контента, с которым этот редактор в настоящий момент устанавливается иметь дело.
EditorKit	getEditorKit() Выбирает в настоящий момент установленный набор для того, чтобы обработать контент.
static String	getEditorKitClassNameForContentType(String type) Возвращается в настоящий момент зарегистрированный EditorKit имя класса для типа type.
EditorKit	getEditorKitForContentType(String type) Выбирает набор редактора, чтобы использовать для данного типа контента.
HyperlinkListener[]	getHyperlinkListeners() Возвращает массив весь HyperLinkListeners добавленный к этому JEditorPane с addHyperlinkListener ().
URL	getPage() Получает текущий выводимый на экран URL.
Размерность	getPreferredSize() Возвращает привилегированный размер для JEditorPane.
boolean	getScrollableTracksViewportHeight() Возвращает true, если область просмотра должна всегда вызывать высоту этого Scrollable соответствовать высоту области просмотра.
boolean	getScrollableTracksViewportWidth() Возвращает true, если область просмотра должна всегда вызывать ширину этого Scrollable соответствовать ширину области просмотра.
protected InputStream	getStream(URL page) Выбирает поток для данного URL, который собирается быть загруженным setPage метод.
Строка	getText() Возвращает текст, содержавшийся в этом TextComponent с точки зрения типа контента этого редактора.
Строка	getUIClassID() Получает ID класса для UI.
protected String	paramString() Возвращает строковое представление этого JEditorPane.
void	read(InputStream in, Object desc) Этот метод инициализирует от потока.
static void	registerEditorKitForContentType(String type, String classname) Устанавливает привязку по умолчанию type к classname.
static void	registerEditorKitForContentType(String type, String classname, ClassLoader loader) Устанавливает привязку по умолчанию type к classname.
void	removeHyperlinkListener(HyperlinkListener listener) Удаляет слушателя гиперссылки.
void	replaceSelection(String content) Заменяет в настоящий момент выбранный контент новым контентом, представленным данной строкой.
void	scrollToReference(String reference) Прокручивает представление к данному ссылочному расположению (то есть, значение, возвращенное UL.getRef метод для выводимого на экран URL).
void	setContentType(String type) Устанавливает тип контента, который обрабатывает этот редактор.
void	setEditorKit(EditorKit kit) Устанавливает в настоящий момент установленный набор для того, чтобы обработать контент.
void	setEditorKitForContentType(String type, EditorKit k) Непосредственно устанавливает набор редактора, чтобы использовать для данного типа.
void	setPage(String url) Устанавливает текущий выводимый на экран URL.
void	setPage(URL page) Устанавливает текущий выводимый на экран URL.
void	setText(String t) Устанавливает текст этого TextComponent к указанному контенту, который, как ожидают, будет в формате типа контента этого редактора.

Методы 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, setDocument, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setUI, updateUI, viewToModel, write

Методы 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, 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

Методы 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

Методы 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, hide, 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

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

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

Полевая Деталь

W3C_LENGTH_UNITS

public static final String W3C_LENGTH_UNITS

Ключ для клиентского свойства, используемого, чтобы указать, используются ли w3c совместимые модули длины для рендеринга html.

По умолчанию это не включается; включать этому установило клиент property с этим именем к Boolean.TRUE.

С тех пор:

1.5

См. Также:

Постоянные Значения полей

HONOR_DISPLAY_PROPERTIES

public static final String HONOR_DISPLAY_PROPERTIES

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

Значение по умолчанию изменяется основанный на стили; включать этому установило клиент property с этим именем к Boolean.TRUE.

С тех пор:

1.5

См. Также:

Постоянные Значения полей

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

JEditorPane

public JEditorPane()

Создает новое JEditorPane. Модель документа устанавливается в null.

JEditorPane

public JEditorPane(URL initialPage)
            throws IOException

Создает a JEditorPane основанный на указанном URL для ввода.

Параметры:

initialPage - URL

Броски:

IOException - если URL null или не может быть получен доступ

JEditorPane

public JEditorPane(String url)
            throws IOException

Создает a JEditorPane основанный на строке, содержащей спецификацию URL.

Параметры:

url - URL

Броски:

IOException - если URL null или не может быть получен доступ

JEditorPane

public JEditorPane(String type,
           String text)

Создает a JEditorPane это было инициализировано к данному тексту. Это - конструктор удобства, который вызывает setContentType и setText методы.

Параметры:

type - тип пантомимы данного текста

text - текст, чтобы инициализировать с; может быть null

Броски:

NullPointerException - если type параметр null

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

addHyperlinkListener

public void addHyperlinkListener(HyperlinkListener listener)

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

Параметры:

listener - слушатель

removeHyperlinkListener

public void removeHyperlinkListener(HyperlinkListener listener)

Удаляет слушателя гиперссылки.

Параметры:

listener - слушатель

getHyperlinkListeners

public HyperlinkListener[] getHyperlinkListeners()

Возвращает массив весь HyperLinkListeners добавленный к этому JEditorPane с addHyperlinkListener ().

Возвраты:

весь из HyperLinkListeners добавленный или пустой массив, если никакие слушатели не были добавлены

С тех пор:

1.4

fireHyperlinkUpdate

public void fireHyperlinkUpdate(HyperlinkEvent e)

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

Параметры:

e - событие

См. Также:

EventListenerList

setPage

public void setPage(URL page)
             throws IOException

Устанавливает текущий выводимый на экран URL. Тип контента области устанавливается, и если набор редактора для области не -null, тогда новый документ по умолчанию создается, и URL читается в него. Если URL будет содержать и ссылочное расположение, то расположение будет прокручено до, вызывая scrollToReference метод. Если требуемый URL будет тем, в настоящий момент выводимым на экран, то документ не будет перезагружен. Чтобы вызвать перезагрузку документа, необходимо очистить потоковое свойство описания документа. Следующий код показывает, как это может быть сделано:

   Document doc = jEditorPane.getDocument();
   doc.putProperty(Document.StreamDescriptionProperty, null);
 

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

Это может загрузиться или синхронно или асинхронно в зависимости от документа, возвращенного EditorKit. Если Document имеет тип AbstractDocument и возвратили значение AbstractDocument.getAsynchronousLoadPriority это больше чем или равно нулю, страница будет загружена на отдельном потоке, используя тот приоритет.

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

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

Параметры:

page - URL страницы

Броски:

IOException - для a null или недопустимая спецификация страницы, или исключение из считанного потока

См. Также:

getPage()

читать

public void read(InputStream in,
        Object desc)
          throws IOException

Этот метод инициализирует от потока. Если набор устанавливается иметь тип HTMLEditorKit, и desc параметр HTMLDocument, тогда это вызывает HTMLEditorKit инициировать чтение. Иначе это вызывает метод суперкласса, который загружает модель как простой текст.

Параметры:

in - поток, из которого можно читать

desc - объект, описывающий поток

Броски:

IOException - как брошено потоком, используемым, чтобы инициализировать

См. Также:

JTextComponent.read(java.io.Reader, java.lang.Object), JTextComponent.setDocument(javax.swing.text.Document)

getStream

protected InputStream getStream(URL page)
                         throws IOException

Выбирает поток для данного URL, который собирается быть загруженным setPage метод. По умолчанию это просто открывает URL и возвращает поток. Это может быть повторно реализовано, чтобы сделать, полезные вещи любят выборку поток от кэша, контролируют продвижение потока и т.д.

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

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

Параметры:

page - URL страницы

Броски:

IOException

scrollToReference

public void scrollToReference(String reference)

Прокручивает представление к данному ссылочному расположению (то есть, значение, возвращенное UL.getRef метод для выводимого на экран URL). По умолчанию этот метод только знает, как определить местоположение ссылки в HTMLDocument. Реализация вызывает scrollRectToVisible метод, чтобы выполнить фактическую прокрутку. Если прокрутка к ссылочному расположению необходима для типов документов кроме HTML, этот метод должен быть повторно реализован. Этот метод не будет иметь никакого эффекта, если компонент не будет видим.

Параметры:

reference - именованное расположение, чтобы прокрутить к

getPage

public URL getPage()

Получает текущий выводимый на экран URL. Если URL не был определен в создании документа, это возвратится null, и относительный URL не будет разрешен.

Возвраты:

URL, или null если ни один

setPage

public void setPage(String url)
             throws IOException

Устанавливает текущий выводимый на экран URL.

Параметры:

url - URL для дисплея

Броски:

IOException - для a null или недопустимая спецификация URL

getUIClassID

public String getUIClassID()

Получает ID класса для UI.

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

getUIClassID в классе JComponent

Возвраты:

строка "EditorPaneUI"

См. Также:

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

createDefaultEditorKit

protected EditorKit createDefaultEditorKit()

Создает набор редактора по умолчанию (PlainEditorKit) поскольку, когда компонент сначала создается.

Возвраты:

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

getEditorKit

public EditorKit getEditorKit()

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

Возвраты:

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

getContentType

public final String getContentType()

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

Возвраты:

тип контента, null если никакой набор редактора не устанавливается

setContentType

public final void setContentType(String type)

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

Если будет определение набора символов, определенное как параметр спецификации типа контента, то оно будет использоваться когда входные потоки загрузки, используя связанное EditorKit. Например, если тип определяется как text/html; charset=EUC-JP контент будет загружен, используя EditorKit зарегистрированный для text/html и Читатель обеспечил для EditorKit загрузить unicode в документ будет использовать EUC-JP набор символов для того, чтобы преобразовать в unicode. Если тип не будет распознан, то контент будет загружен, используя EditorKit зарегистрированный для простого текста, text/plain.

Параметры:

type - не -null имитируйте тип для поддержки редактирования контента

Броски:

NullPointerException - если type параметр null

См. Также:

getContentType()

setEditorKit

public void setEditorKit(EditorKit kit)

Устанавливает в настоящий момент установленный набор для того, чтобы обработать контент. Это - связанное свойство, которое устанавливает тип контента редактора. Любой старый набор сначала деинсталлируется, затем если набор не -null, новый набор устанавливается, и документ по умолчанию, создаваемый для этого. A PropertyChange событие ("editorKit") всегда запускается когда setEditorKit вызывается.

ОТМЕТЬТЕ: у Этого есть побочный эффект изменения модели, потому что EditorKit источник того, как моделируется определенный тип контента. Этот метод вызовет setDocument быть вызванным от имени вызывающей стороны, чтобы гарантировать целостность внутреннего состояния.

Параметры:

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

См. Также:

getEditorKit()

getEditorKitForContentType

public EditorKit getEditorKitForContentType(String type)

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

Этот метод может быть повторно реализован, чтобы использовать некоторый другой вид реестра типа. Это может быть повторно реализовано, чтобы использовать Платформу Активации Java, например.

Параметры:

type - не -null тип контента

Возвраты:

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

setEditorKitForContentType

public void setEditorKitForContentType(String type,
                              EditorKit k)

Непосредственно устанавливает набор редактора, чтобы использовать для данного типа. Реализация стили могла бы использовать это в соединении с createEditorKitForContentType устанавливать обработчики для типов контента со смещением стили.

Параметры:

type - не -null тип контента

k - набор редактора, который будет установлен

replaceSelection

public void replaceSelection(String content)

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

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

replaceSelection в классе JTextComponent

Параметры:

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

createEditorKitForContentType

public static EditorKit createEditorKitForContentType(String type)

Создает обработчик для данного типа от реестра по умолчанию наборов редактора. Реестр создается в случае необходимости. Если зарегистрированный класс еще не был загружен, попытка предпринимается, чтобы динамически загрузить прототип набора для данного типа. Если тип был зарегистрирован в a ClassLoader, это ClassLoader будет использоваться, чтобы загрузить прототип. Если было не зарегистрировано ClassLoader, Class.forName будет использоваться, чтобы загрузить прототип.

Однажды прототип EditorKit экземпляр успешно располагается, он клонируется, и клон возвращается.

Параметры:

type - тип контента

Возвраты:

набор редактора, или null если нет ничего зарегистрированного для данного типа

registerEditorKitForContentType

public static void registerEditorKitForContentType(String type,
                                   String classname)

Устанавливает привязку по умолчанию type к classname. Класс будет динамически загружен позже когда фактически необходимый, и может быть безопасно изменен перед предпринятым использованием, чтобы избежать загружать нежелательные классы. Прототип EditorKit будет загружен Class.forName когда регистрирующийся в этом методе.

Параметры:

type - не -null тип контента

classname - класс, чтобы загрузиться позже

registerEditorKitForContentType

public static void registerEditorKitForContentType(String type,
                                   String classname,
                                   ClassLoader loader)

Устанавливает привязку по умолчанию type к classname. Класс будет динамически загружен, позже когда фактически необходимый используя данный ClassLoader, и может быть безопасно изменен перед предпринятым использованием, чтобы избежать загружать нежелательные классы.

Параметры:

type - не -null тип контента

classname - класс, чтобы загрузиться позже

loader - ClassLoader использовать, чтобы загрузить имя

getEditorKitClassNameForContentType

public static String getEditorKitClassNameForContentType(String type)

Возвращается в настоящий момент зарегистрированный EditorKit имя класса для типа type.

Параметры:

type - не -null тип контента

С тех пор:

1.3

getPreferredSize

public Dimension getPreferredSize()

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

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

getPreferredSize в классе JComponent

Возвраты:

a Dimension содержа привилегированный размер

См. Также:

JComponent.setPreferredSize(java.awt.Dimension), ComponentUI

setText

public void setText(String t)

Устанавливает текст этого TextComponent к указанному контенту, который, как ожидают, будет в формате типа контента этого редактора. Например, если тип устанавливается в text/html строка должна быть определена с точки зрения HTML.

Это реализуется, чтобы удалить содержание действующего документа, и заменить их, анализируя данную строку, используя ток EditorKit. Это дает семантику суперкласса, не изменяя модель, поддерживая тип контента, в настоящий момент установленный на этом компоненте. Предположение - то, что предыдущий контент является относительно маленьким, и что у предыдущего контента нет побочных эффектов. Оба из тех предположений могут быть нарушены и результаты нежелательного причины. Чтобы избежать этого, создайте новый документ, getEditorKit().createDefaultDocument(), и замените существующее Document с новым. Вас тогда уверяют предыдущее Document не будет иметь никакого вялого состояния.

1. Отъезд существующей модели на месте означает, что старое представление будет разъединено, и новое создаваемое представление, где замена документа избежала бы слезы вниз старого представления.
2. Некоторые форматы (такие как HTML) могут установить вещи в документ, который может влиять на будущее содержание. У HTML может быть информация о стиле, встроенная, который влиял бы на следующий контент, установленный неожиданно.

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

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

setText в классе JTextComponent

Параметры:

t - новый текст, который будет установлен; если null старый текст будет удален

См. Также:

getText()

getText

public String getText()

Возвращает текст, содержавшийся в этом TextComponent с точки зрения типа контента этого редактора. Если исключение выдается, пытаясь получить текст, null будет возвращен. Это реализуется, чтобы вызвать JTextComponent.write с a StringWriter.

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

getText в классе JTextComponent

Возвраты:

текст

См. Также:

setText(java.lang.String)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()

Возвращает true, если область просмотра должна всегда вызывать ширину этого Scrollable соответствовать ширину области просмотра.

Определенный:

getScrollableTracksViewportWidth в интерфейсе Scrollable

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

getScrollableTracksViewportWidth в классе JTextComponent

Возвраты:

истина, если область просмотра должна вынудить ширину Scrollables соответствовать свое собственное, ложное иначе

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()

Возвращает true, если область просмотра должна всегда вызывать высоту этого Scrollable соответствовать высоту области просмотра.

Определенный:

getScrollableTracksViewportHeight в интерфейсе Scrollable

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

getScrollableTracksViewportHeight в классе JTextComponent

Возвраты:

истина, если область просмотра должна вызвать Scrollable's высота, чтобы соответствовать его собственное, ложное иначе

paramString

protected String paramString()

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

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

paramString в классе JTextComponent

Возвраты:

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

Связали AccessibleContext с этим JEditorPane. Для областей редактора AccessibleContext принимает форму AccessibleJEditorPane. Новый экземпляр AccessibleJEditorPane создается в случае необходимости.

Определенный:

getAccessibleContext в интерфейсе Accessible

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

getAccessibleContext в классе JTextComponent

Возвраты:

AccessibleJEditorPane, который служит AccessibleContext этого JEditorPane