Spec-Zone.ru › OpenJDK 24

Класс 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
Область для отображения многострочного простого текста. Предназначена для легкого компонента, обеспечивающего совместимость исходного кода с классом java.awt.TextArea, где это возможно. Сведения и примеры использования всех текстовых компонентов можно найти в Использование текстовых компонентов в разделе «Руководство по Java».

Этот компонент обладает возможностями, отсутствующими в классе 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.

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

Since:
1.2
См. также:
  • JTextPane
  • JEditorPane

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

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

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

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

Поля, объявленные в классе javax.swing.text.JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

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

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, объявленные в классе 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

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

Конструктор Описание
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()
Возвращает идентификатор класса UI.
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)
Устанавливает стиль перевода строк, если текстовая область переводит строки.

Методы, объявленные в классе javax.swing.text.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

Методы, объявленные в классе javax.swing.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

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.awt.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

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

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

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

JTextArea

public JTextArea()
Создаёт новую область ввода текста. Устанавливается модель по умолчанию, начальная строка — null, строки/столбцы установлены в 0.

JTextArea

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

JTextArea

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

JTextArea

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

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 - если аргументы строк или столбцов отрицательны.

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

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает идентификатор класса UI.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "TextAreaUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(javax.swing.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(java.lang.String)
  • replaceRange(java.lang.String, int, int)

append

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

replaceRange

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

getRows

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

setRows

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

getRowHeight

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

getColumns

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

setColumns

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

getColumnWidth

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

getPreferredSize

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

setFont

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

paramString

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

getScrollableTracksViewportWidth

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

getPreferredScrollableViewportSize

@BeanProperty(bound=false) public Dimension getPreferredScrollableViewportSize()
Возвращает предпочтительный размер области просмотра, если этот компонент вставлен в JScrollPane. Используются желаемые настройки столбцов и строк, если они заданы, в противном случае используется поведение суперкласса.
Specified by:
getPreferredScrollableViewportSize в интерфейсе Scrollable
Overrides:
getPreferredScrollableViewportSize в классе JTextComponent
Returns:
PreferredSize JViewport, чей view — это данный Scrollable.
See Also:
  • JComponent.getPreferredSize()

getScrollableUnitIncrement

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

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

Specified by:
getScrollableUnitIncrement в интерфейсе Scrollable
Overrides:
getScrollableUnitIncrement в классе JTextComponent
Parameters:
visibleRect - область просмотра, видимая в области просмотра
orientation - Либо SwingConstants.VERTICAL, либо SwingConstants.HORIZONTAL.
direction - Меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо.
Returns:
Шаг прокрутки "единицы" в указанном направлении
Throws:
IllegalArgumentException - для недопустимого ориентации
See Also:
  • JScrollBar.setUnitIncrement(int)
  • getRowHeight()
  • getColumnWidth()

getAccessibleContext

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

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JTextArea.html

Spec-Zone.ru

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