Spec-Zone.ru › OpenJDK 27

Класс JEditorPane

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.text.JTextComponent
javax.swing.JEditorPane
Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, Scrollable
Прямые известные подклассы:
JTextPane
@JavaBean(defaultProperty="UIClassID", description="A text component to edit various types of content.") public class JEditorPane extends JTextComponent
Текстовый компонент для редактирования различного содержимого. Информацию по использованию и примеры работы с панелями редактора можно найти в разделе Using Text Components руководства The Java Tutorial.

Этот компонент использует реализации 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 Format.

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

  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, которое будет перехвачено. Затем чтение перезапускается с новым объектом Reader, использующим набор символов, указанный в ChangedCharSetException (который является IOException).
Символы новой строки
Подробнее об обработке символов новой строки см. в DefaultEditorKit.

Предупреждение: Swing не потокобезопасен. Для получения дополнительной информации см. Swing's Threading Policy.

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

С:
1.2

Краткое описание вложенных классов

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

Вложенные классы/интерфейсы, объявленные в классе JTextComponent

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding
Модификатор и тип Класс Описание
class  JTextComponent.AccessibleJTextComponent
Этот класс реализует поддержку специальных возможностей для класса JTextComponent.
static final class  JTextComponent.DropLocation
Представляет место сброса (drop location) для JTextComponent.
static class  JTextComponent.KeyBinding
Запись привязки для создания комбинаций клавиш.

Вложенные классы/интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent
Модификатор и тип Класс Описание
class  JComponent.AccessibleJComponent
Внутренний класс JComponent, используемый для обеспечения поддержки специальных возможностей по умолчанию.

Вложенные классы/интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer
Модификатор и тип Класс Описание
protected class  Container.AccessibleAWTContainer
Внутренний класс Container, используемый для обеспечения поддержки специальных возможностей по умолчанию.

Вложенные классы/интерфейсы, объявленные в классе Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Модификатор и тип Класс Описание
protected class  Component.AccessibleAWTComponent
Внутренний класс Component, используемый для обеспечения поддержки специальных возможностей по умолчанию.
static enum  Component.BaselineResizeBehavior
Перечисление стандартных способов изменения базовой линии компонента при изменении его размера.
protected class  Component.BltBufferStrategy
Внутренний класс для блиттинга внеэкранных поверхностей на компонент.
protected class  Component.FlipBufferStrategy
Внутренний класс для переключения (flipping) буферов компонента.

Краткое описание полей

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

Поля, объявленные в классе JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY
Модификатор и тип Поле Описание
static final String DEFAULT_KEYMAP
Раскладка клавиатуры по умолчанию, которая будет совместно использоваться всеми экземплярами JTextComponent, если для них не была задана другая раскладка.
static final String FOCUS_ACCELERATOR_KEY
Имя связанного свойства для ускорителя фокуса.

Поля, объявленные в классе JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Модификатор и тип Поле Описание
protected EventListenerList listenerList
Список слушателей событий для этого компонента.
static final String TOOL_TIP_TEXT_KEY
Комментарий, отображаемый при наведении курсора на компонент, также известный как «всплывающая подсказка».
protected ComponentUI ui
Делегат внешнего вида и поведения (look and feel) для этого компонента.
static final int UNDEFINED_CONDITION
Константа, используемая некоторыми API для обозначения того, что условие не определено.
static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда принимающий компонент является предком компонента, находящегося в фокусе, или сам находится в фокусе.
static final int WHEN_FOCUSED
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда компонент находится в фокусе.
static final int WHEN_IN_FOCUSED_WINDOW
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда принимающий компонент находится в окне, имеющем фокус, или сам находится в фокусе.

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Модификатор и тип Поле Описание
protected AccessibleContext accessibleContext
AccessibleContext, связанный с этим Component.
static final float BOTTOM_ALIGNMENT
Удобная константа для getAlignmentY.
static final float CENTER_ALIGNMENT
Удобная константа для getAlignmentY и getAlignmentX.
static final float LEFT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float RIGHT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float TOP_ALIGNMENT
Удобная константа для getAlignmentY().

Поля, объявленные в интерфейсе ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Модификатор и тип Поле Описание
static final int ABORT
Этот флаг в аргументе infoflags метода imageUpdate указывает на то, что формирование асинхронно отслеживаемого изображения было прервано до его завершения.
static final int ALLBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает на то, что статическое изображение, которое ранее отрисовывалось, теперь полностью сформировано и может быть отрисовано снова в окончательном виде.
static final int ERROR
Этот флаг в аргументе infoflags метода imageUpdate указывает на то, что при асинхронном отслеживании изображения произошла ошибка.
static final int FRAMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает на то, что еще один полный кадр многокадрового изображения, который ранее отрисовывался, теперь доступен для повторной отрисовки.
static final int HEIGHT
Этот флаг в аргументе infoflags метода imageUpdate указывает на то, что высота базового изображения стала доступна и ее можно получить из аргумента height метода обратного вызова imageUpdate.
static final int PROPERTIES
Этот флаг в аргументе infoflags метода imageUpdate указывает на то, что свойства изображения стали доступны.
static final int SOMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает на то, что стали доступны дополнительные пиксели, необходимые для отрисовки масштабированного варианта изображения.
static final int WIDTH
Этот флаг в аргументе infoflags метода imageUpdate указывает на то, что ширина базового изображения стала доступна и ее можно получить из аргумента width метода обратного вызова imageUpdate.

Краткое описание конструкторов

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

Краткое описание методов

Модификатор и тип Метод Описание
void addHyperlinkListener(HyperlinkListener listener)
Добавляет слушатель гиперссылок для уведомления о любых изменениях, например при выборе и переходе по ссылке.
protected EditorKit createDefaultEditorKit()
Создает стандартный комплект редактора (PlainEditorKit) при первоначальном создании компонента.
static EditorKit createEditorKitForContentType(String type)
Создает обработчик для заданного типа из стандартного реестра комплектов редактора.
void fireHyperlinkUpdate(HyperlinkEvent e)
Оповещает всех слушателей, зарегистрировавшихся для получения уведомлений об этом типе событий.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JEditorPane.
final String getContentType()
Возвращает тип содержимого, на обработку которого в данный момент настроен этот редактор.
EditorKit getEditorKit()
Извлекает установленный в данный момент комплект для обработки содержимого.
static String getEditorKitClassNameForContentType(String type)
Возвращает зарегистрированное в данный момент имя класса EditorKit для типа type.
EditorKit getEditorKitForContentType(String type)
Извлекает комплект редактора для использования с данным типом содержимого.
HyperlinkListener[] getHyperlinkListeners()
Возвращает массив всех HyperLinkListener, добавленных в этот JEditorPane с помощью addHyperlinkListener().
URL getPage()
Возвращает текущий отображаемый URL-адрес.
Dimension getPreferredSize()
Возвращает предпочтительный размер для JEditorPane.
boolean getScrollableTracksViewportHeight()
Возвращает true, если область просмотра всегда должна принудительно устанавливать высоту этого Scrollable равной высоте области просмотра.
boolean getScrollableTracksViewportWidth()
Возвращает true, если область просмотра всегда должна принудительно устанавливать ширину этого Scrollable равной ширине области просмотра.
protected InputStream getStream(URL page)
Получает поток для заданного URL-адреса, который должен быть загружен методом setPage.
String getText()
Возвращает текст, содержащийся в этом TextComponent, в соответствии с типом содержимого данного редактора.
String getUIClassID()
Возвращает идентификатор класса для пользовательского интерфейса.
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)
Прокручивает представление к указанному опорному положению (то есть значению, возвращаемому методом URL.getRef для отображаемого URL-адреса).
final 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 в указанное содержимое, которое должно соответствовать типу содержимого данного редактора.

