Интерфейс Scrollable

Все известные классы, реализующие интерфейс:: DefaultTreeCellEditor.DefaultTextField, JEditorPane, JFormattedTextField, JLayer, JList, JPasswordField, JTable, JTextArea, JTextComponent, JTextField, JTextPane, JTree

public interface Scrollable

Интерфейс, предоставляющий сведения контейнеру прокрутки, например JScrollPane. Сложный компонент, который, вероятно, будет использоваться в качестве представления в области просмотра JScrollPane (или другом контейнере прокрутки), должен реализовывать этот интерфейс.

Начиная с версии:

1.2

См. также:

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

Модификатор и тип	Метод	Описание
`Dimension`	`getPreferredScrollableViewportSize()`	Возвращает предпочтительный размер области просмотра для компонента-представления.
`int`	`getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)`	Компоненты, отображающие логические строки или столбцы, должны вычислять приращение прокрутки, которое позволит полностью отобразить блок строк или столбцов, в зависимости от значения ориентации.
`boolean`	`getScrollableTracksViewportHeight()`	Возвращает true, если область просмотра всегда должна принудительно устанавливать высоту этого Scrollable равной высоте области просмотра.
`boolean`	`getScrollableTracksViewportWidth()`	Возвращает true, если область просмотра всегда должна принудительно устанавливать ширину этого `Scrollable` равной ширине области просмотра.
`int`	`getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)`	Компоненты, отображающие логические строки или столбцы, должны вычислять приращение прокрутки, которое позволит полностью отобразить одну новую строку или один новый столбец, в зависимости от значения ориентации.

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

getPreferredScrollableViewportSize

Dimension getPreferredScrollableViewportSize()

Возвращает предпочтительный размер области просмотра для компонента-представления. Например, предпочтительный размер компонента JList — это размер, необходимый для размещения всех элементов его списка. Однако значение preferredScrollableViewportSize — это размер, необходимый для JList.getVisibleRowCount строк. Компонент, не имеющий свойств, влияющих на размер области просмотра, должен просто возвращать здесь getPreferredSize.

Возвращает:

preferredSize объекта JViewport, представлением которого является этот Scrollable

См. также:

getScrollableUnitIncrement

int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)

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

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

Параметры:

visibleRect — видимая в области просмотра область представления

orientation — SwingConstants.VERTICAL или SwingConstants.HORIZONTAL.

direction — меньше нуля для прокрутки вверх/влево, больше нуля — вниз/вправо.

Возвращает:

«Единичное» приращение прокрутки в указанном направлении. Это значение всегда должно быть положительным.

См. также:

getScrollableBlockIncrement

int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)

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

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

Параметры:

visibleRect — видимая в области просмотра область представления

orientation — SwingConstants.VERTICAL или SwingConstants.HORIZONTAL.

direction — меньше нуля для прокрутки вверх/влево, больше нуля — вниз/вправо.

Возвращает:

«Блочное» приращение прокрутки в указанном направлении. Это значение всегда должно быть положительным.

См. также:

getScrollableTracksViewportWidth

boolean getScrollableTracksViewportWidth()

Возвращает true, если область просмотра всегда должна принудительно устанавливать ширину этого Scrollable равной ширине области просмотра. Например, обычное текстовое представление с поддержкой переноса строк должно возвращать здесь true, поскольку нежелательно, чтобы перенесённые строки исчезали за правым краем области просмотра. Обратите внимание: если Scrollable возвращает true, а его предок — JScrollPane, горизонтальная прокрутка фактически отключается.

Контейнеры прокрутки, например JViewport, вызывают этот метод при каждой проверке их состояния.

Возвращает:: True, если область просмотра должна принудительно установить ширину Scrollable равной собственной ширине.

getScrollableTracksViewportHeight

boolean getScrollableTracksViewportHeight()

Возвращает true, если область просмотра всегда должна принудительно устанавливать высоту этого Scrollable равной высоте области просмотра. Например, представление текста в столбцах, в котором текст распределяется по столбцам слева направо, может фактически отключить вертикальную прокрутку, возвращая здесь true.

Контейнеры прокрутки, например JViewport, вызывают этот метод при каждой проверке их состояния.

Возвращает:: True, если область просмотра должна принудительно установить высоту Scrollable равной собственной высоте.

© 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/Scrollable.html