Класс ScrollPaneLayout

public class ScrollPaneLayout
extends Object
implements LayoutManager, ScrollPaneConstants, Serializable

Менеджер компоновки, используемый JScrollPane. JScrollPaneLayout отвечает за девять компонентов: область просмотра, две полосы прокрутки, заголовок строки, заголовок столбца и четыре компонента "угла".

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

Поля

viewport

protected JViewport viewport

Дочерний элемент viewport области прокрутки. По умолчанию пустой JViewport.

См. также:

JScrollPane.setViewport(javax.swing.JViewport)

vsb

protected JScrollBar vsb

Дочерний элемент вертикальной полосы прокрутки области прокрутки. По умолчанию JScrollBar.

См. также:

JScrollPane.setVerticalScrollBar(javax.swing.JScrollBar)

hsb

protected JScrollBar hsb

Дочерний элемент горизонтальной полосы прокрутки области прокрутки. По умолчанию JScrollBar.

См. также:

JScrollPane.setHorizontalScrollBar(javax.swing.JScrollBar)

rowHead

protected JViewport rowHead

Дочерний элемент заголовка строки. По умолчанию null.

См. также:

JScrollPane.setRowHeader(javax.swing.JViewport)

colHead

protected JViewport colHead

Дочерний элемент заголовка столбца. По умолчанию null.

См. также:

JScrollPane.setColumnHeader(javax.swing.JViewport)

lowerLeft

protected Component lowerLeft

Компонент для отображения в левом нижнем углу. По умолчанию null.

См. также:

JScrollPane.setCorner(java.lang.String, java.awt.Component)

lowerRight

protected Component lowerRight

Компонент для отображения в правом нижнем углу. По умолчанию null.

См. также:

JScrollPane.setCorner(java.lang.String, java.awt.Component)

upperLeft

protected Component upperLeft

Компонент для отображения в левом верхнем углу. По умолчанию null.

См. также:

JScrollPane.setCorner(java.lang.String, java.awt.Component)

upperRight

protected Component upperRight

Компонент для отображения в правом верхнем углу. По умолчанию null.

См. также:

JScrollPane.setCorner(java.lang.String, java.awt.Component)

vsbPolicy

protected int vsbPolicy

См. также:

JScrollPane.setVerticalScrollBarPolicy(int)

hsbPolicy

protected int hsbPolicy

См. также:

JScrollPane.setHorizontalScrollBarPolicy(int)

Конструкторы

ScrollPaneLayout

public ScrollPaneLayout()

Методы

syncWithScrollPane

public void syncWithScrollPane(JScrollPane sp)

Этот метод вызывается после того, как ScrollPaneLayout установлен как LayoutManager для JScrollPane. Он инициализирует все внутренние поля, которые обычно устанавливаются addLayoutComponent. Например:

ScrollPaneLayout mySPLayout = new ScrollPanelLayout() {
     public void layoutContainer(Container p) {
         super.layoutContainer(p);
         // do some extra work here ...
     }
 };
 scrollpane.setLayout(mySPLayout):

addSingletonComponent

protected Component addSingletonComponent(Component oldC,
                                          Component newC)

Параметры:

oldC - компонент для замены

newC - компонент для добавления

Возвращает:

возвращаемый newC

addLayoutComponent

public void addLayoutComponent(String s,
                               Component c)

Добавляет указанный компонент в макет. Макет идентифицируется по одному из следующих значений:

• ScrollPaneConstants.VIEWPORT
• ScrollPaneConstants.VERTICAL_SCROLLBAR
• ScrollPaneConstants.HORIZONTAL_SCROLLBAR
• ScrollPaneConstants.ROW_HEADER
• ScrollPaneConstants.COLUMN_HEADER
• ScrollPaneConstants.LOWER_LEFT_CORNER
• ScrollPaneConstants.LOWER_RIGHT_CORNER
• ScrollPaneConstants.UPPER_LEFT_CORNER
• ScrollPaneConstants.UPPER_RIGHT_CORNER

Унаследованно от:

addLayoutComponent в интерфейсе LayoutManager

Параметры:

s - идентификатор компонента

c - добавляемый компонент

Исключения:

IllegalArgumentException - если s является недопустимым ключом

removeLayoutComponent

public void removeLayoutComponent(Component c)

Удаляет указанный компонент из макета.

Унаследованно от:

removeLayoutComponent в интерфейсе LayoutManager

Параметры:

c - компонент для удаления

getVerticalScrollBarPolicy

public int getVerticalScrollBarPolicy()

Возвращает политику отображения вертикальной полосы прокрутки.

Возвращает:

целое число, определяющее политику отображения

См. также:

setVerticalScrollBarPolicy(int)

setVerticalScrollBarPolicy

public void setVerticalScrollBarPolicy(int x)

Устанавливает политику отображения вертикальной полосы прокрутки. Доступные варианты:

• ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED
• ScrollPaneConstants.VERTICAL_SCROLLBAR_NEVER
• ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS

Примечание: Приложения должны использовать версию JScrollPane этого метода. Она существует только для обратной совместимости со Swing 1.0.2 (и более ранними) версиями этого класса.

Параметры:

x - целое число, определяющее политику отображения

Исключения:

IllegalArgumentException - если x является недопустимой политикой отображения вертикальной полосы прокрутки, как указано выше