Методы, объявленные в классе 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, setDocument, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setUI, updateUI, viewToModel, viewToModel2D, write
Модификатор и тип Метод Описание
void addCaretListener(CaretListener listener)
Добавляет слушатель каретки для уведомления о любых изменениях положения каретки.
static Keymap addKeymap(String nm, Keymap parent)
Добавляет новую раскладку клавиатуры в иерархию раскладок.
void copy()
Переносит текущий выделенный диапазон в связанной текстовой модели в системный буфер обмена, сохраняя содержимое в текстовой модели.
void cut()
Переносит текущий выделенный диапазон в связанной текстовой модели в системный буфер обмена, удаляя содержимое из модели.
protected void fireCaretUpdate(CaretEvent e)
Оповещает всех слушателей, зарегистрировавшихся для получения уведомлений об этом типе событий.
Action[] getActions()
Извлекает список команд для редактора.
Caret getCaret()
Извлекает каретку, которая обеспечивает текстовую навигацию по представлению.
Color getCaretColor()
Извлекает текущий цвет, используемый для отрисовки каретки.
CaretListener[] getCaretListeners()
Возвращает массив всех слушателей каретки, зарегистрированных в этом текстовом компоненте.
int getCaretPosition()
Возвращает позицию каретки вставки текста для текстового компонента.
Color getDisabledTextColor()
Извлекает текущий цвет, используемый для отрисовки отключенного текста.
Document getDocument()
Извлекает модель, связанную с редактором.
boolean getDragEnabled()
Возвращает значение, указывающее, включена ли автоматическая обработка перетаскивания.
final JTextComponent.DropLocation getDropLocation()
Возвращает позицию, которую этот компонент должен визуально отображать как место сброса во время операции DnD над компонентом, или null, если в данный момент никакая позиция не должна отображаться.
final DropMode getDropMode()
Возвращает режим сброса для этого компонента.
char getFocusAccelerator()
Возвращает горячую клавишу (акселератор), которая приведет к получению фокуса принимающим текстовым компонентом.
Highlighter getHighlighter()
Извлекает объект, отвечающий за подсветку.
InputMethodRequests getInputMethodRequests()
Возвращает обработчик запросов метода ввода, который поддерживает запросы от методов ввода для этого компонента.
Keymap getKeymap()
Извлекает раскладку клавиатуры, активную в данный момент в этом текстовом компоненте.
static Keymap getKeymap(String nm)
Извлекает именованную раскладку клавиатуры, ранее добавленную в документ.
Insets getMargin()
Возвращает отступ между границей текстового компонента и его текстом.
NavigationFilter getNavigationFilter()
Возвращает NavigationFilter.
Dimension getPreferredScrollableViewportSize()
Возвращает предпочтительный размер области просмотра для компонента представления.
Printable getPrintable(MessageFormat headerFormat, MessageFormat footerFormat)
Возвращает Printable для печати содержимого этого JTextComponent.
int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
Компоненты, отображающие логические строки или столбцы, должны вычислять приращение прокрутки, которое полностью отобразит один блок строк или столбцов в зависимости от значения ориентации.
int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Компоненты, отображающие логические строки или столбцы, должны вычислять приращение прокрутки, которое полностью отобразит одну новую строку или столбец в зависимости от значения ориентации.
String getSelectedText()
Возвращает выделенный текст, содержащийся в этом TextComponent.
Color getSelectedTextColor()
Извлекает текущий цвет, используемый для отрисовки выделенного текста.
Color getSelectionColor()
Извлекает текущий цвет, используемый для отрисовки выделения.
int getSelectionEnd()
Возвращает конечную позицию выделенного текста.
int getSelectionStart()
Возвращает начальную позицию выделенного текста.
String getText(int offs, int len)
Извлекает часть текста, представленного компонентом.
String getToolTipText(MouseEvent event)
Возвращает строку, которая будет использоваться в качестве всплывающей подсказки для event.
TextUI getUI()
Извлекает фабрику пользовательского интерфейса для этого текстового редактора.
boolean isEditable()
Возвращает логическое значение, указывающее, доступен ли этот TextComponent для редактирования.
static void loadKeymap(Keymap map, JTextComponent.KeyBinding[] bindings, Action[] actions)
Загружает раскладку клавиатуры с набором привязок.
Rectangle modelToView(int pos)
Устарело.
заменено на JTextComponent.modelToView2D(int)
Rectangle2D modelToView2D(int pos)
Преобразует заданную позицию в модели в точку в системе координат представления.
void moveCaretPosition(int pos)
Перемещает каретку на новую позицию, оставляя метку, определенную последним вызовом setCaretPosition.
void paste()
Переносит содержимое системного буфера обмена в связанную текстовую модель.
boolean print()
Удобный метод печати, который отображает диалоговое окно печати, а затем печатает этот JTextComponent в интерактивном режиме без верхнего и нижнего колонтитулов.
boolean print(MessageFormat headerFormat, MessageFormat footerFormat)
Удобный метод печати, который отображает диалоговое окно печати, а затем печатает этот JTextComponent в интерактивном режиме с указанными верхним и нижним колонтитулами.
boolean print(MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintService service, PrintRequestAttributeSet attributes, boolean interactive)
Печатает содержимое этого JTextComponent.
void read(Reader in, Object desc)
Инициализирует из потока.
void removeCaretListener(CaretListener listener)
Удаляет слушатель каретки.
static Keymap removeKeymap(String nm)
Удаляет именованную раскладку клавиатуры, ранее добавленную в документ.
protected void restoreComposedText()
Восстанавливает составной текст, ранее сохраненный с помощью saveComposedText.
protected boolean saveComposedText(int pos)
Сохраняет составной текст вокруг указанной позиции.
void select(int selectionStart, int selectionEnd)
Выделяет текст между указанными начальной и конечной позициями.
void selectAll()
Выделяет весь текст в TextComponent.
void setCaret(Caret c)
Устанавливает используемую каретку.
void setCaretColor(Color c)
Задает текущий цвет, используемый для отрисовки каретки.
void setCaretPosition(int position)
Задает позицию каретки вставки текста для TextComponent.
void setDisabledTextColor(Color c)
Задает текущий цвет, используемый для отрисовки отключенного текста.
void setDocument(Document doc)
Связывает редактор с текстовым документом.
void setDragEnabled(boolean b)
Включает или выключает автоматическую обработку перетаскивания.
final void setDropMode(DropMode dropMode)
Задает режим сброса для этого компонента.
void setEditable(boolean b)
Устанавливает указанное логическое значение, определяющее, должен ли этот TextComponent быть доступен для редактирования.
void setFocusAccelerator(char aKey)
Задает горячую клавишу (акселератор), которая приведет к получению фокуса принимающим текстовым компонентом.
void setHighlighter(Highlighter h)
Задает используемый объект подсветки.
void setKeymap(Keymap map)
Задает раскладку клавиатуры для привязки событий к действиям.
void setMargin(Insets m)
Задает отступ между границей текстового компонента и его текстом.
void setNavigationFilter(NavigationFilter filter)
Задает NavigationFilter.
void setSelectedTextColor(Color c)
Задает текущий цвет, используемый для отрисовки выделенного текста.
void setSelectionColor(Color c)
Задает текущий цвет, используемый для отрисовки выделения.
void setSelectionEnd(int selectionEnd)
Устанавливает конец выделения в указанную позицию.
void setSelectionStart(int selectionStart)
Устанавливает начало выделения в указанную позицию.
void setUI(TextUI ui)
Задает фабрику пользовательского интерфейса для этого текстового редактора.
void updateUI()
Перезагружает подключаемый пользовательский интерфейс.
int viewToModel(Point pt)
Устарело.
заменено на JTextComponent.viewToModel2D(Point2D)
int viewToModel2D(Point2D pt)
Преобразует заданную точку в системе координат представления в ближайшую соответствующую позицию в модели.
void write(Writer out)
Сохраняет содержимое модели в заданный поток.

