Spec-Zone.ru › OpenJDK 27

Класс JTextArea

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.text.JTextComponent
javax.swing.JTextArea
Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, Scrollable
@JavaBean(defaultProperty="UIClassID", description="A multi-line area that displays plain text.") public class JTextArea extends JTextComponent
JTextArea представляет собой многострочную область, отображающую простой текст. Он задуман как легковесный компонент, обеспечивающий совместимость на уровне исходного кода с классом java.awt.TextArea там, где это обоснованно. Информацию и примеры использования всех текстовых компонентов можно найти в разделе Using Text Components руководства The Java Tutorial.

Этот компонент обладает возможностями, отсутствующими в классе java.awt.TextArea. Дополнительные возможности описаны в суперклассе. Альтернативными многострочными текстовыми классами с большими возможностями являются JTextPane и JEditorPane.

java.awt.TextArea внутренне управляет прокруткой. JTextArea отличается тем, что не управляет прокруткой, а реализует интерфейс Swing Scrollable. Это позволяет помещать его внутрь JScrollPane, если требуется прокрутка, и использовать напрямую, если прокрутка не нужна.

java.awt.TextArea имеет возможность переноса строк. Ранее это управлялось политикой горизонтальной прокрутки. Поскольку прокрутка не выполняется напрямую компонентом JTextArea, обратная совместимость должна обеспечиваться другим способом. JTextArea имеет связное свойство для переноса строк, которое определяет, будут ли переноситься строки. По умолчанию свойство переноса строк имеет значение false (без переноса).

java.awt.TextArea имеет два свойства, rows и columns, которые используются для определения предпочтительного размера. JTextArea использует эти свойства для указания предпочтительного размера области просмотра при размещении внутри JScrollPane, чтобы соответствовать функциональности, предоставляемой java.awt.TextArea. Предпочтительный размер JTextArea равен размеру, необходимому для отображения всего текста, благодаря чему он правильно функционирует внутри JScrollPane. Если значение rows или columns равно нулю, предпочтительный размер вдоль этой оси используется в качестве предпочтительного размера области просмотра вдоль той же оси.

За изменениями в java.awt.TextArea можно следить, добавив TextListener для TextEvent. В компонентах на основе JTextComponent изменения передаются из модели через DocumentEvent к DocumentListeners. DocumentEvent предоставляет местоположение изменения и, при необходимости, тип изменения. Фрагмент кода может выглядеть примерно так:

   DocumentListener myListener = ??;
   JTextArea myArea = ??;
   myArea.getDocument().addDocumentListener(myListener);
Символы новой строки
Подробнее об обработке символов новой строки см. в DefaultEditorKit.

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

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

Начиная с версии:
1.2
См. также:
  • JTextPane
  • JEditorPane

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

Модификатор и тип Класс Описание
protected class  JTextArea.AccessibleJTextArea
Этот класс реализует поддержку доступности для класса JTextArea.

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

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding
Модификатор и тип Класс Описание
class  JTextComponent.AccessibleJTextComponent
Этот класс реализует поддержку доступности для класса JTextComponent.
static final class  JTextComponent.DropLocation
Представляет место сброса для 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
Внутренний класс для переключения буферов в компоненте.

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

Поля, объявленные в классе 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
Делегат внешнего вида и функциональности для этого компонента.
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.

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

Конструктор Описание
JTextArea()
Создает новый TextArea.
JTextArea(int rows, int columns)
Создает новый пустой TextArea с указанным количеством строк и столбцов.
JTextArea(String text)
Создает новый TextArea с отображением указанного текста.
JTextArea(String text, int rows, int columns)
Создает новый TextArea с указанным текстом и количеством строк и столбцов.
JTextArea(Document doc)
Создает новый JTextArea с заданной моделью документа и значениями по умолчанию для всех остальных аргументов (null, 0, 0).
JTextArea(Document doc, String text, int rows, int columns)
Создает новый JTextArea с указанным количеством строк и столбцов, а также заданной моделью.

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

