ScrollPane — 자동 스크롤 컨테이너

ScrollPane — 자동 스크롤 컨테이너

ScrollPane은 단일 자식 컴포넌트에 대해 가로·세로 스크롤을 자동으로 구현하는 컨테이너 클래스예요.

출처: Java API Reference

본문

public class ScrollPane extends Container implements Accessible

스크롤 바 표시 정책은 세 가지로 설정할 수 있어요.

  • SCROLLBARS_AS_NEEDED — 필요할 때만 스크롤 바를 만들고 표시해요.
  • SCROLLBARS_ALWAYS — 항상 스크롤 바를 만들고 표시해요.
  • SCROLLBARS_NEVER — 스크롤 바를 만들지도 표시하지도 않아요.

가로·세로 스크롤 바의 상태는 Adjustable 인터페이스를 구현하는 두 개의 ScrollPaneAdjustable 객체(각 차원당 하나)로 표현돼요. 이 객체들의 속성(예: unitIncrement, value)을 조작하는 API를 제공해요.

생성자

  • ScrollPane() — SCROLLBARS_AS_NEEDED 기본값으로 새 스크롤 패인을 만들어요.
  • ScrollPane(int scrollbarDisplayPolicy) — 지정한 스크롤 바 정책으로 만들어요.

헤드리스 환경에서는 HeadlessException을 던져요.

주요 메서드

  • setScrollPosition(Point p) — 스크롤 위치를 설정해요.
  • getScrollPosition() — 현재 스크롤 위치를 반환해요.
  • setViewportSize(Dimension d) — 뷰포트 크기를 설정해요.
  • getHAdjustable() / getVAdjustable() — 가로·세로 ScrollPaneAdjustable을 반환해요.

이 컴포넌트는 자식이 하나뿐이라는 점에 주의해요. 컨테이너 안에 여러 컴포넌트를 넣으려면 내부에 Panel 등을 사용해야 해요.

더 알아보기