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 값은 스크롤 바가 현재 가시 상태인가 어떤가에 의해 동적으로 변화합니다.

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

protected class

ScrollPane.AccessibleAWTScrollPane 이 클래스는 ScrollPane 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

클래스 java.awt. Container 로부터 상속된 중첩(Nested) 클래스/인터페이스

Container.AccessibleAWTContainer

클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스

Component.AccessibleAWTComponent, 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 버전 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, 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 버전 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 상태를 나타내는 캐릭터 라인을 리턴합니다. 이 메서드는 디버그 전용이며, 리턴된 캐릭터 라인의 내용 및 형식은 구현에 따라서 다릅니다. 리턴된 캐릭터 라인은 비어있는 경우가 있습니다만, null로는 되지 않습니다.

오버라이드(override):

클래스 Container 내의 paramString

반환값:

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

processMouseWheelEvent

protected void processMouseWheelEvent(MouseWheelEvent  e)

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

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

오버라이드(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