Модификатор и тип Метод Описание
void append(String str)
Добавляет указанный текст в конец документа.
protected Document createDefaultModel()
Создает реализацию модели по умолчанию, используемую при конструировании, если она не задана явно.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JTextArea.
int getColumns()
Возвращает количество столбцов в TextArea.
protected int getColumnWidth()
Возвращает ширину столбца.
int getLineCount()
Определяет количество строк, содержащихся в области.
int getLineEndOffset(int line)
Определяет смещение конца указанной строки.
int getLineOfOffset(int offset)
Преобразует смещение в тексте компонента в номер строки.
int getLineStartOffset(int line)
Определяет смещение начала указанной строки.
boolean getLineWrap()
Возвращает политику переноса строк текстовой области.
Dimension getPreferredScrollableViewportSize()
Возвращает предпочтительный размер области просмотра, если этот компонент встроен в JScrollPane.
Dimension getPreferredSize()
Возвращает предпочтительный размер TextArea.
protected int getRowHeight()
Определяет значение высоты строки.
int getRows()
Возвращает количество строк в TextArea.
boolean getScrollableTracksViewportWidth()
Возвращает true, если область просмотра должна всегда принудительно согласовывать ширину этого Scrollable с шириной области просмотра.
int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Компоненты, отображающие логические строки или столбцы, должны вычислять приращение прокрутки, которое полностью отобразит одну новую строку или столбец, в зависимости от значения ориентации.
int getTabSize()
Возвращает количество символов, используемых для расширения табуляции.
String getUIClassID()
Возвращает идентификатор класса для пользовательского интерфейса.
boolean getWrapStyleWord()
Возвращает стиль переноса, используемый, если текстовая область выполняет перенос строк.
void insert(String str, int pos)
Вставляет указанный текст в указанную позицию.
protected String paramString()
Возвращает строковое представление этого JTextArea.
void replaceRange(String str, int start, int end)
Заменяет текст от указанной начальной до конечной позиции указанным новым текстом.
void setColumns(int columns)
Задает количество столбцов для этого TextArea.
void setFont(Font f)
Устанавливает текущий шрифт.
void setLineWrap(boolean wrap)
Задает политику переноса строк текстовой области.
void setRows(int rows)
Задает количество строк для этого TextArea.
void setTabSize(int size)
Задает количество символов, до которого расширяется табуляция.
void setWrapStyleWord(boolean word)
Задает стиль переноса, используемый, если текстовая область выполняет перенос строк.

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

addCaretListener, addKeymap, copy, cut, fireCaretUpdate, getActions, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, modelToView2D, moveCaretPosition, paste, print, print, print, read, removeCaretListener, removeKeymap, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setDisabledTextColor, setDocument, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, 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.
Printable getPrintable(MessageFormat headerFormat, MessageFormat footerFormat)
Возвращает Printable для использования при печати содержимого этого JTextComponent.
int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
Компоненты, отображающие логические строки или столбцы, должны вычислять приращение прокрутки, которое полностью отобразит один блок строк или столбцов, в зависимости от значения ориентации.
boolean getScrollableTracksViewportHeight()
Возвращает true, если область просмотра должна всегда принудительно согласовывать высоту этого Scrollable с высотой области просмотра.
String getSelectedText()
Возвращает выделенный текст, содержащийся в этом TextComponent.
Color getSelectedTextColor()
Извлекает текущий цвет, используемый для отображения выделенного текста.
Color getSelectionColor()
Извлекает текущий цвет, используемый для отображения выделения.
int getSelectionEnd()
Возвращает конечную позицию выделенного текста.
int getSelectionStart()
Возвращает начальную позицию выделенного текста.
String getText()
Возвращает текст, содержащийся в этом TextComponent.
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)
Удаляет именованную раскладку клавиш, ранее добавленную в документ.
void replaceSelection(String content)
Заменяет текущее выделенное содержимое новым содержимым, представленным указанной строкой.
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 setText(String t)
Задает текст этого TextComponent равным указанному тексту.
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, 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)
Предоставляет делегату пользовательского интерфейса возможность определить точную форму этого компонента для обработки событий мыши.
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)
Поддержка оповещения об изменениях связанных свойств типа boolean.
void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка оповещения об изменениях связанных свойств типа integer.
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 стал активным окном (Window).
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, если этот компонент размещает свои дочерние элементы мозаикой (tiles), то есть может гарантировать, что дочерние элементы не будут перекрываться.
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 делегата пользовательского интерфейса, если делегат не равен 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)
Добавляет указанную область в список недействительных областей (dirty regions), если компонент отображается.
void repaint(Rectangle r)
Добавляет указанную область в список недействительных областей (dirty regions), если компонент отображается.
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 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, который обеспечивает поддержку передачи данных в этот компонент и из него с помощью вырезания/копирования/вставки и перетаскивания (drag and drop).
protected void setUI(ComponentUI newUI)
Устанавливает делегат внешнего вида и функциональности (look and feel) для этого компонента.
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-порядке внутри контейнера.
ContainerListener[] getContainerListeners()
Возвращает массив всех слушателей контейнера, зарегистрированных для этого контейнера.
Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор клавиш прямого перехода фокуса для заданной операции перехода для этого 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-порядке в контейнере.
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)
Создает изменяемое (volatile) закадровое отрисовываемое изображение для использования при двойной буферизации.
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)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, char oldValue, char newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, double oldValue, double newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, float oldValue, float newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, long oldValue, long newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, short oldValue, short newValue)
Сообщает об изменении связанного свойства.
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)
Заставляет текущий поток ожидать, пока он не будет разбужен, обычно путем уведомления или прерывания, либо пока не истечет определенное количество реального времени.

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

