Интерфейс 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)`	Компоненты, отображающие логические строки или столбцы, должны вычислять шаг прокрутки, который полностью отобразит один блок строк или столбцов, в зависимости от значения orientation.
`boolean`	`getScrollableTracksViewportHeight()`	Возвращает true, если область прокрутки должна всегда принудительно устанавливать высоту этого Scrollable, равную высоте области прокрутки.
`boolean`	`getScrollableTracksViewportWidth()`	Возвращает true, если область прокрутки должна всегда принудительно устанавливать ширину этого `Scrollable`, равную ширине области прокрутки.
`int`	`getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)`	Компоненты, отображающие логические строки или столбцы, должны вычислять шаг прокрутки, который полностью отобразит одну новую строку или столбец, в зависимости от значения orientation.

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

getPreferredScrollableViewportSize

Dimension getPreferredScrollableViewportSize()

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

Возвращает:

предпочтительный размер JViewport, чьей областью просмотра является этот Scrollable

См. также:

getScrollableUnitIncrement

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

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

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

Параметры:

visibleRect - Видимая область просмотра

orientation - Либо SwingConstants.VERTICAL, либо SwingConstants.HORIZONTAL.

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

Возвращает:

Шаг прокрутки "единица" в указанном направлении. Это значение всегда должно быть положительным.

См. также:

getScrollableBlockIncrement

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

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

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

Параметры:

visibleRect - Видимая область просмотра

orientation - Либо SwingConstants.VERTICAL, либо SwingConstants.HORIZONTAL.

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

Возвращает:

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

См. также:

getScrollableTracksViewportWidth

boolean getScrollableTracksViewportWidth()

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

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

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

getScrollableTracksViewportHeight

boolean getScrollableTracksViewportHeight()

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

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

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

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