Класс TextArea

java.lang.Object
- java.awt.Component
- - java.awt.TextComponent
  - - java.awt.TextArea

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

public class TextArea
extends TextComponent

Объект TextArea — это многострочная область, отображающая текст. Он может быть настроен на разрешение редактирования или на чтение только.

На следующем изображении показан вид текстовой области:

A TextArea showing the word 'Hello!'

Эта текстовая область может быть создана следующей строкой кода:

new TextArea("Hello", 5, 40);

С момента:: JDK1.0
См. также:: Сериализованная форма

Вложенные классы

Модификатор и тип	Класс и описание
`protected class`	`TextArea.AccessibleAWTTextArea` Этот класс реализует поддержку доступности для класса `TextArea`.

Вложенные классы/интерфейсы, унаследованные от класса java.awt.TextComponent

TextComponent.AccessibleAWTTextComponent

Вложенные классы/интерфейсы, унаследованные от класса java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Поля

Модификатор и тип	Поле и описание
`static int`	`SCROLLBARS_BOTH` Создаёт и отображает вертикальную и горизонтальную полосы прокрутки.
`static int`	`SCROLLBARS_HORIZONTAL_ONLY` Создаёт и отображает только горизонтальную полосу прокрутки.
`static int`	`SCROLLBARS_NONE` Не создаёт и не отображает никаких полос прокрутки для текстовой области.
`static 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(int rows, int columns)` Создаёт новую текстовую область с заданным числом строк и столбцов и строкой-пустышкой в качестве текста.
`TextArea(String text)` Создаёт новую текстовую область с заданным текстом.
`TextArea(String text, int rows, int columns)` Создаёт новую текстовую область с заданным текстом и заданным числом строк и столбцов.
`TextArea(String text, int rows, int columns, int scrollbars)` Создаёт новую текстовую область с заданным текстом, числом строк, столбцов и видимостью полос прокрутки.

Методы

Модификатор и тип	Метод и описание
`void`	`addNotify()` Создаёт виджет (peer) для `TextArea`.
`void`	`append(String str)` Добавляет заданный текст к текущему тексту текстовой области.
`void`	`appendText(String str)` Устарело. С версии JDK 1.1, заменено на `append(String)`.
`AccessibleContext`	`getAccessibleContext()` Возвращает `AccessibleContext`, связанный с этим `TextArea`.
`int`	`getColumns()` Возвращает число столбцов в этой текстовой области.
`Dimension`	`getMinimumSize()` Определяет минимальный размер этой текстовой области.
`Dimension`	`getMinimumSize(int rows, int columns)` Определяет минимальный размер текстовой области с заданным числом строк и столбцов.
`Dimension`	`getPreferredSize()` Определяет предпочтительный размер этой текстовой области.
`Dimension`	`getPreferredSize(int rows, int columns)` Определяет предпочтительный размер текстовой области с заданным числом строк и столбцов.
`int`	`getRows()` Возвращает число строк в текстовой области.
`int`	`getScrollbarVisibility()` Возвращает перечисление, указывающее, какие полосы прокрутки использует текстовая область.
`void`	`insert(String str, int pos)` Вставляет указанный текст в указанную позицию в этой текстовой области.
`void`	`insertText(String str, int pos)` Устарело. С версии JDK 1.1, заменено на `insert(String, int)`.
`Dimension`	`minimumSize()` Устарело. С версии JDK 1.1, заменено на `getMinimumSize()`.
`Dimension`	`minimumSize(int rows, int columns)` Устарело. С версии JDK 1.1, заменено на `getMinimumSize(int, int)`.
`protected String`	`paramString()` Возвращает строку, представляющую состояние этого `TextArea`.
`Dimension`	`preferredSize()` Устарело. С версии JDK 1.1, заменено на `getPreferredSize()`.
`Dimension`	`preferredSize(int rows, int columns)` Устарело. С версии JDK 1.1, заменено на `getPreferredSize(int, int)`.
`void`	`replaceRange(String str, int start, int end)` Заменяет текст между указанными начальной и конечной позициями заданным текстом замены.
`void`	`replaceText(String str, int start, int end)` Устарело. С версии JDK 1.1, заменено на `replaceRange(String, int, int)`.
`void`	`setColumns(int columns)` Устанавливает число столбцов для этой текстовой области.
`void`	`setRows(int rows)` Устанавливает число строк для этой текстовой области.