JTextArea

public JTextArea()
Конструирует новый TextArea. Задается модель по умолчанию, начальная строка равна null, а строки/столбцы установлены в 0.

JTextArea

public JTextArea(String text)
Конструирует новый TextArea с отображением указанного текста. Создается модель по умолчанию, а строки/столбцы устанавливаются в 0.
Параметры:
text - отображаемый текст или null

JTextArea

public JTextArea(int rows, int columns)
Конструирует новый пустой TextArea с указанным количеством строк и столбцов. Создается модель по умолчанию, а начальная строка равна null.
Параметры:
rows - количество строк >= 0
columns - количество столбцов >= 0
Исключения:
IllegalArgumentException - если аргументы rows или columns отрицательны.

JTextArea

public JTextArea(String text, int rows, int columns)
Конструирует новый TextArea с указанным текстом и количеством строк и столбцов. Создается модель по умолчанию.
Параметры:
text - отображаемый текст или null
rows - количество строк >= 0
columns - количество столбцов >= 0
Исключения:
IllegalArgumentException - если аргументы rows или columns отрицательны.

JTextArea

public JTextArea(Document doc)
Конструирует новый JTextArea с заданной моделью документа и значениями по умолчанию для всех остальных аргументов (null, 0, 0).
Параметры:
doc - используемая модель

JTextArea

public JTextArea(Document doc, String text, int rows, int columns)
Конструирует новый JTextArea с указанным количеством строк и столбцов и заданной моделью. Все конструкторы обращаются к этому конструктору.
Параметры:
doc - используемая модель или создание модели по умолчанию, если указано null
text - отображаемый текст, null, если текст отсутствует
rows - количество строк >= 0
columns - количество столбцов >= 0
Исключения:
IllegalArgumentException - если аргументы rows или columns отрицательны.

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

getUIClassID

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

createDefaultModel

protected Document createDefaultModel()
Создает реализацию модели по умолчанию, используемую при конструировании, если она не задана явно. Возвращается новый экземпляр PlainDocument.
Возвращает:
модель документа по умолчанию

setTabSize

@BeanProperty(preferred=true, description="the number of characters to expand tabs to") public void setTabSize(int size)
Задает количество символов, до которого расширяются символы табуляции. Это значение будет умножено на максимальное продвижение для шрифтов переменной ширины. При изменении размера табуляции генерируется событие PropertyChange ("tabSize").
Параметры:
size - количество символов для расширения
См. также:
  • getTabSize()

getTabSize