Методы, объявленные в классе 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
Модификатор и тип Метод Описание
void addAncestorListener(AncestorListener listener)
Регистрирует listener, чтобы он получал AncestorEvents, когда он или любой из его предков перемещаются либо становятся видимыми или невидимыми.
void addNotify()
Уведомляет этот компонент о том, что у него появился родительский компонент.
void addVetoableChangeListener(VetoableChangeListener listener)
Добавляет VetoableChangeListener в список слушателей.
void computeVisibleRect(Rectangle visibleRect)
Возвращает «прямоугольник видимой области» компонента Component — пересечение видимых прямоугольников этого компонента и всех его предков.
boolean contains(int x, int y)
Предоставляет делегату UI возможность определить точную форму этого компонента для обработки событий мыши.
JToolTip createToolTip()
Возвращает экземпляр JToolTip, который должен использоваться для отображения всплывающей подсказки.
void disable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void enable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка передачи сообщений об изменениях связанных свойств логического типа.
void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка передачи сообщений об изменениях связанных свойств целочисленного типа.
protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue)
Поддерживает передачу сообщений об изменениях ограничиваемых свойств.
ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
Возвращает объект, который будет выполнять действие, зарегистрированное для данного нажатия клавиши.
final ActionMap getActionMap()
Возвращает ActionMap, используемый для определения того, какое Action генерировать для конкретной привязки KeyStroke.
float getAlignmentX()
Переопределяет Container.getAlignmentX для возврата выравнивания по горизонтали.
float getAlignmentY()
Переопределяет Container.getAlignmentY для возврата выравнивания по вертикали.
AncestorListener[] getAncestorListeners()
Возвращает массив всех слушателей предков, зарегистрированных для этого компонента.
boolean getAutoscrolls()
Возвращает свойство autoscrolls.
int getBaseline(int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает элемент перечисления, указывающий, как изменяется базовая линия компонента при изменении его размера.
Border getBorder()
Возвращает границу этого компонента или null, если граница в данный момент не установлена.
Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
final Object getClientProperty(Object key)
Возвращает значение свойства с указанным ключом.
protected Graphics getComponentGraphics(Graphics g)
Возвращает графический объект, используемый для отрисовки этого компонента.
JPopupMenu getComponentPopupMenu()
Возвращает JPopupMenu, назначенный для этого компонента.
int getConditionForKeyStroke(KeyStroke aKeyStroke)
Возвращает условие, определяющее, выполняется ли зарегистрированное действие в ответ на указанное нажатие клавиши.
int getDebugGraphicsOptions()
Возвращает состояние отладки графики.
static Locale getDefaultLocale()
Возвращает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
FontMetrics getFontMetrics(Font font)
Возвращает FontMetrics для указанного Font.
Graphics getGraphics()
Возвращает графический контекст этого компонента, позволяющий рисовать на компоненте.
int getHeight()
Возвращает текущую высоту этого компонента.
boolean getInheritsPopupMenu()
Возвращает true, если JPopupMenu должен наследоваться от родителя.
final InputMap getInputMap()
Возвращает InputMap, который используется, когда компонент имеет фокус.
final InputMap getInputMap(int condition)
Возвращает InputMap, который используется во время condition.
InputVerifier getInputVerifier()
Возвращает проверяющий ввод объект для этого компонента.
Insets getInsets()
Если для этого компонента была задана граница, возвращает отступы границы; в противном случае вызывает super.getInsets.
Insets getInsets(Insets insets)
Возвращает объект Insets, содержащий значения отступов этого компонента.
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных в данный момент в качестве FooListener для этого JComponent.
Point getLocation(Point rv)
Сохраняет координаты начала координат x,y этого компонента в «возвращаемое значение» rv и возвращает rv.
Dimension getMaximumSize()
Если максимальный размер был установлен в не-null значение, просто возвращает его.
Dimension getMinimumSize()
Если минимальный размер был установлен в не-null значение, просто возвращает его.
Component getNextFocusableComponent()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.
Point getPopupLocation(MouseEvent event)
Возвращает предпочтительное положение для отображения всплывающего меню в системе координат этого компонента.
KeyStroke[] getRegisteredKeyStrokes()
Возвращает KeyStrokes, который будет инициировать зарегистрированные действия.
JRootPane getRootPane()
Возвращает предка JRootPane для этого компонента.
Dimension getSize(Dimension rv)
Сохраняет ширину/высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
Point getToolTipLocation(MouseEvent event)
Возвращает положение всплывающей подсказки в системе координат этого компонента.
String getToolTipText()
Возвращает строку всплывающей подсказки, установленную с помощью setToolTipText.
Container getTopLevelAncestor()
Возвращает предка верхнего уровня для этого компонента (содержащий Window) или null, если этот компонент не был добавлен ни в один контейнер.
TransferHandler getTransferHandler()
Возвращает свойство transferHandler.
boolean getVerifyInputWhenFocusTarget()
Возвращает значение, указывающее, будет ли вызываться проверяющий ввод объект текущего владельца фокуса перед тем, как этот компонент запросит фокус.
VetoableChangeListener[] getVetoableChangeListeners()
Возвращает массив всех слушателей отменяемых изменений, зарегистрированных для этого компонента.
Rectangle getVisibleRect()
Возвращает «видимый прямоугольник» компонента Component — пересечение видимого прямоугольника этого компонента, new Rectangle(0, 0, getWidth(), getHeight()), и видимых прямоугольников всех его предков.
int getWidth()
Возвращает текущую ширину этого компонента.
int getX()
Возвращает текущую координату x начала координат компонента.
int getY()
Возвращает текущую координату y начала координат компонента.
void grabFocus()
Запрашивает передачу фокуса ввода этому Component, а также чтобы предок верхнего уровня этого Component стал активным окном.
void hide()
Устарело.
boolean isDoubleBuffered()
Возвращает значение, указывающее, должен ли этот компонент использовать буфер для отрисовки.
static boolean isLightweightComponent(Component c)
Возвращает true, если этот компонент является легковесным, то есть если у него нет аналога в собственной оконной системе платформы.
boolean isManagingFocus()
Устарело.
Начиная с версии 1.4, заменено на Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).
boolean isOpaque()
Возвращает true, если этот компонент полностью непрозрачен.
boolean isOptimizedDrawingEnabled()
Возвращает true, если этот компонент выстраивает свои дочерние элементы мозаикой — то есть гарантирует, что дочерние элементы не будут перекрываться.
final boolean isPaintingForPrint()
Возвращает true, если текущая операция отрисовки этого компонента является частью операции print.
protected boolean isPaintingOrigin()
Возвращает true, если вызов отрисовки дочернего компонента должен привести к тому, что отрисовка начнется с этого Component или одного из его предков.
boolean isPaintingTile()
Возвращает true, если компонент в данный момент выполняет отрисовку тайла.
boolean isRequestFocusEnabled()
Возвращает true, если этот JComponent должен получить фокус; в противном случае возвращает false.
boolean isValidateRoot()
Если этот метод возвращает true, вызовы revalidate потомками этого компонента приведут к валидации всего дерева, начиная с этого корня.
void paint(Graphics g)
Вызывается Swing для отрисовки компонентов.
protected void paintBorder(Graphics g)
Отрисовывает границу компонента.
protected void paintChildren(Graphics g)
Отрисовывает дочерние элементы этого компонента.
protected void paintComponent(Graphics g)
Вызывает метод paint делегата UI, если делегат UI не равен null.
void paintImmediately(int x, int y, int w, int h)
Немедленно отрисовывает указанную область в этом компоненте и всех его потомках, перекрывающих эту область.
void paintImmediately(Rectangle r)
Отрисовывает указанную область прямо сейчас.
void print(Graphics g)
Вызовите этот метод для вывода компонента на печать в указанный Graphics.
void printAll(Graphics g)
Вызовите этот метод для печати компонента.
protected void printBorder(Graphics g)
Выводит на печать границу компонента.
protected void printChildren(Graphics g)
Выводит на печать дочерние элементы этого компонента.
protected void printComponent(Graphics g)
Вызывается во время операции печати.
protected void processComponentKeyEvent(KeyEvent e)
Обрабатывает любые события клавиатуры, распознаваемые самим компонентом.
protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e.
protected void processKeyEvent(KeyEvent e)
Переопределяет processKeyEvent для обработки событий.
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, происходящие с этим компонентом, диспетчеризируя их любым зарегистрированным объектам MouseListener; полное описание этого метода см. в Component.processMouseEvent(MouseEvent).
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события перемещения мыши, такие как MouseEvent.MOUSE_DRAGGED.
final void putClientProperty(Object key, Object value)
Добавляет произвольное «клиентское свойство» к этому компоненту.
void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; для аналогичного поведения используйте комбинацию getActionMap() и getInputMap().
void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; для аналогичного поведения используйте комбинацию getActionMap() и getInputMap().
void removeAncestorListener(AncestorListener listener)
Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents.
void removeNotify()
Уведомляет этот компонент о том, что у него больше нет родительского компонента.
void removeVetoableChangeListener(VetoableChangeListener listener)
Удаляет VetoableChangeListener из списка слушателей.
void repaint(long tm, int x, int y, int width, int height)
Добавляет указанную область в список измененных областей, если компонент отображается.
void repaint(Rectangle r)
Добавляет указанную область в список измененных областей, если компонент отображается.
boolean requestDefaultFocus()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
void requestFocus()
Запрашивает получение фокуса ввода этим Component.
boolean requestFocus(boolean temporary)
Запрашивает получение фокуса ввода этим Component.
boolean requestFocusInWindow()
Запрашивает получение фокуса ввода этим Component.
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает получение фокуса ввода этим Component.
void resetKeyboardActions()
Отменяет регистрацию всех привязок в объектах первого уровня InputMaps и ActionMap.
void reshape(int x, int y, int w, int h)
Устарело.
Начиная с версии JDK 5, заменено на Component.setBounds(int, int, int, int).
void revalidate()
Поддерживает отложенную автоматическую компоновку.
void scrollRectToVisible(Rectangle aRect)
Пересылает сообщение scrollRectToVisible() родителю компонента JComponent.
final void setActionMap(ActionMap am)
Устанавливает ActionMap в значение am.
void setAlignmentX(float alignmentX)
Устанавливает выравнивание по горизонтали.
void setAlignmentY(float alignmentY)
Устанавливает выравнивание по вертикали.
void setAutoscrolls(boolean autoscrolls)
Устанавливает свойство autoscrolls.
void setBackground(Color bg)
Устанавливает цвет фона этого компонента.
void setBorder(Border border)
Устанавливает границу этого компонента.
void setComponentPopupMenu(JPopupMenu popup)
Устанавливает JPopupMenu для этого JComponent.
void setDebugGraphicsOptions(int debugOptions)
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой внутри компонента или одного из его дочерних элементов.
static void setDefaultLocale(Locale l)
Задает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
void setDoubleBuffered(boolean aFlag)
Устанавливает, должен ли этот компонент использовать буфер для отрисовки.
void setEnabled(boolean enabled)
Устанавливает, включен ли этот компонент.
void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Устанавливает клавиши обхода фокуса для заданной операции перемещения фокуса для этого Component.
void setFont(Font font)
Устанавливает шрифт для этого компонента.
void setForeground(Color fg)
Устанавливает цвет переднего плана этого компонента.
void setInheritsPopupMenu(boolean value)
Устанавливает, должен ли метод getComponentPopupMenu делегировать вызов родителю, если этому компоненту не назначен JPopupMenu.
final void setInputMap(int condition, InputMap map)
Устанавливает InputMap для использования при условии condition в значение map.
void setInputVerifier(InputVerifier inputVerifier)
Устанавливает проверяющий ввод объект для этого компонента.
void setMaximumSize(Dimension maximumSize)
Устанавливает максимальный размер этого компонента в постоянное значение.
void setMinimumSize(Dimension minimumSize)
Устанавливает минимальный размер этого компонента в постоянное значение.
void setNextFocusableComponent(Component aComponent)
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy
void setOpaque(boolean isOpaque)
Если значение равно true, компонент отрисовывает каждый пиксель в пределах своих границ.
void setPreferredSize(Dimension preferredSize)
Устанавливает предпочтительный размер этого компонента.
void setRequestFocusEnabled(boolean requestFocusEnabled)
Предоставляет подсказку относительно того, должен ли этот JComponent получить фокус.
void setToolTipText(String text)
Регистрирует текст для отображения во всплывающей подсказке.
void setTransferHandler(TransferHandler newHandler)
Устанавливает TransferHandler, обеспечивающий поддержку передачи данных в этот компонент и из него посредством вырезания/копирования/вставки и перетаскивания.
protected void setUI(ComponentUI newUI)
Устанавливает делегат внешнего вида и функциональности для этого компонента.
void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
Устанавливает значение, указывающее, будет ли вызываться проверяющий ввод объект для текущего владельца фокуса перед тем, как этот компонент запросит фокус.
void setVisible(boolean aFlag)
Делает компонент видимым или невидимым.
void unregisterKeyboardAction(KeyStroke aKeyStroke)
Этот метод устарел.
void update(Graphics g)
Вызывает paint.

