java.awt
클래스 ScrollPane

java.lang.Object 
  java.awt.Component 
      java.awt.Container 
          java.awt.ScrollPane

모든 구현된 인터페이스:

ImageObserver , MenuContainer , Serializable , Accessible

public class ScrollPane
extends Container 
implements Accessible 

1 살의 아이 컴퍼넌트에 대해서, 자동 수평 또는 수직 스크롤 혹은 그 양쪽 모두를 구현하는 컨테이너 클래스입니다. 스크롤 바의 표시 정책는, 다음의 어느 쪽인가에 설정할 수가 있습니다.

1. as needed:스크롤 바는 스크로르페인이 필요로 했을 때에만 작성 및 표시된다
2. always:스크롤 바는 작성되어 항상 스크로르페인에 의해 표시된다
3. never:스크롤 바는 작성되는 일도, 스크로르페인에 의해 표시될 것도 없다

수평 스크롤 바 및 수직 스크롤 바 상태는,Adjustable 인터페이스를 구현하는 2 개의 ScrollPaneAdjustable 객체 (차원 마다 1 개(살)씩)에 의해 나타내집니다. API 는 Adjustable 객체의 속성 (unitIncrement 나 value 등)을 조작할 수 있도록(듯이), 이러한 객체에 액세스 하는 메소드를 제공합니다.

일부의 조절 가능한 프로퍼티 (minimum, maximum, blockIncrement, visibleAmount)은, 스크로르페인 및 그 아이의 기하학적 도형에 따라 스크로르페인에 의해 내부적으로 설정됩니다. 이러한 프로퍼티은 스크로르페인을 사용해 프로그램으로 설정하지 말아 주세요.

스크롤 바의 표시 정책가 "never" 이면, 그 스크로르페인은 setScrollPosition() 메소드를 사용해 프로그램적으로 스크롤 할 수가 있어 스크로르페인은 이동해 아이의 내용을 적절히 클립 합니다. 이 정책는, 프로그램이 독자적인 조절 가능한 컨트롤을 작성해 관리해야 할 때에 편리합니다.

스크롤 바의 배치는, 사용자가 프로그램의 밖에서 설정하는 플랫폼 고유의 프로퍼티으로 제어됩니다.

이 컨테이너의 초기 사이즈는 100×100 으로 설정되어 있습니다만, setSize()를 사용해 바꿀 수가 있습니다.

휠 마우스의 휠에 의한 스크롤은 디폴트로 사용 가능합니다. 이것은 setWheelScrollingEnabled 를 사용해 사용 불가로 할 수 있습니다. 휠 스크롤은 수평 및 수직 방향의 Adjustables 의 블록 및 유니트 증분치의 설정에 의해 커스터마이즈 할 수 있습니다. 마우스 휠 이벤트의 발송의 구조에 대해서는,MouseWheelEvent 의 클래스의 설명을 참조해 주세요.

Insets 는 스크롤 바가 사용하는 임의의 영역 및 스크로르페인이 작성하는 임의의 경계를 정의하기 위해서 사용됩니다. getInsets()를 사용해 insets 의 현재가를 얻을 수 있습니다. scrollbarsAlwaysVisible 의 값이 false 이면, insets 의 값은 스크롤 바가, 현재 가시 상태인가 어떤가에 의해 동적으로 변화합니다.

관련 항목:

직렬화 된 형식

상자의 클래스의 개요

protected class

ScrollPane.AccessibleAWTScrollPane 이 클래스는 ScrollPane 클래스용의 접근성?의 지원를 구현하고 있습니다.

클래스 java.awt. Container 로부터 상속된 상자의 클래스/인터페이스

Container.AccessibleAWTContainer

클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스

Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

static int	SCROLLBARS_ALWAYS 스크로르페인과 아이의 크기에 관계없이, 항상 수평/수직 스크롤 바를 표시하는 것을 나타냅니다.
static int	SCROLLBARS_AS_NEEDED 아이의 크기가 스크로르페인의 수평/수직 방향의 크기를 넘을 때만, 수평/수직 스크롤 바를 표시하는 것을 나타냅니다.
static int	SCROLLBARS_NEVER 스크로르페인과 아이의 크기에 관계없이, 항상 수평/수직 스크롤 바를 표시하지 않는 것을 나타냅니다.

