Класс TextArea
- Все реализованные интерфейсы:
-
ImageObserver,MenuContainer,Serializable,Accessible
public 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
- Since:
- 1.1
- См. также:
SCROLLBARS_VERTICAL_ONLY
public static final int SCROLLBARS_VERTICAL_ONLY
- Since:
- 1.1
- См. также:
SCROLLBARS_HORIZONTAL_ONLY
public static final int SCROLLBARS_HORIZONTAL_ONLY
- Since:
- 1.1
- См. также:
SCROLLBARS_NONE
public static final int SCROLLBARS_NONE
- Since:
- 1.1
- См. также:
Подробное описание конструкторов
TextArea
public TextArea() throws HeadlessException
SCROLLBARS_BOTH, поэтому для этой текстовой области будут видны обе полосы прокрутки: вертикальная и горизонтальная.- Throws:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - См. также:
TextArea
public TextArea(String text) throws HeadlessException
SCROLLBARS_BOTH, поэтому для этой текстовой области будут видны обе полосы прокрутки: вертикальная и горизонтальная.- Параметры:
-
text- текст для отображения; еслиtextявляетсяnull, будет отображаться пустая строка"" - Throws:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - См. также:
TextArea
public TextArea(int rows, int columns) throws HeadlessException
SCROLLBARS_BOTH, поэтому для этой текстовой области будут видны обе полосы прокрутки: вертикальная и горизонтальная.- Параметры:
-
rows- количество строк -
columns- количество столбцов - Throws:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - См. также:
TextArea
public TextArea(String text, int rows, int columns) throws HeadlessException
SCROLLBARS_BOTH, поэтому для этой текстовой области будут видны обе полосы прокрутки: вертикальная и горизонтальная.- Параметры:
-
text- текст для отображения; еслиtextявляетсяnull, будет отображаться пустая строка"" -
rows- количество строк -
columns- количество столбцов - Throws:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - См. также:
TextArea
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- константа, определяющая, какие полосы прокрутки создаются для просмотра текстовой области - Throws:
-
HeadlessException- еслиGraphicsEnvironment.isHeadlessвозвращает true - Since:
- 1.1
- См. также:
Подробное описание методов
addNotify
public void addNotify()
TextArea. Виджет (peer) позволяет нам изменять внешний вид TextArea без изменения его функциональности.- Overrides:
-
addNotifyв классеTextComponent - См. также:
insert
public void insert(String str, int pos)
Обратите внимание, что передача null или несогласованных параметров является недопустимой и приведёт к неопределённому поведению.
- Параметры:
-
str- текст для вставки -
pos- позиция для вставки - Since:
- 1.1
- См. также:
insertText
@Deprecated public void insertText(String str, int pos)
insert(String, int).- Параметры:
-
str- текст для вставки -
pos- позиция для вставки
append
public void append(String str)
Обратите внимание, что передача null или несогласованных параметров является недопустимой и приведёт к неопределённому поведению.
- Параметры:
-
str- текст для добавления - Since:
- 1.1
- См. также:
appendText
@Deprecated public void appendText(String str)
append(String).- Параметры:
-
str- текст для добавления
replaceRange
public void replaceRange(String str, int start, int end)
Обратите внимание, что передача null или несогласованных параметров является недопустимой и приведёт к неопределённому поведению.
- Параметры:
-
str- текст для замены -
start- начальная позиция -
end- конечная позиция - Since:
- 1.1
- См. также:
replaceText
@Deprecated public void replaceText(String str, int start, int end)
replaceRange(String, int, int).- Параметры:
-
str- текст, используемый в качестве замены -
start- начальная позиция -
end- конечная позиция
getRows
public int getRows()
- Возвращает:
- количество строк в текстовом поле
- С:
- 1.0
- См. также:
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.- Переопределяет:
-
paramStringв классеTextComponent - Возвращает:
- строку параметров этого текстового поля
getAccessibleContext
public AccessibleContext getAccessibleContext()
AccessibleContext , связанный с этим TextArea. Для текстовых областей AccessibleContext имеет вид AccessibleAWTTextArea. Новый экземпляр AccessibleAWTTextArea создаётся при необходимости.- Определено в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеTextComponent - Возвращает:
AccessibleAWTTextArea, который служитAccessibleContextдля этогоTextArea- С:
- 1.3
© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/TextArea.html
append(String).