Spec-Zone.ru › OpenJDK 25

Класс 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 там, где это возможно. Информацию и примеры использования всех текстовых компонентов можно найти в разделе Использование текстовых компонентов руководства «Учебник по 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 изменения распространяются от модели к DocumentListeners через DocumentEvent. DocumentEvent указывает местоположение изменения и, при необходимости, его тип. Фрагмент кода может выглядеть примерно так:

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

Предупреждение: Swing не является потокобезопасной библиотекой. Дополнительную информацию см. в разделе Политика многопоточности Swing.

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

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

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

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

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

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

Поля, объявленные в классе JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

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

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

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе 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()
Возвращает идентификатор класса для пользовательского интерфейса.
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

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

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

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

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

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

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

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()
Возвращает идентификатор класса для пользовательского интерфейса.
Переопределяет:
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 либо пуста.
Параметры:
str — вставляемый текст
См. также:
  • insert(String, int)

replaceRange

public void replaceRange(String str, int start, int end)
Заменяет текст от указанной начальной позиции до конечной новым указанным текстом. Ничего не делает, если модель равна null. Если новая строка равна null или пуста, просто выполняет удаление.
Параметры:
str — текст для замены
start — начальная позиция >= 0
end — конечная позиция >= начальной
Исключения:
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, если включена политика переноса строк, и 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)
Компоненты, отображающие логические строки или столбцы, должны вычислять приращение прокрутки, которое полностью покажет одну новую строку или один новый столбец в зависимости от значения orientation. В этой реализации используются значения, возвращаемые методами 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, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JTextArea.html

Spec-Zone.ru

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