Класс JEditorPane

@JavaBean(defaultProperty="UIClassID",
          description="A text component to edit various types of content.")
public class JEditorPane
extends JTextComponent

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

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

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

text/plain

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

text/html

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

text/rtf

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

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

1. Метод setText может быть использован для инициализации компонента из строки. В этом случае будет использован текущий EditorKit, и ожидается, что тип содержимого будет этого типа.
2. Метод read может быть использован для инициализации компонента из Reader. Обратите внимание, что если тип содержимого HTML, относительные ссылки (например, для изображений) не могут быть разрешены, если не используется тег <base> или свойство 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();
                     }
                 }
             }
         }
     }

Для получения информации о настройке рендеринга text/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 бросит ChangedCharSetException, которая будет перехвачена. Затем чтение возобновляется с новым читателем, использующим набор символов, указанный в ChangedCharSetException (который является IOException).

Новые строки

Обсуждение обработки новых строк можно найти в DefaultEditorKit.

Предупреждение: Swing не является потокобезопасным. Более подробную информацию см. в Политика потоков Swing.

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