getHorizontalScrollBarPolicy

public int getHorizontalScrollBarPolicy()

Возвращает политику отображения горизонтальной полосы прокрутки.

Возвращает:

целое число, определяющее политику отображения

См. также:

setHorizontalScrollBarPolicy(int)

setHorizontalScrollBarPolicy

public void setHorizontalScrollBarPolicy(int x)

Устанавливает политику отображения горизонтальной полосы прокрутки. Доступные варианты:

• ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED
• ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER
• ScrollPaneConstants.HORIZONTAL_SCROLLBAR_ALWAYS

Примечание: Приложения должны использовать версию JScrollPane этого метода. Она существует только для обратной совместимости со Swing 1.0.2 (и более ранними) версиями этого класса.

Параметры:

x - целое число, определяющее политику отображения

Исключения:

IllegalArgumentException - если x не является допустимой политикой отображения горизонтальной полосы прокрутки, как указано выше

getViewport

public JViewport getViewport()

Возвращает объект JViewport, который отображает содержимое, подлежащее прокрутке.

Возвращает:

объект JViewport, который отображает содержимое, подлежащее прокрутке

См. также:

JScrollPane.getViewport()

getHorizontalScrollBar

public JScrollBar getHorizontalScrollBar()

Возвращает объект JScrollBar, отвечающий за горизонтальную прокрутку.

Возвращает:

объект JScrollBar, отвечающий за горизонтальную прокрутку

См. также:

JScrollPane.getHorizontalScrollBar()

getVerticalScrollBar

public JScrollBar getVerticalScrollBar()

Возвращает объект JScrollBar, отвечающий за вертикальную прокрутку.

Возвращает:

объект JScrollBar, отвечающий за вертикальную прокрутку

См. также:

JScrollPane.getVerticalScrollBar()

getRowHeader

public JViewport getRowHeader()

Возвращает объект JViewport, который является заголовком строки.

Возвращает:

объект JViewport, который является заголовком строки

См. также:

JScrollPane.getRowHeader()

getColumnHeader

public JViewport getColumnHeader()

Возвращает объект JViewport, который является заголовком столбца.

Возвращает:

объект JViewport, который является заголовком столбца

См. также:

JScrollPane.getColumnHeader()

getCorner

public Component getCorner(String key)

Возвращает компонент Component в указанном углу.

Параметры:

key - строка, определяющая угол

Возвращает:

компонент Component в указанном углу, как определено в ScrollPaneConstants; если key не является одним из четырёх углов, возвращается null

См. также:

JScrollPane.getCorner(java.lang.String)

preferredLayoutSize

public Dimension preferredLayoutSize(Container parent)

Унаследованно от:

preferredLayoutSize в интерфейсе LayoutManager

Параметры:

parent - контейнер, который будет разложен

Возвращает:

объект Dimension, определяющий предпочтительный размер viewport и полос прокрутки

См. также:

ViewportLayout, LayoutManager

minimumLayoutSize

public Dimension minimumLayoutSize(Container parent)

Минимальный размер ScrollPane — это размер отступов плюс минимальный размер области просмотра, плюс отступы области просмотра полосы прокрутки, плюс минимальный размер видимых заголовков, плюс минимальный размер полос прокрутки, для которых значение displayPolicy не равно NEVER.

Определено в:

minimumLayoutSize в интерфейсе LayoutManager

Параметры:

parent - компонент Container, который будет размещён

Возвращает:

объект Dimension, определяющий минимальный размер

См. также:

LayoutManager.preferredLayoutSize(java.awt.Container)

layoutContainer

public void layoutContainer(Container parent)

Размещает полосу прокрутки. Размещение компонентов зависит от следующих ограничений:

• Заголовок строки, если он присутствует и виден, получает предпочтительную ширину и высоту области просмотра.
• Заголовок столбца, если он присутствует и виден, получает предпочтительную высоту и ширину области просмотра.
• Если требуется вертикальная полоса прокрутки, то есть если высота области просмотра меньше высоты её представления или если displayPolicy равна ALWAYS, она рассматривается как заголовок строки в отношении своих размеров и делается видимой.
• Если требуется горизонтальная полоса прокрутки, она рассматривается как заголовок столбца (см. предыдущий абзац, касающийся вертикальной полосы прокрутки).
• Если полоса прокрутки имеет не-null viewportBorder, то выделяется место для этого.
• Область просмотра получает доступное пространство после учёта предыдущих ограничений.
• Компоненты угла, если они предоставлены, выравниваются с концами полос прокрутки и заголовков. Если есть вертикальная полоса прокрутки, отображаются правые углы; если есть горизонтальная полоса прокрутки, отображаются нижние углы; заголовок строки получает левые углы, а заголовок столбца — верхние углы.

Определено в:

layoutContainer в интерфейсе LayoutManager

Параметры:

parent - полоса прокрутки для размещения

getViewportBorderBounds

@Deprecated
public Rectangle getViewportBorderBounds(JScrollPane scrollpane)

Устаревший. С версии JDK Swing1.1 заменён на JScrollPane.getViewportBorderBounds().

Возвращает границы рамки вокруг области просмотра указанной полосы прокрутки.

Возвращает:

размер и положение рамки области просмотра