클래스 java.awt. Component 로부터 상속된 필드

BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT

인터페이스 java.awt.image. ImageObserver 로부터 상속된 필드

ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH

생성자 의 개요

ScrollPane ()
스크롤 바 표시 정책가 "as needed" 인 새로운 스크로르페인콘테나를 작성합니다.

ScrollPane (int scrollbarDisplayPolicy)
새로운 스크로르페인콘테나를 작성합니다.

메소드의 개요

protected void	addImpl (Component comp, Object constraints, int index) 지정된 컴퍼넌트를, 이 스크로르페인콘테나에 추가합니다.
void	addNotify () 스크로르페인의 피어를 작성합니다.
void	doLayout () 아이의 사이즈를 추천 사이즈로 변경해 이 컨테이너를 레이아웃 합니다.
protected boolean	eventTypeEnabled (int type) 휠 스크롤이 유효한 경우, MouseWheelEvents 에 대해서 true 를 돌려줍니다.
AccessibleContext	getAccessibleContext () 이 ScrollPane 에 관련한 AccessibleContext 를 돌려줍니다.
Adjustable	getHAdjustable () 수평 스크롤 바 상태를 나타내는 ScrollPaneAdjustable 객체를 돌려줍니다.
int	getHScrollbarHeight () 수평 스크롤 바에 차지하는 높이를 돌려줍니다.
int	getScrollbarDisplayPolicy () 스크롤 바의 표시 정책를 돌려줍니다.
Point	getScrollPosition () 스크롤 한 페인의 뷰포트의 0, 0 위치에 표시되는 자내의 현재의 x, y 위치를 돌려줍니다.
Adjustable	getVAdjustable () 수직 스크롤 바 상태를 나타내는 ScrollPaneAdjustable 객체를 돌려줍니다.
Dimension	getViewportSize () 스크로르페인의 뷰포트의 현재의 사이즈를 돌려줍니다.
int	getVScrollbarWidth () 수직 스크롤 바에 차지하는 폭을 돌려줍니다.
boolean	isWheelScrollingEnabled () 마우스 휠에 응답해 스크롤을 할지 어떨지를 나타냅니다.
void	layout () 추천 되고 있지 않습니다. JDK version 1.1 이후는, doLayout() 로 옮겨졌습니다.
String	paramString () 이 ScrollPane 상태를 나타내는 캐릭터 라인을 돌려줍니다.
void	printComponents (Graphics g) 이 스크로르페인내의 컴퍼넌트를 출력합니다.
protected void	processMouseWheelEvent (MouseWheelEvent e) 이 ScrollPane 를 적절량 스크롤 해 송신되는 마우스 휠의 이벤트를 처리합니다.
void	setLayout (LayoutManager mgr) 이 컨테이너의 레이아웃 매니저를 설정합니다.
void	setScrollPosition (int x, int y) 아이 컴퍼넌트내의 지정된 위치에 스크롤 합니다.
void	setScrollPosition (Point p) 아이 컴퍼넌트내의 지정된 위치에 스크롤 합니다.
void	setWheelScrollingEnabled (boolean handleWheel) 마우스 휠의 이동에 응답해 스크롤을 유효 또는 무효로 합니다.

클래스 java.awt. Container 로부터 상속된 메소드

add , add , add , add , add , addContainerListener , addPropertyChangeListener , addPropertyChangeListener , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , findComponentAt , findComponentAt , getAlignmentX , getAlignmentY , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getComponentZOrder , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getInsets , getLayout , getListeners , getMaximumSize , getMinimumSize , getMousePosition , getPreferredSize , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicyProvider , isFocusTraversalPolicySet , list , list , locate , minimumSize , paint , paintComponents , preferredSize , print , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , removeNotify , setComponentZOrder , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , setFocusTraversalPolicyProvider , setFont , transferFocusBackward , transferFocusDownCycle , update , validate , validateTree

