Класс TextArea
- Все реализуемые интерфейсы:
-
ImageObserver,MenuContainer,Serializable,Accessible
public non-sealed class TextArea extends TextComponent
TextArea — это многострочная область, отображающая текст. Он может быть настроен на редактирование или только для чтения. На следующем изображении показан вид области текста:
Данная область текста может быть создана следующей строкой кода:
new TextArea("Hello", 5, 40);
- С:
- 1.0
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class |
TextArea.AccessibleAWTTextArea |
Этот класс реализует поддержку доступности для класса TextArea. |
Вложенные классы/интерфейсы, объявленные в классе java.awt.TextComponent
TextComponent.AccessibleAWTTextComponent
Вложенные классы/интерфейсы, объявленные в классе java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
SCROLLBARS_BOTH |
Создаёт и отображает вертикальную и горизонтальную полосы прокрутки. |
static final int |
SCROLLBARS_HORIZONTAL_ONLY |
Создаёт и отображает только горизонтальную полосу прокрутки. |
static final int |
SCROLLBARS_NONE |
Не создаёт и не отображает полосы прокрутки для текстовой области. |
static final int |
SCROLLBARS_VERTICAL_ONLY |
Создаёт и отображает только вертикальную полосу прокрутки. |
Поля, объявленные в классе java.awt.TextComponent
textListener
Поля, объявленные в классе java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Поля, объявленные в интерфейсе java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
TextArea() |
Создаёт новую текстовую область со строкой "" в качестве текста. |
TextArea |
Создаёт новую текстовую область с указанным количеством строк и столбцов и пустой строкой в качестве текста. |
TextArea |
Создаёт новую текстовую область с указанным текстом. |
TextArea |
Создаёт новую текстовую область с указанным текстом и указанным количеством строк и столбцов. |
TextArea |
Создаёт новую текстовую область с указанным текстом, количеством строк, столбцов и отображением полосы прокрутки. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addNotify() |
Создаёт объекта-визауэра для TextArea. |
void |
append |
Добавляет указанный текст к текущему тексту текстовой области. |
void |
appendText |
Устаревший. |
AccessibleContext |
getAccessibleContext() |
Возвращает AccessibleContext , связанный с этим TextArea. |
int |
getColumns() |
Возвращает количество столбцов в этой текстовой области. |
Dimension |
getMinimumSize() |
Определяет минимальный размер этой текстовой области. |
Dimension |
getMinimumSize |
Определяет минимальный размер текстовой области с указанным количеством строк и столбцов. |
Dimension |
getPreferredSize() |
Определяет предпочтительный размер этой текстовой области. |
Dimension |
getPreferredSize |
Определяет предпочтительный размер текстовой области с указанным количеством строк и столбцов. |
int |
getRows() |
Возвращает количество строк в текстовой области. |
int |
getScrollbarVisibility() |
Возвращает перечисление, которое указывает, какие полосы прокрутки использует текстовая область. |
void |
insert |
Вставляет указанный текст в указанную позицию в этой текстовой области. |
void |
insertText |
Устаревший. С версии JDK 1.1 заменён на insert(String, int). |
Dimension |
minimumSize() |
Устаревшее. С версии JDK 1.1 заменено на getMinimumSize(). |
Dimension |
minimumSize |
Устаревшее. С версии JDK 1.1 заменено на getMinimumSize(int, int). |
protected String |
paramString() |
Возвращает строку, представляющую состояние этого TextArea. |
Dimension |
preferredSize() |
Устаревшее. С версии JDK 1.1 заменено на getPreferredSize(). |
Dimension |
preferredSize |
Устаревшее. С версии JDK 1.1 заменено на getPreferredSize(int, int). |
void |
replaceRange |
Заменяет текст между указанными начальной и конечной позициями заданным текстом замены. |
void |
replaceText |
Устаревшее. С версии JDK 1.1 заменено на replaceRange(String, int, int). |
void |
setColumns |
Устанавливает количество столбцов для этой области текста. |
void |
setRows |
Устанавливает количество строк для этой области текста. |
Методы, объявленные в классе java.awt.TextComponent
addTextListener, enableInputMethods, getBackground, getCaretPosition, getListeners, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processEvent, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStart, setText
Методы, объявленные в классе java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
Подробное описание полей
SCROLLBARS_BOTH
public static final int SCROLLBARS_BOTH
- С:
- 1.1
- См. также:
SCROLLBARS_VERTICAL_ONLY
public static final int SCROLLBARS_VERTICAL_ONLY
- С:
- 1.1
- См. также:
SCROLLBARS_HORIZONTAL_ONLY
public static final int SCROLLBARS_HORIZONTAL_ONLY
- С:
- 1.1
- См. также:
SCROLLBARS_NONE
public static final int SCROLLBARS_NONE
- С:
- 1.1
- См. также:
Подробное описание конструкторов
TextArea
public TextArea() throws HeadlessException
SCROLLBARS_BOTH, поэтому вертикальная и горизонтальная полосы прокрутки будут видны для этой области текста.- Исключение:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - См. также:
TextArea
public TextArea(String text) throws HeadlessException
SCROLLBARS_BOTH, поэтому и вертикальные, и горизонтальные полосы прокрутки будут видны для этой области ввода текста.- Параметры:
-
text- текст, который должен быть отображён; еслиtextявляетсяnull, будет отображена пустая строка"" - Исключения:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - См. также:
TextArea
public TextArea(int rows, int columns) throws HeadlessException
SCROLLBARS_BOTH, поэтому и вертикальные, и горизонтальные полосы прокрутки будут видны для этой области ввода текста.- Параметры:
-
rows- количество строк -
columns- количество столбцов - Исключения:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - См. также:
TextArea
public TextArea(String text, int rows, int columns) throws HeadlessException
SCROLLBARS_BOTH, поэтому и вертикальные, и горизонтальные полосы прокрутки будут видны для этой области ввода текста.- Параметры:
-
text- текст, который должен быть отображён; еслиtextявляетсяnull, будет отображена пустая строка"" -
rows- количество строк -
columns- количество столбцов - Исключения:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - См. также:
Текстовая область
public TextArea(String text, int rows, int columns, int scrollbars) throws HeadlessException
TextArea конструкторы используют этот. Класс TextArea определяет несколько констант, которые могут быть использованы в качестве значений для аргумента scrollbars:
-
SCROLLBARS_BOTH, -
SCROLLBARS_VERTICAL_ONLY, -
SCROLLBARS_HORIZONTAL_ONLY, -
SCROLLBARS_NONE.
scrollbars является недопустимым и приведёт к созданию этой текстовой области с видимостью полосы прокрутки, равной значению по умолчанию SCROLLBARS_BOTH.- Параметры:
-
text- текст для отображения; еслиtextравноnull, будет отображена пустая строка"" -
rows- количество строк; еслиrowsменьше0,rowsустанавливается в0 -
columns- количество столбцов; еслиcolumnsменьше0,columnsустанавливается в0 -
scrollbars- константа, определяющая какие полосы прокрутки создаются для просмотра текстовой области - Исключения:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - С момента:
- 1.1
- См. также:
Подробное описание методов
addNotify
public void addNotify()
TextArea. Виджет позволяет изменять внешний вид TextArea без изменения его функциональности.- Переопределяет:
-
addNotifyв классеTextComponent - См. также:
вставить
public void insert(String str, int pos)
Обратите внимание, что передача null или несогласованных параметров недопустима и приведет к неопределенному поведению.
- Параметры:
-
str- вставляемый текст -
pos- позиция для вставки - С:
- 1.1
- См. также:
вставитьТекст
@Deprecated public void insertText(String str, int pos)
insert(String, int).- Параметры:
-
str- вставляемый текст -
pos- позиция для вставки
добавить
public void append(String str)
Обратите внимание, что передача null или несогласованных параметров недопустима и приведет к неопределенному поведению.
- Параметры:
-
str- добавляемый текст - С:
- 1.1
- См. также:
добавитьТекст
@Deprecated public void appendText(String str)
append(String).- Параметры:
-
str- добавляемый текст
replaceRange
public void replaceRange(String str, int start, int end)
Обратите внимание, что передача null или несогласованных параметров является недопустимой и приведёт к неопределённому поведению.
- Parameters:
-
str- текст замены -
start- начальная позиция -
end- конечная позиция - Since:
- 1.1
- See Also:
replaceText
@Deprecated public void replaceText(String str, int start, int end)
replaceRange(String, int, int).- Parameters:
-
str- текст замены -
start- начальная позиция -
end- конечная позиция
getRows
public int getRows()
- Returns:
- количество строк в области текста
- Since:
- 1.0
- See Also:
setRows
public void setRows(int rows)
- Параметры:
-
rows- количество строк - Исключение:
-
IllegalArgumentException- если значение, заданное дляrows, меньше0 - С:
- 1.1
- См. также:
getColumns
public int getColumns()
- Возвращает:
- количество столбцов в области текста
- См. также:
setColumns
public void setColumns(int columns)
- Параметры:
-
columns- количество столбцов - Исключение:
-
IllegalArgumentException- если значение, заданное дляcolumns, меньше0 - С:
- 1.1
- См. также:
getScrollbarVisibility
public int getScrollbarVisibility()
Класс TextArea определяет четыре целочисленных константы, используемые для указания доступных полос прокрутки. TextArea имеет один конструктор, который предоставляет приложению возможность управлять полосами прокрутки.
- Возвращает:
- целое число, указывающее, какие полосы прокрутки используются
- С:
- 1.1
- См. также:
getPreferredSize
public Dimension getPreferredSize(int rows, int columns)
- Параметры:
-
rows- количество строк -
columns- количество столбцов - Возвращает:
- предпочтительные размеры для отображения текстовой области с указанным количеством строк и столбцов
- С:
- 1.1
- См. также:
preferredSize
@Deprecated public Dimension preferredSize(int rows, int columns)
getPreferredSize(int, int). - Параметры:
-
rows- количество строк -
columns- количество столбцов - Возвращает:
- предпочтительные размеры для текстовой области
getPreferredSize
public Dimension getPreferredSize()
- Переопределяет:
-
getPreferredSizeв классеComponent - Возвращает:
- предпочтительные размеры для этой текстовой области
- С:
- 1.1
- См. также:
preferredSize
@Deprecated public Dimension preferredSize()
getPreferredSize(). Component- Переопределяет:
-
preferredSizeв классеComponent - Возвращает:
- предпочтительные размеры компонента
getMinimumSize
public Dimension getMinimumSize(int rows, int columns)
- Параметры:
-
rows- количество строк -
columns- количество столбцов - Возвращает:
- минимальные размеры, необходимые для отображения текстовой области с указанным количеством строк и столбцов
- С:
- 1.1
- См. также:
minimumSize
@Deprecated public Dimension minimumSize(int rows, int columns)
getMinimumSize(int, int).- Параметры:
-
rows- количество строк -
columns- количество столбцов - Возвращает:
- минимальный размер для текстовой области
getMinimumSize
public Dimension getMinimumSize()
- Переопределяет:
-
getMinimumSizeв классеComponent - Возвращает:
- предпочтительные размеры, необходимые для этой текстовой области
- С:
- 1.1
- См. также:
minimumSize
@Deprecated public Dimension minimumSize()
getMinimumSize().Component- Переопределяет:
-
minimumSizeв классеComponent - Возвращает:
- минимальный размер этого компонента
paramString
protected String paramString()
TextArea. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.- Overrides:
-
paramStringв классеTextComponent - Возвращает:
- строку параметров этого текстового поля
getAccessibleContext
public AccessibleContext getAccessibleContext()
AccessibleContext, связанный с этим TextArea. Для текстовых областей AccessibleContext представлен в виде AccessibleAWTTextArea. Новый экземпляр AccessibleAWTTextArea создаётся при необходимости.- Specified by:
-
getAccessibleContextв интерфейсеAccessible - Overrides:
-
getAccessibleContextв классеTextComponent - Возвращает:
AccessibleAWTTextArea, который служитAccessibleContextэтогоTextArea- Since:
- 1.3
© 1993, 2023, 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.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/TextArea.html
append(String).