javax.swing
인터페이스 Scrollable

알려진 구현 클래스 목록:

DefaultTreeCellEditor.DefaultTextField, JEditorPane, JFormattedTextField, 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) 논리행 또는 논리열을 표시하는 컴퍼넌트는 orientation 값에의해 1 블록 분의행 또는 열을 완전하게 표시하는 스크롤 증분치를 계산합니다.
boolean	getScrollableTracksViewportHeight () 뷰포트로 이 Scrollable 높이를 항상 뷰포트의 높이에 맞추는 경우에 true를 리턴합니다.
boolean	getScrollableTracksViewportWidth () 뷰포트가 항상 이 Scrollable 넓이를 강제적으로 뷰포트의 폭에 일치 시키려고 하는 경우는 true를 리턴합니다.
int	getScrollableUnitIncrement (Rectangle visibleRect, int orientation, int direction) 논리행 또는 논리열을 표시하는 컴퍼넌트는 orientation 값에의해 새로운 1 행 또는 1 열을 완전하게 표시하는 스크롤 증분치를 계산합니다.

메서드의 상세

getPreferredScrollableViewportSize

Dimension  getPreferredScrollableViewportSize()

뷰콘포넨트의 뷰포트의 적절한 사이즈를 리턴합니다. 예를 들어, JList 컴퍼넌트의 최적인 사이즈는 그 리스트의 셀을 모두 거두는데 필요한 사이즈입니다만, preferredScrollableViewportSize값은 JList.getVisibleRowCount 행을 거두는데 필요한 사이즈입니다. 뷰포트의 사이즈를 설정하는 프로퍼티가 없는 컴퍼넌트는 여기서 getPreferredSize 만을 리턴합니다.

반환값:

이 Scrollable을 뷰로서 가지는 JViewport preferredSize

관련 항목:

JComponent.getPreferredSize()

getScrollableUnitIncrement

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

논리행 또는 논리열을 표시하는 컴퍼넌트는 orientation 값에의해 새로운 1 행 또는 1 열을 완전하게 표시하는 스크롤 증분치를 계산합니다. 이론적으로는 컴퍼넌트는 항목을 완전하게 표시하기 위해서 필요한 거리를 돌려주는 것으로 부분적으로 표시되고 있는 행 또는 열을 처리합니다.

JScrollPane 등의 스크롤 컨테이너는 사용자가 유니트 스크롤을 요구하면, 이 메서드를 사용합니다.

파라미터:

visibleRect - 뷰포트내의 가시의 뷰 영역

orientation - SwingConstants.VERTICAL 또는 SwingConstants.HORIZONTAL

direction - 상또는왼쪽으로 스크롤 하는 경우는 0 보다 작고, 아래 또는 오른쪽으로 스크롤 하는 경우는 0 보다 크다

반환값:

지정된 방향으로 스크롤하기 위한 「유니트」증분치. 항상 정의 값

관련 항목:

JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

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

논리행 또는 논리열을 표시하는 컴퍼넌트는 orientation 값에의해 1 블록 분의행 또는 열을 완전하게 표시하는 스크롤 증분치를 계산합니다.

JScrollPane 등의 스크롤 컨테이너는 사용자가 블록 스크롤을 요구하면, 이 메서드를 사용합니다.

파라미터:

visibleRect - 뷰포트내의 가시의 뷰 영역

orientation - SwingConstants.VERTICAL 또는 SwingConstants.HORIZONTAL

direction - 상또는왼쪽으로 스크롤 하는 경우는 0 보다 작고, 아래 또는 오른쪽으로 스크롤 하는 경우는 0 보다 크다

반환값:

지정된 방향으로 스크롤하기 위한 「블록」증분치. 항상 정의 값

관련 항목:

JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

boolean getScrollableTracksViewportWidth()

뷰포트가 항상 이 Scrollable 넓이를 강제적으로 뷰포트의 폭에 일치 시키려고 하는 경우는 true를 리턴합니다. 예를 들어 즉시 행이 뷰포트의 우단을 넘어 사라져 버리는 것 같은 것은 무례해서, 행 반환을 지원 한 보통 의 테키스트뷰는 여기서 true를 리턴합니다. 상위 클래스에 JScrollPane를 가지는 Scrollable에 true를 돌려주면, 수평 스크롤이 사실상 무효가 되는 것에 주의해 주세요.

JViewport 등의 스크롤 컨테이너는 검증되는 곳의 메서드를 사용합니다.

반환값:

뷰포트가 Scrollable 넓이를 강제적으로 뷰포트 자체의 폭에 일치시키는 경우는 true

getScrollableTracksViewportHeight

boolean getScrollableTracksViewportHeight()

뷰포트로 이 Scrollable 높이를 항상 뷰포트의 높이에 맞추는 경우에 true를 리턴합니다. 예를 들어 왼쪽에서 오른쪽의 열에 텍스트를 표시하는 단나누기의 테키스트뷰의 경우, 이 메서드로 true를 돌려주면, 수직 방향의 스크롤이 결과적으로 무효가 됩니다.

JViewport 등의 스크롤 컨테이너는 검증되는 곳의 메서드를 사용합니다.

반환값:

뷰포트가 Scrollable 높이를 강제적으로 뷰포트 자체의 높이에 일치시키는 경우는 true