클래스 java.awt. Component 로부터 상속된 메소드

action , add , addComponentListener , addFocusListener , addHierarchyBoundsListener , addHierarchyListener , addInputMethodListener , addKeyListener , addMouseListener , addMouseMotionListener , addMouseWheelListener , bounds , checkImage , checkImage , coalesceEvents , contains , contains , createImage , createImage , createVolatileImage , createVolatileImage , disable , disableEvents , dispatchEvent , enable , enable , enableEvents , enableInputMethods , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , firePropertyChange , getBackground , getBaseline , getBaselineResizeBehavior , getBounds , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphics , getGraphicsConfiguration , getHeight , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMousePosition , getMouseWheelListeners , getName , getParent , getPeer , getPropertyChangeListeners , getPropertyChangeListeners , getSize , getSize , getToolkit , getTreeLock , getWidth , getX , getY , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isDoubleBuffered , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , isMaximumSizeSet , isMinimumSizeSet , isOpaque , isPreferredSizeSet , isShowing , isValid , isVisible , keyDown , keyUp , list , list , list , location , lostFocus , mouseDown , mouseDrag , mouseEnter , mouseExit , mouseMove , mouseUp , move , nextFocus , paintAll , postEvent , prepareImage , prepareImage , printAll , processComponentEvent , processFocusEvent , processHierarchyBoundsEvent , processHierarchyEvent , processInputMethodEvent , processKeyEvent , processMouseEvent , processMouseMotionEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , removePropertyChangeListener , removePropertyChangeListener , repaint , repaint , repaint , repaint , requestFocus , requestFocus , requestFocusInWindow , requestFocusInWindow , reshape , resize , resize , setBackground , setBounds , setBounds , setComponentOrientation , setCursor , setDropTarget , setEnabled , setFocusable , setFocusTraversalKeysEnabled , setForeground , setIgnoreRepaint , setLocale , setLocation , setLocation , setMaximumSize , setMinimumSize , setName , setPreferredSize , setSize , setSize , setVisible , show , show , size , toString , transferFocus , transferFocusUpCycle

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

필드의 상세

SCROLLBARS_AS_NEEDED

public static final int SCROLLBARS_AS_NEEDED

아이의 크기가 스크로르페인의 수평/수직 방향의 크기를 넘을 때만, 수평/수직 스크롤 바를 표시하는 것을 나타냅니다.

관련 항목:

정수 필드치

SCROLLBARS_ALWAYS

public static final int SCROLLBARS_ALWAYS

스크로르페인과 아이의 크기에 관계없이, 항상 수평/수직 스크롤 바를 표시하는 것을 나타냅니다.

관련 항목:

정수 필드치

SCROLLBARS_NEVER

public static final int SCROLLBARS_NEVER

스크로르페인과 아이의 크기에 관계없이, 항상 수평/수직 스크롤 바를 표시하지 않는 것을 나타냅니다.

관련 항목:

정수 필드치

생성자 의 상세

ScrollPane

public ScrollPane()
           throws HeadlessException 

스크롤 바 표시 정책가 "as needed" 인 새로운 스크로르페인콘테나를 작성합니다.

예외:

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

ScrollPane

public ScrollPane(int scrollbarDisplayPolicy)
           throws HeadlessException 

새로운 스크로르페인콘테나를 작성합니다.

파라미터:

scrollbarDisplayPolicy - 스크롤 바를 표시하는 경우를 나타내는 정책

예외:

IllegalArgumentException - 지정된 스크롤 바의 표시 정책가 무효인 경우

HeadlessException - GraphicsEnvironment.isHeadless()가 true 를 돌려주는 경우

관련 항목:

GraphicsEnvironment.isHeadless()

메소드의 상세

addImpl

protected final void addImpl(Component  comp,
                             Object  constraints,
                             int index)

지정된 컴퍼넌트를, 이 스크로르페인콘테나에 추가합니다. 스크로르페인이 기존의 아이 컴퍼넌트를 가지는 경우, 그 컴퍼넌트가 삭제되어 새로운 컴퍼넌트가 추가됩니다.

오버라이드(override):