Методы, объявленные в классе 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
Модификатор и тип Метод Описание
Component add(Component comp)
Добавляет указанный компонент в конец этого контейнера.
Component add(Component comp, int index)
Добавляет указанный компонент в этот контейнер на заданную позицию.
void add(Component comp, Object constraints)
Добавляет указанный компонент в конец этого контейнера.
void add(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер с заданными ограничениями по указанному индексу.
Component add(String name, Component comp)
Добавляет указанный компонент в этот контейнер.
void addContainerListener(ContainerListener l)
Добавляет указанный слушатель контейнера для получения событий контейнера от этого контейнера.
protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер по указанному индексу.
void addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей.
void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей для определенного свойства.
void applyComponentOrientation(ComponentOrientation o)
Устанавливает свойство ComponentOrientation этого контейнера и всех содержащихся в нем компонентов.
boolean areFocusTraversalKeysSet(int id)
Возвращает значение, указывающее, был ли явно определен для этого Container набор клавиш обхода фокуса для заданной операции обхода фокуса.
int countComponents()
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentCount().
void deliverEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent e)
void doLayout()
Заставляет этот контейнер выполнить компоновку своих компонентов.
Component findComponentAt(int x, int y)
Находит видимый дочерний компонент, содержащий указанную позицию.
Component findComponentAt(Point p)
Находит видимый дочерний компонент, содержащий указанную точку.
Component getComponent(int n)
Возвращает n-й компонент в этом контейнере.
Component getComponentAt(int x, int y)
Находит компонент, содержащий позицию x,y.
Component getComponentAt(Point p)
Возвращает компонент, содержащий указанную точку.
int getComponentCount()
Возвращает количество компонентов в этой панели.
Component[] getComponents()
Возвращает все компоненты в этом контейнере.
int getComponentZOrder(Component comp)
Возвращает z-order индекс компонента внутри контейнера.
ContainerListener[] getContainerListeners()
Возвращает массив всех слушателей контейнера, зарегистрированных для этого контейнера.
Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор (Set) клавиш обхода фокуса для заданной операции обхода для этого Container.
FocusTraversalPolicy getFocusTraversalPolicy()
Возвращает политику обхода фокуса, которая будет управлять обходом с клавиатуры дочерних элементов этого Container, или null, если этот Container не является корнем цикла фокуса.
LayoutManager getLayout()
Возвращает менеджер компоновки для этого контейнера.
Point getMousePosition(boolean allowChildren)
Возвращает положение указателя мыши в системе координат этого Container, если Container находится под указателем мыши, в противном случае возвращает null.
Insets insets()
Устарело.
Начиная с версии JDK 1.1, заменено на getInsets().
void invalidate()
Делает контейнер недействительным (инвалидирует его).
boolean isAncestorOf(Component c)
Проверяет, содержится ли компонент в иерархии компонентов этого контейнера.
boolean isFocusCycleRoot()
Возвращает значение, указывающее, является ли этот Container корнем цикла обхода фокуса.
boolean isFocusCycleRoot(Container container)
Возвращает значение, указывающее, является ли указанный Container корнем цикла фокуса для цикла обхода фокуса этого Container.
final boolean isFocusTraversalPolicyProvider()
Возвращает значение, указывающее, предоставляет ли этот контейнер политику обхода фокуса.
boolean isFocusTraversalPolicySet()
Возвращает значение, указывающее, была ли явно установлена политика обхода фокуса для этого Container.
void layout()
Устарело.
Начиная с версии JDK 1.1, заменено на doLayout().
void list(PrintStream out, int indent)
Выводит список содержимого этого контейнера в указанный выходной поток.
void list(PrintWriter out, int indent)
Выводит список, начиная с указанного отступа, в указанный print writer.
Component locate(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).
Dimension minimumSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getMinimumSize().
void paintComponents(Graphics g)
Отрисовывает каждый из компонентов в этом контейнере.
Dimension preferredSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getPreferredSize().
void printComponents(Graphics g)
Выводит на печать каждый из компонентов в этом контейнере.
protected void processContainerEvent(ContainerEvent e)
Обрабатывает события контейнера, происходящие в этом контейнере, путем их диспетчеризации любым зарегистрированным объектам ContainerListener.
protected void processEvent(AWTEvent e)
Обрабатывает события в этом контейнере.
void remove(int index)
Удаляет компонент, заданный index, из этого контейнера.
void remove(Component comp)
Удаляет указанный компонент из этого контейнера.
void removeAll()
Удаляет все компоненты из этого контейнера.
void removeContainerListener(ContainerListener l)
Удаляет указанный слушатель контейнера, чтобы он больше не получал события контейнера от этого контейнера.
void setComponentZOrder(Component comp, int index)
Перемещает указанный компонент на указанный z-order индекс в контейнере.
void setFocusCycleRoot(boolean focusCycleRoot)
Задает, является ли этот Container корнем цикла обхода фокуса.
void setFocusTraversalPolicy(FocusTraversalPolicy policy)
Устанавливает политику обхода фокуса, которая будет управлять обходом с клавиатуры дочерних элементов этого Container, если этот Container является корнем цикла фокуса.
final void setFocusTraversalPolicyProvider(boolean provider)
Задает, будет ли этот контейнер использоваться для предоставления политики обхода фокуса.
void setLayout(LayoutManager mgr)
Устанавливает менеджер компоновки для этого контейнера.
void transferFocusDownCycle()
Передает фокус на один цикл обхода фокуса вниз.
void validate()
Проверяет корректность (выполняет валидацию) этого контейнера и всех его подкомпонентов.
protected void validateTree()
Рекурсивно спускается по дереву контейнеров и пересчитывает компоновку для любых поддеревьев, помеченных как нуждающиеся в этом (помеченных как недействительные).

