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