Методы, унаследованные от класса java.awt.TextComponent

addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, 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, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, 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, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Поля

SCROLLBARS_BOTH

public static final int SCROLLBARS_BOTH

Создаёт и отображает вертикальную и горизонтальную полосы прокрутки.

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

SCROLLBARS_VERTICAL_ONLY

public static final int SCROLLBARS_VERTICAL_ONLY

Создаёт и отображает только вертикальную полосу прокрутки.

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

SCROLLBARS_HORIZONTAL_ONLY

public static final int SCROLLBARS_HORIZONTAL_ONLY

Создаёт и отображает только горизонтальную полосу прокрутки.

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

SCROLLBARS_NONE

public static final int SCROLLBARS_NONE

Не создавать и не отображать полосы прокрутки для области текста.

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

Конструкторы

TextArea

public TextArea()
         throws HeadlessException

Создаёт новую область текста со строкой пустого текста. Эта область текста создаётся с видимость полос прокрутки равной SCROLLBARS_BOTH, поэтому для этой области текста будут видны как вертикальная, так и горизонтальная полосы прокрутки.

Исключение:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text)
         throws HeadlessException

Создаёт новую область текста со строкой указанного текста. Эта область текста создаётся с видимость полос прокрутки равной SCROLLBARS_BOTH, поэтому для этой области текста будут видны как вертикальная, так и горизонтальная полосы прокрутки.

Параметры:: text - текст для отображения; если text пуста, будет отображена пустая строка ""
Исключение:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

TextArea

public TextArea(int rows,
                int columns)
         throws HeadlessException

Создаёт новую область текста с указанным количеством строк и столбцов и строкой пустого текста. Столбец — это приблизительная средняя ширина символа, зависящая от платформы. Область текста создаётся с видимостью полос прокрутки равной SCROLLBARS_BOTH, поэтому для этой области текста будут видны как вертикальная, так и горизонтальная полосы прокрутки.

Параметры:: rows - количество строк; columns - количество столбцов
Исключение:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text,
                int rows,
                int columns)
         throws HeadlessException

Создаёт новую область текста с указанным текстом и указанным количеством строк и столбцов. Столбец — это приблизительная средняя ширина символа, зависящая от платформы. Область текста создаётся с видимостью полос прокрутки равной SCROLLBARS_BOTH, поэтому для этой области текста будут видны как вертикальная, так и горизонтальная полосы прокрутки.

Параметры:: text - текст для отображения; если text пуста, будет отображена пустая строка ""; rows - количество строк; columns - количество столбцов
Исключение:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
См. также:: GraphicsEnvironment.isHeadless()

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 пуста, будет отображена пустая строка ""; rows - количество строк; если rows меньше 0, rows устанавливается в 0; columns - количество столбцов; если columns меньше 0, columns устанавливается в 0; scrollbars - константа, определяющая, какие полосы прокрутки создаются для просмотра области текста
Исключение:: HeadlessException - если GraphicsEnvironment.isHeadless возвращает true
С момента:: JDK1.1
См. также:: GraphicsEnvironment.isHeadless()

Методы

addNotify

public void addNotify()

Создаёт виджет TextArea. Виджет позволяет изменять внешний вид TextArea без изменения его функциональности.

Переопределяет:: addNotify в классе TextComponent
См. также:: TextComponent.removeNotify()

insert

public void insert(String str,
                   int pos)

Вставляет указанный текст в указанную позицию в этой области текста.

Обратите внимание, что передача null или несогласованных параметров некорректна и приведёт к неопределённому поведению.

Параметры:: str - текст для вставки; pos - позиция для вставки
С момента:: JDK1.1
См. также:: TextComponent.setText(java.lang.String), replaceRange(java.lang.String, int, int), append(java.lang.String)

insertText

@Deprecated
public void insertText(String str,
                                   int pos)

Устарело. Начиная с JDK версии 1.1, заменено на insert(String, int).

append

public void append(String str)

Добавляет указанный текст к текущему тексту области текста.

Параметры:: str - текст для добавления
С момента:: JDK1.1
См. также:: insert(java.lang.String, int)

appendText

@Deprecated
public void appendText(String str)

