Интерфейс 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

См. также:

JComponent.getPreferredSize()

getScrollableUnitIncrement

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

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

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

Параметры:

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

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

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

Возвращает:

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

См. также:

JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

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

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

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

Параметры:

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

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

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

Возвращает:

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

См. также:

JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

boolean getScrollableTracksViewportWidth()

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

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

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

getScrollableTracksViewportHeight

boolean getScrollableTracksViewportHeight()

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

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

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

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/Scrollable.html