public int getTabSize()
Возвращает количество символов, используемое для расширения табуляции. Если документ равен null или не имеет настройки табуляции, возвращает значение по умолчанию 8.
Возвращает:
количество символов

setLineWrap

@BeanProperty(preferred=true, description="should lines be wrapped") public void setLineWrap(boolean wrap)
Задает политику переноса строк текстовой области. Если установлено значение true, строки будут переноситься, если они слишком длинные, чтобы поместиться в отведенную ширину. Если установлено значение false, строки никогда не будут переноситься. При изменении политики генерируется событие PropertyChange ("lineWrap"). По умолчанию это свойство равно false.
Параметры:
wrap - указывает, следует ли переносить строки
См. также:
  • getLineWrap()

getLineWrap

public boolean getLineWrap()
Возвращает политику переноса строк текстовой области. Если установлено значение true, строки будут переноситься, если они слишком длинные, чтобы поместиться в отведенную ширину. Если установлено значение false, строки никогда не будут переноситься.
Возвращает:
true, если строки будут переноситься, в противном случае false

setWrapStyleWord

@BeanProperty(description="should wrapping occur at word boundaries") public void setWrapStyleWord(boolean word)
Задает стиль переноса, используемый, если в текстовой области включен перенос строк. Если установлено значение true, строки будут переноситься по границам слов (пробелам), если они слишком длинные, чтобы поместиться в отведенную ширину. Если установлено значение false, строки будут переноситься по границам символов. По умолчанию это свойство равно false.
Параметры:
word - указывает, следует ли использовать границы слов для переноса строк
См. также:
  • getWrapStyleWord()

getWrapStyleWord

public boolean getWrapStyleWord()
Возвращает стиль переноса, используемый, если в текстовой области включен перенос строк. Если установлено значение true, строки будут переноситься по границам слов (т. е. пробелам), если они слишком длинные, чтобы поместиться в отведенную ширину. Если установлено значение false, строки будут переноситься по границам символов.
Возвращает:
true, если стиль переноса должен осуществляться по границам слов, а не по границам символов, в противном случае false
См. также:
  • setWrapStyleWord(boolean)

getLineOfOffset

public int getLineOfOffset(int offset) throws BadLocationException
Преобразует смещение в тексте компонента в номер строки.
Параметры:
offset - смещение >= 0
Возвращает:
номер строки >= 0
Исключения:
BadLocationException - выбрасывается, если смещение меньше нуля или больше длины документа.

getLineCount

@BeanProperty(bound=false) public int getLineCount()
Определяет количество строк, содержащихся в области.
Возвращает:
количество строк > 0

getLineStartOffset

public int getLineStartOffset(int line) throws BadLocationException
Определяет смещение начала заданной строки.
Параметры:
line - преобразуемый номер строки >= 0
Возвращает:
смещение >= 0
Исключения:
BadLocationException - выбрасывается, если номер строки меньше нуля или больше либо равен количеству строк, содержащихся в документе (согласно getLineCount).

getLineEndOffset

public int getLineEndOffset(int line) throws BadLocationException
Определяет смещение конца заданной строки.
Параметры:
line - строка >= 0
Возвращает:
смещение >= 0
Исключения:
BadLocationException - выбрасывается, если номер строки меньше нуля или больше либо равен количеству строк, содержащихся в документе (согласно getLineCount).

insert

public void insert(String str, int pos)
Вставляет указанный текст в указанную позицию. Ничего не делает, если модель равна null или если текст равен null или пуст.
Параметры:
str - вставляемый текст
pos - позиция для вставки >= 0
Исключения:
IllegalArgumentException - если pos является недопустимой позицией в модели
См. также:
  • TextComponent.setText(String)
  • replaceRange(String, int, int)

append

public void append(String str)
Добавляет указанный текст в конец документа. Ничего не делает, если модель равна null или если строка равна null или пуста.
Параметры:
str - вставляемый текст
См. также:
  • insert(String, int)

replaceRange