Устарело. Начиная с JDK версии 1.1, заменено на append(String).

replaceRange

public void replaceRange(String str,
                         int start,
                         int end)

Заменяет текст между указанными начальной и конечной позициями заданным текстом замены. Текст в конечной позиции не заменяется. Текст в начальной позиции будет заменён (если начальная позиция не совпадает с конечной). Позиция текста нулевая. Вставляемая подстрока может иметь разную длину по сравнению с замещаемым текстом.

Параметры:: str - текст для замены; start - начальная позиция; end - конечная позиция
С момента:: JDK1.1
См. также:: insert(java.lang.String, int)

replaceText

@Deprecated
public void replaceText(String str,
                                    int start,
                                    int end)

Устарело. Начиная с JDK версии 1.1, заменено на replaceRange(String, int, int).

getRows

public int getRows()

Возвращает количество строк в области текста.

Возвращает:: количество строк в области текста
С момента:: JDK1
См. также:: setRows(int), getColumns()

setRows

public void setRows(int rows)

Устанавливает количество строк для этой области текста.

Параметры:: rows - количество строк
Исключение:: IllegalArgumentException - если значение, указанное для rows, меньше 0
С момента:: JDK1.1
См. также:: getRows(), setColumns(int)

getColumns

public int getColumns()

Возвращает количество столбцов в этой области текста.

Возвращает:: количество столбцов в области текста
См. также:: setColumns(int), getRows()

setColumns

public void setColumns(int columns)

Устанавливает количество столбцов для этой области текста.

Параметры:: columns - количество столбцов
Исключение:: IllegalArgumentException - если значение, указанное для columns, меньше 0
С момента:: JDK1.1
См. также:: getColumns(), setRows(int)

getScrollbarVisibility

public int getScrollbarVisibility()

Возвращает перечисление, указывающее, какие полосы прокрутки использует текстовая область.

Класс TextArea определяет четыре целочисленных константы, используемые для указания доступных полос прокрутки. TextArea имеет один конструктор, предоставляющий приложению возможность выбора полос прокрутки.

Возвращает:: целое число, указывающее, какие полосы прокрутки используются
С:: JDK1.1
См. также:: SCROLLBARS_BOTH, SCROLLBARS_VERTICAL_ONLY, SCROLLBARS_HORIZONTAL_ONLY, SCROLLBARS_NONE, TextArea(java.lang.String, int, int, int)

getPreferredSize

public Dimension getPreferredSize(int rows,
                                  int columns)

Определяет предпочтительный размер текстовой области с заданным количеством строк и столбцов.

Параметры:: rows - количество строк; columns - количество столбцов
Возвращает:: предпочтительные размеры, необходимые для отображения текстовой области с заданным количеством строк и столбцов
С:: JDK1.1
См. также:: Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize(int rows,
                                           int columns)

Устаревшее. С версии JDK 1.1, заменено на getPreferredSize(int, int).

getPreferredSize

public Dimension getPreferredSize()

Определяет предпочтительный размер этой текстовой области.

Переопределяет:: getPreferredSize в классе Component
Возвращает:: предпочтительные размеры, необходимые для этой текстовой области
С:: JDK1.1
См. также:: Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()

Устаревшее. С версии JDK 1.1, заменено на getPreferredSize().

Переопределяет:: preferredSize в классе Component

getMinimumSize

public Dimension getMinimumSize(int rows,
                                int columns)

Определяет минимальный размер текстовой области с заданным количеством строк и столбцов.

Параметры:: rows - количество строк; columns - количество столбцов
Возвращает:: минимальные размеры, необходимые для отображения текстовой области с заданным количеством строк и столбцов
С:: JDK1.1
См. также:: Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize(int rows,
                                         int columns)

Устаревшее. С версии JDK 1.1, заменено на getMinimumSize(int, int).

getMinimumSize

public Dimension getMinimumSize()

Определяет минимальный размер этой текстовой области.

Переопределяет:: getMinimumSize в классе Component
Возвращает:: предпочтительные размеры, необходимые для этой текстовой области
С:: JDK1.1
См. также:: Component.getPreferredSize()

minimumSize

@Deprecated
public Dimension minimumSize()

Устаревшее. С версии JDK 1.1, заменено на getMinimumSize().

Переопределяет:: 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, 2020, 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.