javax.swing
인터페이스 Scrollable

기존의 구현 클래스의 일람:

JList , JTable , JTextComponent , 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

public Dimension  getPreferredScrollableViewportSize()

뷰콘포넨트의 뷰포트의 적절한 사이즈를 돌려줍니다. 예를 들어, JList 컴퍼넌트의 preferredSize 는 그 리스트의 셀을 모두 거두기 위해서(때문에) 필요한 사이즈입니다만, preferredScrollableViewportSize 의 값은 JList.getVisibleRowCount() 행을 거두기 위해서(때문에) 필요한 사이즈입니다. 뷰포트의 사이즈를 설정하는 프로퍼티가 없는 컴퍼넌트는 여기서 getPreferredSize()만을 돌려줍니다.

반환값:

뷰가 이 Scrollable 인 JViewport 의 preferredSize

관련 항목:

JComponent.getPreferredSize()

getScrollableUnitIncrement

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

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

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

파라미터:

visibleRect - 뷰포트내의 가시의 뷰 area

orientation - SwingConstants.VERTICAL 또는 SwingConstants.HORIZONTAL

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

반환값:

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

관련 항목:

JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

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

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

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

파라미터:

visibleRect - 뷰포트내의 가시의 뷰 area

orientation - SwingConstants.VERTICAL 또는 SwingConstants.HORIZONTAL

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

반환값:

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

관련 항목:

JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()

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

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

반환값:

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

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()

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

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

반환값:

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