Методы, объявленные в классе 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
Модификатор и тип Метод Описание
boolean action(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, следует регистрировать этот компонент как ActionListener для компонента, который генерирует события действия.
void add(PopupMenu popup)
Добавляет указанное всплывающее меню к этому компоненту.
void addComponentListener(ComponentListener l)
Добавляет указанный слушатель компонентов для получения событий компонентов от этого компонента.
void addFocusListener(FocusListener l)
Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента, когда этот компонент получает фокус ввода.
void addHierarchyBoundsListener(HierarchyBoundsListener l)
Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addHierarchyListener(HierarchyListener l)
Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит этот контейнер.
void addInputMethodListener(InputMethodListener l)
Добавляет указанный слушатель методов ввода для получения событий методов ввода от этого компонента.
void addKeyListener(KeyListener l)
Добавляет указанный слушатель клавиш для получения событий клавиатуры от этого компонента.
void addMouseListener(MouseListener l)
Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
void addMouseMotionListener(MouseMotionListener l)
Добавляет указанный слушатель движения мыши для получения событий движения мыши от этого компонента.
void addMouseWheelListener(MouseWheelListener l)
Добавляет указанный слушатель колесика мыши для получения событий колесика мыши от этого компонента.
Rectangle bounds()
Устарело.
Начиная с версии JDK 1.1, заменено на getBounds().
int checkImage(Image image, int width, int height, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
int checkImage(Image image, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
Потенциально объединяет отправляемое событие с существующим событием.
boolean contains(Point p)
Проверяет, «содержит» ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента.
Image createImage(int width, int height)
Создает закадровое отрисовываемое изображение для использования при двойной буферизации.
Image createImage(ImageProducer producer)
Создает изображение из указанного поставщика изображений.
VolatileImage createVolatileImage(int width, int height)
Создает энергонезависимое закадровое отрисовываемое изображение для использования при двойной буферизации.
VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps)
Создает энергонезависимое закадровое отрисовываемое изображение с заданными возможностями.
protected final void disableEvents(long eventsToDisable)
Отключает доставку событий, определенных указанным параметром маски событий, этому компоненту.
final void dispatchEvent(AWTEvent e)
Диспетчеризует событие этому компоненту или одному из его подкомпонентов.
void enable(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setEnabled(boolean).
protected final void enableEvents(long eventsToEnable)
Включает доставку событий, определенных указанным параметром маски событий, этому компоненту.
void enableInputMethods(boolean enable)
Включает или отключает поддержку методов ввода для этого компонента.
void firePropertyChange(String propertyName, byte oldValue, byte newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, char oldValue, char newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, double oldValue, double newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, float oldValue, float newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, long oldValue, long newValue)
Сообщает об изменении связанного свойства (bound property).
void firePropertyChange(String propertyName, short oldValue, short newValue)
Сообщает об изменении связанного свойства (bound property).
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
Поддержка создания отчетов об изменении связанных свойств для свойств типа Object.
Color getBackground()
Возвращает цвет фона этого компонента.
Rectangle getBounds()
Возвращает границы этого компонента в виде объекта Rectangle.
ColorModel getColorModel()
Возвращает экземпляр ColorModel, используемый для отображения компонента на устройстве вывода.
ComponentListener[] getComponentListeners()
Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
ComponentOrientation getComponentOrientation()
Получает языковую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
Cursor getCursor()
Возвращает курсор, установленный для этого компонента.
DropTarget getDropTarget()
Возвращает DropTarget, связанный с этим Component.
Container getFocusCycleRootAncestor()
Возвращает Container, который является корнем цикла обхода фокуса для цикла обхода фокуса этого Component.
FocusListener[] getFocusListeners()
Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
boolean getFocusTraversalKeysEnabled()
Возвращает, включены ли клавиши обхода фокуса для этого Component.
Font getFont()
Возвращает шрифт этого компонента.
Color getForeground()
Возвращает цвет переднего плана этого компонента.
GraphicsConfiguration getGraphicsConfiguration()
Возвращает GraphicsConfiguration, связанный с этим Component.
HierarchyBoundsListener[] getHierarchyBoundsListeners()
Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
HierarchyListener[] getHierarchyListeners()
Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
boolean getIgnoreRepaint()
Возвращает, следует ли игнорировать сообщения перерисовки, полученные от операционной системы.
InputContext getInputContext()
Возвращает контекст ввода, используемый этим компонентом для обработки взаимодействия с методами ввода при вводе текста в этот компонент.
InputMethodListener[] getInputMethodListeners()
Возвращает массив всех слушателей методов ввода, зарегистрированных для этого компонента.
KeyListener[] getKeyListeners()
Возвращает массив всех слушателей клавиш, зарегистрированных для этого компонента.
Locale getLocale()
Возвращает локаль этого компонента.
Point getLocation()
Возвращает положение этого компонента в виде точки, определяющей верхний левый угол компонента.
Point getLocationOnScreen()
Возвращает положение этого компонента в виде точки, определяющей верхний левый угол компонента в пространстве координат экрана.
MouseListener[] getMouseListeners()
Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
MouseMotionListener[] getMouseMotionListeners()
Возвращает массив всех слушателей движения мыши, зарегистрированных для этого компонента.
Point getMousePosition()
Возвращает позицию указателя мыши в координатном пространстве этого Component, если Component находится непосредственно под указателем мыши, в противном случае возвращает null.
MouseWheelListener[] getMouseWheelListeners()
Возвращает массив всех слушателей колесика мыши, зарегистрированных для этого компонента.
String getName()
Возвращает имя компонента.
Container getParent()
Возвращает родительский элемент этого компонента.
PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех слушателей изменения свойств, зарегистрированных для этого компонента.
PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех слушателей, связанных с указанным свойством.
Dimension getSize()
Возвращает размер этого компонента в виде объекта Dimension.
Toolkit getToolkit()
Возвращает инструментарий (toolkit) этого компонента.
final Object getTreeLock()
Возвращает объект блокировки этого компонента (объект, владеющий монитором синхронизации потоков) для операций с деревом компонентов AWT и разметкой.
boolean gotFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean handleEvent(Event evt)
Устарело.
Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent).
boolean hasFocus()
Возвращает true, если этот Component является владельцем фокуса.
boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Перерисовывает компонент при изменении изображения.
boolean inside(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на contains(int, int).
boolean isBackgroundSet()
Возвращает, был ли цвет фона явно установлен для этого Component.
boolean isCursorSet()
Возвращает, был ли курсор явно установлен для этого Component.
boolean isDisplayable()
Определяет, является ли этот компонент отображаемым.
boolean isEnabled()
Определяет, включен ли этот компонент.
boolean isFocusable()
Возвращает, может ли этот Component получать фокус.
boolean isFocusOwner()
Возвращает true, если этот Component является владельцем фокуса.
boolean isFocusTraversable()
Устарело.
Начиная с версии 1.4, заменено на isFocusable().
boolean isFontSet()
Возвращает, был ли шрифт явно установлен для этого Component.
boolean isForegroundSet()
Возвращает, был ли цвет переднего плана явно установлен для этого Component.
boolean isLightweight()
Легковесный компонент не имеет собственного пира (peer) в нативном инструментарии.
boolean isMaximumSizeSet()
Возвращает true, если максимальный размер был установлен в значение, отличное от null, иначе возвращает false.
boolean isMinimumSizeSet()
Возвращает, вызывался ли setMinimumSize со значением, отличным от null.
boolean isPreferredSizeSet()
Возвращает true, если предпочтительный размер был установлен в значение, отличное от null, иначе возвращает false.
boolean isShowing()
Определяет, отображается ли этот компонент на экране.
boolean isValid()
Определяет, является ли этот компонент корректным (valid).
boolean isVisible()
Определяет, должен ли этот компонент быть видимым, когда видим его родительский элемент.
boolean keyDown(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
boolean keyUp(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
void list()
Выводит список сведений об этом компоненте в стандартный поток системного вывода System.out.
void list(PrintStream out)
Выводит список сведений об этом компоненте в указанный поток вывода.
void list(PrintWriter out)
Выводит список сведений в указанный модуль записи (print writer).
Point location()
Устарело.
Начиная с версии JDK 1.1, заменено на getLocation().
boolean lostFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean mouseDown(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseDrag(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseEnter(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseExit(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseMove(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseUp(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
void move(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на setLocation(int, int).
void nextFocus()
Устарело.
Начиная с версии JDK 1.1, заменено на transferFocus().
void paintAll(Graphics g)
Отрисовывает этот компонент и все его подкомпоненты.
boolean postEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).
boolean prepareImage(Image image, int width, int height, ImageObserver observer)
Подготавливает изображение для рендеринга на этом компоненте с указанной шириной и высотой.
boolean prepareImage(Image image, ImageObserver observer)
Подготавливает изображение для рендеринга на этом компоненте.
protected void processComponentEvent(ComponentEvent e)
Обрабатывает события компонентов, происходящие на этом компоненте, путем диспетчеризации их всем зарегистрированным объектам ComponentListener.
protected void processFocusEvent(FocusEvent e)
Обрабатывает события фокуса, происходящие на этом компоненте, путем диспетчеризации их всем зарегистрированным объектам FocusListener.
protected void processHierarchyBoundsEvent(HierarchyEvent e)
Обрабатывает события границ иерархии, происходящие на этом компоненте, путем диспетчеризации их всем зарегистрированным объектам HierarchyBoundsListener.
protected void processHierarchyEvent(HierarchyEvent e)
Обрабатывает события иерархии, происходящие на этом компоненте, путем диспетчеризации их всем зарегистрированным объектам HierarchyListener.
protected void processInputMethodEvent(InputMethodEvent e)
Обрабатывает события методов ввода, происходящие на этом компоненте, путем диспетчеризации их всем зарегистрированным объектам InputMethodListener.
protected void processMouseWheelEvent(MouseWheelEvent e)
Обрабатывает события колесика мыши, происходящие на этом компоненте, путем диспетчеризации их всем зарегистрированным объектам MouseWheelListener.
void remove(MenuComponent popup)
Удаляет указанное всплывающее меню из компонента.
void removeComponentListener(ComponentListener l)
Удаляет указанный слушатель компонентов, чтобы он больше не получал события компонентов от этого компонента.
void removeFocusListener(FocusListener l)
Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
void removeHierarchyBoundsListener(HierarchyBoundsListener l)
Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
void removeHierarchyListener(HierarchyListener l)
Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
void removeInputMethodListener(InputMethodListener l)
Удаляет указанный слушатель методов ввода, чтобы он больше не получал события методов ввода от этого компонента.
void removeKeyListener(KeyListener l)
Удаляет указанный слушатель клавиш, чтобы он больше не получал события клавиатуры от этого компонента.
void removeMouseListener(MouseListener l)
Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
void removeMouseMotionListener(MouseMotionListener l)
Удаляет указанный слушатель движения мыши, чтобы он больше не получал события движения мыши от этого компонента.
void removeMouseWheelListener(MouseWheelListener l)
Удаляет указанный слушатель колесика мыши, чтобы он больше не получал события колесика мыши от этого компонента.
void removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей.
void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей для конкретного свойства.
void repaint()
Перерисовывает этот компонент.
void repaint(int x, int y, int width, int height)
Перерисовывает указанную прямоугольную область этого компонента.
void repaint(long tm)
Перерисовывает компонент.
protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause)
Запрашивает по причине cause получение фокуса ввода этим Component, а также чтобы предок верхнего уровня этого Component стал сфокусированным Window.
void requestFocus(FocusEvent.Cause cause)
Запрашивает по причине cause получение фокуса ввода этим Component, а также чтобы предок верхнего уровня этого Component стал сфокусированным Window.
boolean requestFocusInWindow(FocusEvent.Cause cause)
Запрашивает по причине cause получение фокуса ввода этим Component, если предок верхнего уровня этого Component уже является сфокусированным Window.
void resize(int width, int height)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(int, int).
void resize(Dimension d)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(Dimension).
void setBounds(int x, int y, int width, int height)
Перемещает и изменяет размер этого компонента.
void setBounds(Rectangle r)
Перемещает и изменяет размер этого компонента в соответствии с новым ограничивающим прямоугольником r.
void setComponentOrientation(ComponentOrientation o)
Задает языковую ориентацию, которая должна использоваться для упорядочивания элементов или текста внутри этого компонента.
void setCursor(Cursor cursor)
Устанавливает изображение курсора в указанный курсор.
void setDropTarget(DropTarget dt)
Связывает DropTarget с этим компонентом.
void setFocusable(boolean focusable)
Устанавливает возможность фокусировки этого Component в указанное значение.
void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
Задает, включены ли клавиши обхода фокуса для этого Component.
void setIgnoreRepaint(boolean ignoreRepaint)
Задает, следует ли игнорировать сообщения перерисовки, полученные от операционной системы.
void setLocale(Locale l)
Задает локаль этого компонента.
void setLocation(int x, int y)
Перемещает этот компонент на новую позицию.
void setLocation(Point p)
Перемещает этот компонент на новую позицию.
void setMixingCutoutShape(Shape shape)
Задает форму «mixing-cutout» для этого легковесного компонента.
void setName(String name)
Задает имя компонента в виде указанной строки.
void setSize(int width, int height)
Изменяет размер этого компонента, устанавливая ширину width и высоту height.
void setSize(Dimension d)
Изменяет размер этого компонента, устанавливая ширину d.width и высоту d.height.
void show()
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
void show(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
Dimension size()
Устарело.
Начиная с версии JDK 1.1, заменено на getSize().
String toString()
Возвращает строковое представление этого компонента и его значений.
void transferFocus()
Передает фокус следующему компоненту, как если бы этот Component являлся владельцем фокуса.
void transferFocusBackward()
Передает фокус предыдущему компоненту, как если бы этот Component являлся владельцем фокуса.
void transferFocusUpCycle()
Передает фокус на один цикл обхода фокуса вверх.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, "равен" ли какой-либо другой объект этому объекту.
protected void finalize()
Устарело, для удаления: этот элемент API подлежит удалению в будущей версии.
Финализация устарела и подлежит удалению в будущем выпуске.
final Class<?> getClass()
Возвращает класс среды выполнения для этого Object.
int hashCode()
Возвращает значение хэш-кода для этого объекта.
final void notify()
Возобновляет работу одного потока, ожидающего на мониторе этого объекта.
final void notifyAll()
Возобновляет работу всех потоков, ожидающих на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное количество реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное количество реального времени.

Подробное описание полей

W3C_LENGTH_UNITS

public static final String W3C_LENGTH_UNITS
Ключ для свойства клиента, используемый для указания того, используются ли единицы длины, совместимые с W3C, для отрисовки HTML.

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

Начиная с:
1.5
Внешние спецификации
  • Спецификация Cascading Style Sheets Level 2 Revision 2 (CSS 2.2)
См. также:
  • Значения константных полей

HONOR_DISPLAY_PROPERTIES

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

Значение по умолчанию зависит от внешнего вида и функциональности (look and feel); чтобы включить его, установите клиентское свойство property с этим именем в Boolean.TRUE.

Начиная с:
1.5
См. также:
  • Значения константных полей

Подробное описание конструкторов

JEditorPane

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

JEditorPane

public JEditorPane(URL initialPage) throws IOException
Создает JEditorPane на основе указанного URL для ввода.
Параметры:
initialPage - URL
Исключения:
IOException - если URL равен null или к нему невозможно получить доступ

JEditorPane

public JEditorPane(String url) throws IOException
Создает JEditorPane на основе строки, содержащей спецификацию URL.
Параметры:
url - URL
Исключения:
IOException - если URL равен null или к нему невозможно получить доступ

JEditorPane

public JEditorPane(String type, String text)
Создает JEditorPane, инициализированный данным текстом. Это удобный конструктор, который вызывает методы setContentType и setText.
Параметры:
type - MIME-тип заданного текста
text - текст для инициализации; может быть null
Исключения:
NullPointerException - если параметр type равен null

Подробное описание методов

addHyperlinkListener

public void addHyperlinkListener(HyperlinkListener listener)
Добавляет слушатель гиперссылок для уведомления о любых изменениях, например, когда ссылка выбрана и активирована.
Параметры:
listener - слушатель

removeHyperlinkListener

public void removeHyperlinkListener(HyperlinkListener listener)
Удаляет слушатель гиперссылок.
Параметры:
listener - слушатель

getHyperlinkListeners

@BeanProperty(bound=false) public HyperlinkListener[] getHyperlinkListeners()
Возвращает массив всех объектов HyperLinkListener, добавленных в этот JEditorPane с помощью addHyperlinkListener().
Возвращает:
все добавленные объекты HyperLinkListener или пустой массив, если слушатели не были добавлены
Начиная с:
1.4

fireHyperlinkUpdate

public void fireHyperlinkUpdate(HyperlinkEvent e)
Оповещает всех слушателей, зарегистрировавших интерес к получению уведомлений об этом типе событий. Обычно это вызывается текущим установленным EditorKit, если тип контента, поддерживающий гиперссылки, активен в данный момент и произошло действие со ссылкой. Список слушателей обрабатывается с конца в начало.
Параметры:
e - событие
См. также:
  • EventListenerList

setPage

@BeanProperty(expert=true, description="the URL used to set content") public void setPage(URL page) throws IOException
Устанавливает текущий отображаемый URL. Тип содержимого панели устанавливается, и если комплект редактора (editor kit) для панели не равен null, создается новый документ по умолчанию, и URL считывается в него. Если URL содержит ссылку на якорь (reference location), к этому расположению будет выполнена прокрутка путем вызова метода scrollToReference. Если нужный URL совпадает с текущим отображаемым, документ не будет перезагружен. Чтобы принудительно перезагрузить документ, необходимо очистить свойство описания потока документа. В следующем коде показано, как это можно сделать:
  Document doc = jEditorPane.getDocument();
  doc.putProperty(Document.StreamDescriptionProperty, null);
Если нужный URL не совпадает с текущим отображаемым, вызывается метод getStream, чтобы предоставить подклассам контроль над предоставляемым потоком.

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

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

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

Параметры:
page - URL страницы
Исключения:
IOException - при null или неверной спецификации страницы, либо при возникновении исключения из считываемого потока
См. также:
  • getPage()

read

public void read(InputStream in, Object desc) throws IOException
Этот метод выполняет инициализацию из потока. Если комплект редактора имеет тип HTMLEditorKit, а параметр desc является HTMLDocument, он вызывает HTMLEditorKit для запуска чтения. В противном случае он вызывает метод суперкласса, который загружает модель как обычный текст.
Параметры:
in - поток, из которого производится чтение
desc - объект, описывающий поток
Исключения:
IOException - как выбрасывается потоком, используемым для инициализации
См. также:
  • JTextComponent.read(Reader, Object)
  • JTextComponent.setDocument(Document)

getStream

protected InputStream getStream(URL page) throws IOException
Получает поток для указанного URL, который должен быть загружен методом setPage. По умолчанию этот метод просто открывает URL и возвращает поток. Он может быть переопределен для выполнения полезных действий, таких как получение потока из кэша, отслеживание хода передачи потока и т. д.

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

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

Параметры:
page - URL страницы
Возвращает:
поток для загружаемого URL
Исключения:
IOException - при возникновении ошибки ввода-вывода

scrollToReference

public void scrollToReference(String reference)
Прокручивает представление к указанному местоположению ссылки (то есть значению, возвращаемому методом URL.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 - при указании null или неверной спецификации URL

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает идентификатор класса для UI.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "EditorPaneUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

createDefaultEditorKit

protected EditorKit createDefaultEditorKit()
Создает комплект редактора по умолчанию (PlainEditorKit) при первоначальном создании компонента.
Возвращает:
комплект редактора

getEditorKit

public EditorKit getEditorKit()
Получает текущий установленный комплект для обработки содержимого. При необходимости вызывается createDefaultEditorKit для установки значения по умолчанию.
Возвращает:
комплект редактора

getContentType

public final String getContentType()
Возвращает тип содержимого, для работы с которым в данный момент настроен этот редактор. Он определяется как тип, связанный с текущим установленным EditorKit.
Возвращает:
тип содержимого, null, если комплект редактора не установлен

setContentType

@BeanProperty(bound=false, description="the type of content") public final void setContentType(String type)
Устанавливает тип содержимого, который обрабатывает этот редактор. Вызывает getEditorKitForContentType, а затем setEditorKit, если комплект редактора успешно найден. Это в основном вспомогательный метод, который можно использовать в качестве альтернативы прямому вызову setEditorKit.

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

Параметры:
type - не равный null MIME-тип для поддержки редактирования контента
Исключения:
NullPointerException - если параметр type равен null
См. также:
  • getContentType()

setEditorKit

@BeanProperty(expert=true, description="the currently installed kit for handling content") public void setEditorKit(EditorKit kit)
Устанавливает текущий установленный комплект для обработки содержимого. Это связанное свойство, определяющее тип содержимого редактора. Любой старый комплект сначала удаляется, затем, если комплект не равен null, устанавливается новый комплект и для него создается документ по умолчанию. При вызове setEditorKit всегда создается событие PropertyChange ("editorKit").

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

Параметры:
kit - желаемое поведение редактора
См. также:
  • getEditorKit()

getEditorKitForContentType

public EditorKit getEditorKitForContentType(String type)
Получает комплект редактора для использования с данным типом содержимого. Вызывается, когда запрашивается тип, не соответствующий текущему установленному типу. Если для данного типа в компоненте не зарегистрирован EditorKit, будет предпринята попытка создать EditorKit из реестра EditorKit по умолчанию. Если это не удается, используется PlainEditorKit исходя из предположения, что все текстовые документы могут быть представлены в виде обычного текста.

Этот метод может быть переопределен для использования другого типа реестра. Например, его можно переопределить для использования Java Activation Framework.

Параметры:
type - тип содержимого, не равный null
Возвращает:
комплект редактора

setEditorKitForContentType

public void setEditorKitForContentType(String type, EditorKit k)
Напрямую устанавливает комплект редактора для использования с данным типом. Реализация внешнего вида (look-and-feel) может использовать это совместно с createEditorKitForContentType для установки обработчиков типов контента с привязкой к внешнему виду.
Параметры:
type - тип содержимого, не равный null
k - устанавливаемый комплект редактора

replaceSelection

public void replaceSelection(String content)
Заменяет текущее выделенное содержимое новым содержимым, представленным заданной строкой. Если выделение отсутствует, это равносильно вставке указанного текста. Если текст для замены отсутствует (т. е. строка содержимого пуста или равна null), это равносильно удалению текущего выделения. Заменяющий текст получит атрибуты, определенные в данный момент для ввода. Если компонент недоступен для редактирования, подается звуковой сигнал и происходит возврат.
Переопределяет:
replaceSelection в классе JTextComponent
Параметры:
content - содержимое для замены выделения. Это значение может быть null

createEditorKitForContentType

public static EditorKit createEditorKitForContentType(String type)
Создает обработчик для данного типа из реестра комплектов редактора по умолчанию. При необходимости реестр создается. Если зарегистрированный класс еще не был загружен, предпринимается попытка динамически загрузить прототип комплекта для данного типа. Если тип был зарегистрирован с помощью 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
Возвращает:
String, содержащую имя класса EditorKit для type
Начиная с:
1.3

getPreferredSize

public Dimension getPreferredSize()
Возвращает предпочтительный размер для JEditorPane. Предпочтительный размер для JEditorPane немного изменен по сравнению с предпочтительным размером суперкласса. Если размер области просмотра стал меньше минимального размера компонента, определение прокрутки для отслеживания ширины или высоты примет значение false. Макет области просмотра по умолчанию вернет предпочтительный размер, что нежелательно в случае, когда прокручиваемый компонент отслеживает размер. В этом случае обычный предпочтительный размер корректируется до минимального размера. Это позволяет таким элементам, как HTML-таблицы, сжиматься до минимального размера, а затем компоноваться по их минимальному размеру, не допуская дальнейшего сжатия.
Переопределяет:
getPreferredSize в классе JComponent
Возвращает:
Dimension, содержащий предпочтительный размер
См. также:
  • JComponent.setPreferredSize(Dimension)
  • ComponentUI

setText

@BeanProperty(bound=false, description="the text of this component") public void setText(String t)
Устанавливает текст этого TextComponent в указанное содержимое, которое должно соответствовать формату типа содержимого этого редактора. Например, если тип установлен в text/html, строка должна быть представлена в формате HTML.

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

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

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

Переопределяет:
setText в классе JTextComponent
Параметры:
t - новый устанавливаемый текст; если null, старый текст будет удален
См. также:
  • getText()

getText

public String getText()
Возвращает текст, содержащийся в этом TextComponent, в формате типа содержимого этого редактора. Если при попытке получить текст возникает исключение, будет возвращено null. Реализовано путем вызова JTextComponent.write с StringWriter.
Переопределяет:
getText в классе JTextComponent
Возвращает:
текст
См. также:
  • setText(String)

getScrollableTracksViewportWidth

@BeanProperty(bound=false) public boolean getScrollableTracksViewportWidth()
Возвращает true, если область просмотра всегда должна принудительно согласовывать ширину этого Scrollable с шириной области просмотра.
Определено в:
getScrollableTracksViewportWidth в интерфейсе Scrollable
Переопределяет:
getScrollableTracksViewportWidth в классе JTextComponent
Возвращает:
true, если область просмотра должна принудительно подгонять ширину Scrollable под собственную, иначе false

getScrollableTracksViewportHeight

@BeanProperty(bound=false) public boolean getScrollableTracksViewportHeight()
Возвращает true, если область просмотра всегда должна принудительно согласовывать высоту этого Scrollable с высотой области просмотра.
Определено в:
getScrollableTracksViewportHeight в интерфейсе Scrollable
Переопределяет:
getScrollableTracksViewportHeight в классе JTextComponent
Возвращает:
true, если область просмотра должна принудительно подгонять высоту Scrollable под собственную, иначе false

paramString

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

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JEditorPane. Для панелей редактора AccessibleContext принимает форму AccessibleJEditorPane. При необходимости создается новый экземпляр AccessibleJEditorPane.
Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе JTextComponent
Возвращает:
AccessibleJEditorPane, который служит в качестве AccessibleContext для этого JEditorPane

Сообщить об ошибке или предложить улучшение
Дополнительные сведения об API и документацию для разработчиков см. в документации по Java SE, где содержатся более подробные описания с точки зрения разработчика, концептуальные обзоры, определения терминов, обходные пути и примеры рабочего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее дочерних компаний в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой перераспределения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API