Класс JScrollPane

@JavaBean(defaultProperty="UI",
          description="A specialized container that manages a viewport, optional scrollbars and headers")
public class JScrollPane
extends JComponent
implements ScrollPaneConstants, Accessible

Предоставляет прокручиваемый вид лёгкого компонента. A JScrollPane управляет областью просмотра, необязательными вертикальной и горизонтальной полосами прокрутки и необязательными заголовками строк и столбцов. Документацию по JScrollPane можно найти в Руководстве по использованию панелей прокрутки, разделе в Java Tutorial. Обратите внимание, что JScrollPane не поддерживает тяжёлые компоненты.

JViewport предоставляет окно, или "область просмотра", к источнику данных — например, текстовому файлу. Этот источник данных является "прокручиваемым клиентом" (также известным как модель данных), отображаемым в представлении JViewport. JScrollPane в основном состоит из JScrollBar, JViewport, и соединения между ними, как показано на диаграмме справа.

Помимо полос прокрутки и области просмотра, JScrollPane может иметь заголовок столбца и заголовок строки. Каждый из них является объектом JViewport, который вы указываете с помощью setRowHeaderView, и setColumnHeaderView. Область просмотра заголовка столбца автоматически прокручивается влево и вправо, отслеживая прокрутку влево-вправо основной области просмотра. (Однако, она никогда не прокручивается вертикально.) Заголовок строки действует аналогичным образом.

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

Любое количество этих пустых пространств может быть заменено с помощью метода setCorner для добавления компонента в определённый угол. (Примечание: Один и тот же компонент нельзя добавить в несколько углов.) Это полезно, если вам нужно добавить дополнительное оформление или функциональность к панели прокрутки. Размер каждого углового компонента полностью определяется размером заголовков и/или полос прокрутки, которые его окружают.

Угловой компонент будет виден только в том случае, если в этом углу есть свободное пространство для его существования. Например, рассмотрите компонент, установленный в верхнем правом углу панели прокрутки со заголовком столбца. Если вертикальная полоса прокрутки панели прокрутки отсутствует, возможно, потому что компонент просмотра не достаточно вырос, чтобы её потребовать, то угловой компонент не будет показан (поскольку в этом углу нет пустого места, созданного пересечением заголовка и вертикальной полосы прокрутки). Принудительное отображение полосы прокрутки всегда, используя setVerticalScrollBarPolicy(VERTICAL_SCROLLBAR_ALWAYS), гарантирует, что место для углового компонента всегда будет.

Чтобы добавить рамку вокруг основной области просмотра, вы можете использовать setViewportBorder. (Конечно, вы также можете добавить рамку вокруг всей панели прокрутки, используя setBorder.)

Частая операция — установка цвета фона, который будет использоваться, если область просмотра содержимого меньше области просмотра или не является непрозрачной. Это можно сделать, установив цвет фона области просмотра с помощью scrollPane.getViewport().setBackground(). Причина, по которой устанавливается цвет области просмотра, а не панели прокрутки, заключается в том, что JViewport по умолчанию непрозрачна, что, помимо прочего, означает, что она полностью заполнит свой фон своим цветом фона. Поэтому, когда JScrollPane рисует свой фон, область просмотра обычно нарисует поверх него.

По умолчанию JScrollPane использует ScrollPaneLayout для обработки макета своих дочерних компонентов. ScrollPaneLayout определяет размер, который нужно задать области просмотра, одним из двух способов:

1. Если представление реализует Scrollable, используется комбинация getPreferredScrollableViewportSize, getScrollableTracksViewportWidth и getScrollableTracksViewportHeight, в противном случае
2. используется getPreferredSize.

Предупреждение: Swing не потокобезопасен. Дополнительную информацию см. в Политике потоков Swing.

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