클래스 Container 내의 addImpl

파라미터:

comp - 추가되는 컴퍼넌트

constraints - 적용외

index - 자 컴퍼넌트의 위치 (<= 0 이 아니면 안된다)

관련 항목:

Container.add(Component) , Container.add(Component, int) , Container.add(Component, java.lang.Object) , LayoutManager , LayoutManager2

getScrollbarDisplayPolicy

public int getScrollbarDisplayPolicy()

스크롤 바의 표시 정책를 돌려줍니다.

반환값:

스크롤 바의 표시 정책

getViewportSize

public Dimension  getViewportSize()

스크로르페인의 뷰포트의 현재의 사이즈를 돌려줍니다.

반환값:

픽셀 단위의 뷰포트의 사이즈

getHScrollbarHeight

public int getHScrollbarHeight()

수평 스크롤 바에 차지하는 높이를 돌려줍니다. 이것은, 스크로르페인이 현재 그것을 표시하고 있을지 어떨지와는 무관계합니다.

반환값:

픽셀 단위의 수평 스크롤 바의 높이

getVScrollbarWidth

public int getVScrollbarWidth()

수직 스크롤 바에 차지하는 폭을 돌려줍니다. 이것은, 스크로르페인이 현재 그것을 표시하고 있을지 어떨지와는 무관계합니다.

반환값:

픽셀 단위의 수직 스크롤 바의 폭

getVAdjustable

public Adjustable  getVAdjustable()

수직 스크롤 바 상태를 나타내는 ScrollPaneAdjustable 객체를 돌려줍니다. 이 메소드의 선언된 반환값의 형태는, 하위 호환을 보관 유지하기 위해서 Adjustable 가 되어 있습니다.

관련 항목:

ScrollPaneAdjustable

getHAdjustable

public Adjustable  getHAdjustable()

수평 스크롤 바 상태를 나타내는 ScrollPaneAdjustable 객체를 돌려줍니다. 이 메소드의 선언된 반환값의 형태는, 하위 호환을 보관 유지하기 위해서 Adjustable 가 되어 있습니다.

관련 항목:

ScrollPaneAdjustable

setScrollPosition

public void setScrollPosition(int x,
                              int y)

아이 컴퍼넌트내의 지정된 위치에 스크롤 합니다. 이 메소드의 호출은 스크로르페인이 아이를 포함한 경우에만 유효합니다. 아이가 용서되는 스크롤 범위외의 위치를 지정했을 경우, 가장 가까운 용서되는 위치에 스크롤 합니다. 용서되는 범위는, 구형 x =0, y = 0, 폭 = (아이의 폭 - 뷰포트폭), 높이 = (아이의 높이 - 뷰포트의 높이)로 정의됩니다. 이것은 스크롤 바 상태를 나타내는 Adjustable 객체와의 인터페이스를 가지는 편리한 메소드입니다.

파라미터:

x - 스크롤처의 x 위치

y - 스크롤처의 y 위치

예외:

NullPointerException - 스크로르페인이 아이를 포함하지 않는 경우

setScrollPosition

public void setScrollPosition(Point  p)

아이 컴퍼넌트내의 지정된 위치에 스크롤 합니다. 이 메소드의 호출은 스크로르페인이 아이를 포함한 경우에만 유효합니다. 아이가 용서되는 스크롤 범위외의 위치를 지정했을 경우, 가장 가까운 용서되는 위치에 스크롤 합니다. 용서되는 범위는, 구형 x =0, y = 0, 폭 = (아이의 폭 - 뷰포트폭), 높이 = (아이의 높이 - 뷰포트의 높이)로 정의됩니다. 이것은 스크롤 바 상태를 나타내는 Adjustable 객체와의 인터페이스를 가지는 편리한 메소드입니다.

파라미터:

p - 스크롤처의 위치를 나타내는 점

getScrollPosition

public Point  getScrollPosition()

스크롤 한 페인의 뷰포트의 0, 0 위치에 표시되는 자내의 현재의 x, y 위치를 돌려줍니다. 이것은 스크롤 바 상태를 나타내는 Adjustable 객체와의 인터페이스를 가지는 편리한 메소드입니다.

