Интерфейс Scrollable

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

public interface Scrollable

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

См. также:: JViewport, JScrollPane, JScrollBar

Методы

Модификатор и тип	Метод и описание
`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 здесь.

Возвращает:: предпочтительный размер JViewport, у которого представление — это этот Scrollable
См. также:: JComponent.getPreferredSize()

getScrollableUnitIncrement

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

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

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

Параметры:: visibleRect — область просмотра, видимая в области просмотра; orientation — либо SwingConstants.VERTICAL, либо SwingConstants.HORIZONTAL.; direction — меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо.
Возвращает:: приращение «единицы» для прокрутки в указанном направлении. Это значение должно всегда быть положительным.
См. также:: JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

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

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

Контейнеры прокрутки, такие как 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, 2020, 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.