public void replaceRange(String str, int start, int end)
Заменяет текст от указанной начальной до конечной позиции на указанный новый текст. Ничего не делает, если модель равна null. Просто выполняет удаление, если новая строка равна null или пуста.
Параметры:
str - текст, используемый в качестве замены
start - начальная позиция >= 0
end - конечная позиция >= start
Исключения:
IllegalArgumentException - если часть диапазона является недопустимой позицией в модели
См. также:
  • insert(String, int)

getRows

public int getRows()
Возвращает количество строк в TextArea.
Возвращает:
количество строк >= 0

setRows

@BeanProperty(bound=false, description="the number of rows preferred for display") public void setRows(int rows)
Задает количество строк для этого TextArea. Вызывает invalidate() после установки нового значения.
Параметры:
rows - количество строк >= 0
Исключения:
IllegalArgumentException - если rows меньше 0
См. также:
  • getRows()

getRowHeight

protected int getRowHeight()
Определяет значение высоты строки. По умолчанию совпадает с высотой шрифта.
Возвращает:
высота >= 1

getColumns

public int getColumns()
Возвращает количество столбцов в TextArea.
Возвращает:
количество столбцов >= 0

setColumns

@BeanProperty(bound=false, description="the number of columns preferred for display") public void setColumns(int columns)
Задает количество столбцов для этого TextArea. Выполняет invalidate() после установки нового значения.
Параметры:
columns - количество столбцов >= 0
Исключения:
IllegalArgumentException - если columns меньше 0
См. также:
  • getColumns()

getColumnWidth

protected int getColumnWidth()
Возвращает ширину столбца. Понятие столбца может быть довольно условным для некоторых шрифтов. Этот метод используется для определения ширины столбца. По умолчанию она определяется как ширина символа m для используемого шрифта. Этот метод можно переопределить для возврата другого значения.
Возвращает:
ширина столбца >= 1

getPreferredSize

public Dimension getPreferredSize()
Возвращает предпочтительный размер TextArea. Это максимальный размер из размера, необходимого для отображения текста, и размера, запрошенного для области просмотра.
Переопределяет:
getPreferredSize в классе JComponent
Возвращает:
размер
См. также:
  • JComponent.setPreferredSize(Dimension)
  • ComponentUI

setFont

public void setFont(Font f)
Устанавливает текущий шрифт. Это удаляет кэшированные высоту строки и ширину столбца, чтобы отразить новый шрифт, и вызывает revalidate().
Переопределяет:
setFont в классе JComponent
Параметры:
f - шрифт, используемый в качестве текущего
См. также:
  • Component.getFont()

paramString

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

getScrollableTracksViewportWidth

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

getPreferredScrollableViewportSize

@BeanProperty(bound=false) public Dimension getPreferredScrollableViewportSize()
Возвращает предпочтительный размер области просмотра, если этот компонент встроен в JScrollPane. Использует требуемые настройки столбцов и строк, если они были заданы, в противном случае используется поведение суперкласса.
Определено в:
getPreferredScrollableViewportSize в интерфейсе Scrollable
Переопределяет:
getPreferredScrollableViewportSize в классе JTextComponent
Возвращает:
Значение preferredSize для JViewport, представлением которого является данный Scrollable.
См. также:
  • JComponent.getPreferredSize()

getScrollableUnitIncrement

public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Компоненты, отображающие логические строки или столбцы, должны вычислять приращение прокрутки, которое полностью отобразит одну новую строку или столбец в зависимости от значения ориентации. Реализовано с использованием значений, возвращаемых методами getRowHeight и getColumnWidth.

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

Определено в:
getScrollableUnitIncrement в интерфейсе Scrollable
Переопределяет:
getScrollableUnitIncrement в классе JTextComponent
Параметры:
visibleRect - видимая область представления внутри области просмотра
orientation - Либо SwingConstants.VERTICAL, либо SwingConstants.HORIZONTAL.
direction - Меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо.
Возвращает:
«Единичное» приращение для прокрутки в указанном направлении
Исключения:
IllegalArgumentException - при недопустимой ориентации
См. также:
  • JScrollBar.setUnitIncrement(int)
  • getRowHeight()
  • getColumnWidth()

getAccessibleContext

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

Сообщить об ошибке или предложить улучшение
Для получения дополнительной справочной информации по 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