반환값:

현재의 스크롤 위치의 좌표 위치

예외:

NullPointerException - 스크로르페인이 아이를 포함하지 않는 경우

setLayout

public final void setLayout(LayoutManager  mgr)

이 컨테이너의 레이아웃 매니저를 설정합니다. 레이아웃 매니저가 설정되는 것을 막으려면 이 메소드를 오버라이드(override) 합니다.

오버라이드(override):

클래스 Container 내의 setLayout

파라미터:

mgr - 지정된 레이아웃 매니저

관련 항목:

Container.doLayout() , Container.getLayout()

doLayout

public void doLayout()

아이의 사이즈를 추천 사이즈로 변경해 이 컨테이너를 레이아웃 합니다. 아이의 새로운 추천 사이즈에서는 현재의 스크롤 위치가 부정하게 되는 경우, 스크롤 위치는 가장 가까운 용서되는 위치로 설정됩니다.

오버라이드(override):

클래스 Container 내의 doLayout

관련 항목:

Component.validate()

layout

@Deprecated 
public void layout()

추천 되고 있지 않습니다. JDK version 1.1 이후는, doLayout() 로 옮겨졌습니다.

오버라이드(override):

클래스 Container 내의 layout

printComponents

public void printComponents(Graphics  g)

이 스크로르페인내의 컴퍼넌트를 출력합니다.

오버라이드(override):

클래스 Container 내의 printComponents

파라미터:

g - 지정된 Graphics 윈도우

관련 항목:

Component.print(java.awt.Graphics) , Component.printAll(java.awt.Graphics)

addNotify

public void addNotify()

스크로르페인의 피어를 작성합니다.

오버라이드(override):

클래스 Container 내의 addNotify

관련 항목:

Component.isDisplayable() , Container.removeNotify()

paramString

public String  paramString()

이 ScrollPane 상태를 나타내는 캐릭터 라인을 돌려줍니다. 이 메소드는 디버그 전용이며, 반환되는 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 반환되는 캐릭터 라인은 빈 상태(empty)의 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):

클래스 Container 내의 paramString

반환값:

이 스크로르페인의 파라미터 캐릭터 라인

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent  e)

이 ScrollPane 를 적절량 스크롤 해 송신되는 마우스 휠의 이벤트를 처리합니다. 　

이벤트 파라미터가 null 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.

오버라이드(override):

클래스 Component 내의 processMouseWheelEvent

파라미터:

e - 마우스 휠 이벤트

도입된 버젼:

1.4

관련 항목:

MouseWheelEvent , MouseWheelListener , Component.addMouseWheelListener(java.awt.event.MouseWheelListener) , Component.enableEvents(long)

eventTypeEnabled

protected boolean eventTypeEnabled(int type)

휠 스크롤이 유효한 경우, MouseWheelEvents 에 대해서 true 를 돌려줍니다.

도입된 버젼:

1.4

setWheelScrollingEnabled

public void setWheelScrollingEnabled(boolean handleWheel)

마우스 휠의 이동에 응답해 스크롤을 유효 또는 무효로 합니다. 휠 스크롤은 디폴트로 유효합니다.

파라미터:

handleWheel - MouseWheelEvent 에 대해서 스크롤이 자동적으로 행해지는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.4

관련 항목:

isWheelScrollingEnabled() , MouseWheelEvent , MouseWheelListener

isWheelScrollingEnabled

public boolean isWheelScrollingEnabled()

마우스 휠에 응답해 스크롤을 할지 어떨지를 나타냅니다. 휠 스크롤은 디폴트로 유효합니다.

도입된 버젼:

1.4

관련 항목:

setWheelScrollingEnabled(boolean)

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 ScrollPane 에 관련한 AccessibleContext 를 돌려줍니다. 스크로르페인의 경우, AccessibleContext 는 AccessibleAWTScrollPane 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleAWTScrollPane 인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 Component 내의 getAccessibleContext

반환값:

이 ScrollPane 의 AccessibleContext 로서 기능한다 AccessibleAWTScrollPane

도입된 버젼:

1.3