Scrollbar (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt
클래스 Scrollbar

java.lang.Object 
  java.awt.Component 
      java.awt.Scrollbar

모든 구현된 인터페이스:: Adjustable, ImageObserver, MenuContainer, Serializable, Accessible

public class Scrollbar
extends Component
implements Adjustable, Accessible
extends Component
implements Adjustable, Accessible

Scrollbar 클래스는 자주 사용되는 사용자 인터페이스 객체인 스크롤 바를 실현합니다. 스크롤 바는 사용자가 값의 범위로부터 값을 선택할 수 있도록하기 위한 편리한 수단을 제공합니다. 다음의 3개의 수직 스크롤 바는 적, 록, 청의 색성분을 선택하기 위한 슬라이더 컨트롤로서 사용할 수 있습니다.

3 본횡에 줄선 수직 슬라이더를 나타내는 이미지

이 예의 스크롤 바는 각각 다음과 같은 코드를 사용해 작성할 수 있습니다.

 redSlider=new Scrollbar(Scrollbar.VERTICAL, 0, 1, 0, 255);
 add(redSlider);

또, 스크롤 바는 일정한 값의 범위를 나타낼 수가 있습니다. 예를 들어 스크롤 바를 텍스트의 스크롤에 사용하는 경우는 「버블」( 「샘」또는 「스크롤 박스」라고도 말한다)의 폭으로 가시의 텍스트의 양을 나타낼 수가 있습니다. 범위를 나타내는 스크롤 바의 예를 다음에 나타냅니다.

0 (으)로부터 300 까지의 범위의 수평 슬라이더를 나타내는 이미지. 슬라이더의 안주는 60에 라벨 붙이고 되고 있다

이 예의 버블에 의해 나타내지는 값의 범위는 「가시량」이 됩니다. 이 예의 수평 스크롤 바는 다음과 같은 코드로 작성할 수 있습니다.

 ranger = new Scrollbar(Scrollbar.HORIZONTAL, 0, 60, 0, 300);
 add(ranger);

스크롤 바의 실제의 최대값 는 maximum로 부터 visible amount를 당긴 값입니다. 상기의 예에서는 maximum가 300 으로visible amount이 60 이므로 실제의 최대값 는 240 입니다. 스크롤 바의 트럭의 범위는 0 ~ 300 입니다. 버블의 좌단은 스크롤 바의 값을 나타냅니다.

보통, 사용자는 마우스를 사용한 제스추어를 실시하는 것으로 스크롤 바의 값을 변경합니다. 예를 들어 사용자는 스크롤 바의 버블을 상하에 드래그 하거나 스크롤 바의 「유니트」증분치 영역 또는 「블록」증분치 영역을 클릭하거나 할 수 있습니다 . 또, 키보드 제스추어를 스크롤 바에 매핑 할 수도 있습니다. 보통, Page Up 키 및 Page Down 키는 스크롤 바의 「블록」증분치 영역 및 「블록」감 분치 영역의 클릭에 상당합니다.

사용자가 스크롤 바의 값을 변경하면, 스크롤 바는 AdjustmentEvent 인스턴스를 받습니다. 스크롤 바는 이 이벤트를 처리해, 등록되어 모든 리스너에게 건네줍니다.

스크롤 바의 값이 변경되었을 때에 통지를 필요로 하는 객체는 java.awt.event 패키지로 정의되는 인터페이스 AdjustmentListener를 구현할 필요가 있습니다. addAdjustmentListener 메서드 및 removeAdjustmentListener 메서드를 호출하는 것에 의해 동적으로 리스너를 추가하거나 삭제하거나 할 수 있습니다 .

AdjustmentEvent 클래스는 다음에 나타내는 5개의 형태의 조정 이벤트를 정의합니다.

AdjustmentEvent.TRACK. 이 조정 이벤트는 사용자가 스크롤 바의 버블을 드래그 했을 때에 송출된다
AdjustmentEvent.UNIT_INCREMENT. 이 조정 이벤트는 사용자가 수평 스크롤 바의 왼쪽 화살표 또는 수직 스크롤 바 상 화살표를 클릭하는지, 키보드로부터 거기에 상당하는 제스추어를 행했을 때에 송출된다
AdjustmentEvent.UNIT_DECREMENT. 이 조정 이벤트는 사용자가 수평 스크롤 바의 오른쪽 화살표 또는 수직 스크롤 바하 화살표를 클릭하는지, 키보드로부터 거기에 상당하는 제스추어를 행했을 때에 송출된다
AdjustmentEvent.BLOCK_INCREMENT. 이 조정 이벤트는 사용자가 트럭상에서 수평 스크롤 바의 버블의 좌측 또는 수직 스크롤 바의 버블의 위쪽을 클릭했을 때에 송출된다. Page Up 키가 정의되고 있는 키보드를 사용자가 사용하고 있는 경우는 보통, Page Up 키가 이것에 상당한다
AdjustmentEvent.BLOCK_DECREMENT. 이 조정 이벤트는 사용자가 트럭상에서 수평 스크롤 바의 버블의 우측 또는 수직 스크롤 바의 버블의 아래 쪽을 클릭했을 때에 송출된다. Page Down 키가 정의되고 있는 키보드를 사용자가 사용하고 있는 경우는 보통, Page Down 키가 이것에 상당한다

JDK 1. 0 이벤트 시스템은 하위 호환성을 위해서 지원되고 있습니다만, 새로운 버전의 플랫폼에서는 사용하지 말아 주세요. JDK 1. 1 으로 도입된 5개의 형태의 조정 이벤트는 이전의 버전의 플랫폼에서 스크롤 바에 관련하고 있는 5개의 이벤트형에 대응하고 있습니다. 다음의 리스트에 조정 이벤트형과 그것들에 의해 옮겨놓을 수 있었던 대응하는 JDK 1. 0 이벤트형을 나타냅니다.

AdjustmentEvent.TRACK 이 Event.SCROLL_ABSOLUTE 대신에 사용된다
AdjustmentEvent.UNIT_INCREMENT가 Event.SCROLL_LINE_UP 대신에 사용된다
AdjustmentEvent.UNIT_DECREMENT가 Event.SCROLL_LINE_DOWN 대신에 사용된다
AdjustmentEvent.BLOCK_INCREMENT가 Event.SCROLL_PAGE_UP 대신에 사용된다
AdjustmentEvent.BLOCK_DECREMENT가 Event.SCROLL_PAGE_DOWN 대신에 사용된다

주: Scrollbar는 값의 선택용으로만 사용하는 것을 추천합니다. 컨테이너내에 스크롤 가능한 컴퍼넌트를 구현하는 경우는 ScrollPane를 사용하는 것을 추천합니다. 이 목적으로 Scrollbar를 사용하면, 페인트, 키 처리, 사이즈, 위치에 관한 문제가 발생할 가능성이 있습니다.

도입된 버전 :: JDK1. 0
관련 항목:: AdjustmentEvent, AdjustmentListener, 직렬화 된 형식

중첩(Nested) 클래스 개요
`protected class`	`Scrollbar.AccessibleAWTScrollBar` 이 클래스는 `Scrollbar` 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.

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

필드 개요
`static int`	`HORIZONTAL` 수평 스크롤 바를 나타내는 정수입니다.
`static int`	`VERTICAL` 수직 스크롤 바를 나타내는 정수입니다.

클래스 java.awt. Component 로부터 상속된 필드
`BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT`

인터페이스 java.awt. Adjustable 로부터 상속된 필드
`NO_ORIENTATION`

인터페이스 java.awt.image. ImageObserver 로부터 상속된 필드
`ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH`

생성자 개요
`Scrollbar ()` 새로운 수직 스크롤 바를 구축합니다.
`Scrollbar (int orientation)` 지정된 방향의 새로운 스크롤 바를 구축합니다.
`Scrollbar (int orientation, int value, int visible, int minimum, int maximum)` 지정된 방향, 초기값, 가시량, 최소값 및 최대값을 가지는 새로운 스크롤 바를 구축합니다.

메서드 개요

void addAdjustmentListener (AdjustmentListener l)
이 스크롤 바로부터 AdjustmentEvent 인스턴스를 받기 위해서 지정된 조정 리스너를 추가합니다.

void addNotify ()
Scrollbar 피어를 작성합니다.

AccessibleContext getAccessibleContext ()
이 Scrollbar에 관련된 AccessibleContext를 리턴합니다.

AdjustmentListener [] getAdjustmentListeners ()
이 스크롤 바에 등록된 모든 조정 리스너의 배열을 리턴합니다.

int getBlockIncrement ()
이 스크롤 바의 「블록」증분치를 리턴합니다.

int getLineIncrement ()
추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getUnitIncrement()를 사용합니다.





<T extends EventListener > 


T[]

getListeners (Class <T> listenerType)
이 Scrollbar에 FooListener로 서 현재 등록되어 모든 객체의 배열을 리턴합니다.

int getMaximum ()
이 스크롤 바의 최대값을 리턴합니다.

int getMinimum ()
이 스크롤 바의 최소값을 리턴합니다.

int getOrientation ()
이 스크롤 바의 방향을 리턴합니다.

int getPageIncrement ()
추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getBlockIncrement()를 사용합니다.

int getUnitIncrement ()
이 스크롤 바의 「유니트」증분치를 리턴합니다.

int getValue ()
이 스크롤 바의 현재가를 리턴합니다.

boolean getValueIsAdjusting ()
사용자가 액션을 취득중이기 위해서 값의 변경이 진행되고 있는 경우에 true를 리턴합니다.

int getVisible ()
추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getVisibleAmount()를 사용합니다.

int getVisibleAmount ()
이 스크롤 바의 가시량을 리턴합니다.

protected String paramString ()
이 Scrollbar 상태를 나타내는 캐릭터 라인을 리턴합니다.

protected void processAdjustmentEvent (AdjustmentEvent e)
이 스크롤 바로 발생하는 조정 이벤트를, 등록되어 있는 AdjustmentListener 객체에 디스패치 하는 것으로써, 조정 이벤트를 처리합니다.

protected void processEvent (AWTEvent e)
이 스크롤 바의 이벤트를 처리합니다.

void removeAdjustmentListener (AdjustmentListener l)
이 스크롤 바로부터 AdjustmentEvent 인스턴스를 받지 않게, 지정된 조정 리스너를 삭제합니다.

void setBlockIncrement (int v)
이 스크롤 바의 「블록」증분치를 설정합니다.

void setLineIncrement (int v)
추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setUnitIncrement(int)를 사용합니다.

void setMaximum (int newMaximum)
이 스크롤 바의 최대값을 설정합니다.

void setMinimum (int newMinimum)
이 스크롤 바의 최소값을 설정합니다.

void setOrientation (int orientation)
이 스크롤 바의 방향을 설정합니다.

void setPageIncrement (int v)
추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setBlockIncrement()를 사용합니다.

void setUnitIncrement (int v)
이 스크롤 바의 「유니트」증분치를 설정합니다.

void setValue (int newValue)
이 스크롤 바의 값을 지정된 값으로 설정합니다.

void setValueIsAdjusting (boolean b)
valueIsAdjusting 프로퍼티를 설정합니다.

void setValues (int value, int visible, int minimum, int maximum)
이 스크롤 바의 다음의 4개의 프로퍼티의 값을 설정합니다.

void setVisibleAmount (int newAmount)
이 스크롤 바의 가시량을 설정합니다.

클래스 java.awt. Component 로부터 상속된 메서드
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

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

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

클래스 java.lang. Object 로부터 상속된 메서드
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

필드의 상세

HORIZONTAL

public static final int HORIZONTAL

수평 스크롤 바를 나타내는 정수입니다.

관련 항목:: 정수 필드값

VERTICAL

public static final int VERTICAL

수직 스크롤 바를 나타내는 정수입니다.

관련 항목:: 정수 필드값

생성자 상세

Scrollbar

public Scrollbar()
          throws HeadlessException

새로운 수직 스크롤 바를 구축합니다. 다음의 겉(표)는 스크롤 바의 디폴트 프로퍼티를 나타내고 있습니다.

프로퍼티	설명	기정치
orientation	스크롤 바가 수직인가 수평인지를 나타내는	`Scrollbar.VERTICAL`
value	스크롤 바의 버블의 위치를 제어하는 값	0
visible amount	스크롤 바의 범위의 가시량, 일반적으로 스크롤 바의 버블의 사이즈로 나타내지는	10
minimum	스크롤 바의 최소값	0
maximum	스크롤 바의 최대값	100
unit increment	Line Up 키 또는 Line Down 키 하지만 밀리는지, 또는 스크롤 바의 말미의 화살표가 클릭되었을 경우의 값의 변화한 양	1
block increment	Page Up 키 또는 Page Down 키 하지만 밀리는지, 스크롤 바의 트럭이 버블의 한쪽 편에서 클릭되었을 경우의 값의 변화한 양	10

예외:: HeadlessException - GraphicsEnvironment.isHeadless()가 true를 돌려주는 경우
관련 항목:: GraphicsEnvironment.isHeadless()

Scrollbar

public Scrollbar(int orientation)
          throws HeadlessException

지정된 방향의 새로운 스크롤 바를 구축합니다.

orientation인수는 수평 스크롤 바를 나타내는 값인 Scrollbar.HORIZONTAL 또는 수직 스크롤 바를 나타내는 값인 Scrollbar.VERTICAL 어느 쪽인지 나오지 않으면 안됩니다.

파라미터:: orientation - 스크롤 바의 방향을 나타낸다
예외:: IllegalArgumentException - orientation인수에 부정한 값이 지정되었을 경우; HeadlessException - GraphicsEnvironment.isHeadless()가 true를 돌려주는 경우
관련 항목:: GraphicsEnvironment.isHeadless()

Scrollbar

public Scrollbar(int orientation,
                 int value,
                 int visible,
                 int minimum,
                 int maximum)
          throws HeadlessException

지정된 방향, 초기값, 가시량, 최소값 및 최대값을 가지는 새로운 스크롤 바를 구축합니다.

이 생성자 으로 지정되는 파라미터는 setValues(int, int, int, int)에 기술된 제약에 따릅니다.

파라미터:: orientation - 스크롤 바의 방향을 나타내는; value - 스크롤 바의 초기값; visible - 스크롤 바의 가시량, 일반적으로 버블의 사이즈로 나타내지는; minimum - 스크롤 바의 최소값; maximum - 스크롤 바의 최대값
예외:: IllegalArgumentException - orientation인수에 부정한 값이 지정되었을 경우; HeadlessException - GraphicsEnvironment.isHeadless()가 true를 돌려주는 경우
관련 항목:: setValues(int, int, int, int), GraphicsEnvironment.isHeadless()

메서드의 상세

addNotify

public void addNotify()

Scrollbar 피어를 작성합니다. 피어는 Scrollbar 기능을 변경하지 않고 로 외관을 변경할 수 있습니다.

오버라이드(override):: 클래스 Component 내의 addNotify

관련 항목:: Component.isDisplayable(), Component.removeNotify()

getOrientation

public int getOrientation()

이 스크롤 바의 방향을 리턴합니다.

정의:: 인터페이스 Adjustable 내의 getOrientation

반환값:: 이 스크롤 바의 방향. Scrollbar.HORIZONTAL 또는 Scrollbar.VERTICAL
관련 항목:: setOrientation(int)

setOrientation

public void setOrientation(int orientation)

이 스크롤 바의 방향을 설정합니다.

파라미터:: orientation - 이 스크롤 바의 방향. Scrollbar.HORIZONTAL 또는 Scrollbar.VERTICAL
예외:: IllegalArgumentException - orientation로 지정된 값이 부정한 값인 경우
도입된 버전 :: JDK1. 1
관련 항목:: getOrientation()

getValue

public int getValue()

이 스크롤 바의 현재가를 리턴합니다.

정의:: 인터페이스 Adjustable 내의 getValue

반환값:: 이 스크롤 바의 현재의 값
관련 항목:: getMinimum(), getMaximum()

setValue

public void setValue(int newValue)

이 스크롤 바의 값을 지정된 값으로 설정합니다.

지정된 값이 현재의 visibleAmount minimum 보다 작은 경우, 또는 현재의 maximum 보다 큰 경우는 visibleAmount minimum 또는 maximum가 적절한 값으로 옮겨집니다.

보통, 프로그램은 setValues를 호출하는 것에 해서만, 스크롤 바의 값을 변경합니다. setValues 메서드는 스크롤 바의 최소값, 최대값, 가시량 및 값프로퍼티를, 서로 모순되지 않게 동시에 동기적으로 설정합니다.

이 메서드를 호출해도 AdjustmentEvent는 트리거 하지 않습니다.

정의:: 인터페이스 Adjustable 내의 setValue

파라미터:: newValue - 스크롤 바의 새로운 값
관련 항목:: setValues(int, int, int, int), getValue(), getMinimum(), getMaximum()

getMinimum

public int getMinimum()

이 스크롤 바의 최소값을 리턴합니다.

정의:: 인터페이스 Adjustable 내의 getMinimum

반환값:: 이 스크롤 바의 최소값
관련 항목:: getValue(), getMaximum()

setMinimum

public void setMinimum(int newMinimum)

이 스크롤 바의 최소값을 설정합니다.

setMinimum를 호출해, 최소값을 변경하면, 그 외의 값 (최대값, 가시량 및 현재의 스크롤 바의 값)이 새로운 최소값에 맞추어 변경됩니다.

보통, 프로그램은 setValues를 호출하는 것에 해서만, 스크롤 바의 최소값을 변경합니다. setValues 메서드는 스크롤 바의 최소값, 최대값, 가시량 및 값프로퍼티를, 서로 모순되지 않게 동시에 동기적으로 설정합니다.

최소값을 Integer.MAX_VALUE로 설정하면, 새로운 최소값이 Integer.MAX_VALUE - 1 으로 설정됩니다.

정의:: 인터페이스 Adjustable 내의 setMinimum

파라미터:: newMinimum - 이 스크롤 바의 새로운 최소값
도입된 버전 :: JDK1. 1
관련 항목:: setValues(int, int, int, int), setMaximum(int)

getMaximum

public int getMaximum()

이 스크롤 바의 최대값을 리턴합니다.

정의:: 인터페이스 Adjustable 내의 getMaximum

반환값:: 이 스크롤 바의 최대값
관련 항목:: getValue(), getMinimum()

setMaximum

public void setMaximum(int newMaximum)

이 스크롤 바의 최대값을 설정합니다.

setMaximum를 호출해, 최대값을 변경하면, 그 외의 값 (최소값, 가시량 및 현재의 스크롤 바의 값)이 새로운 최대값에 맞추어 변경됩니다.

보통, 프로그램은 setValues를 호출하는 것에 해서만, 스크롤 바의 최대값을 변경합니다. setValues 메서드는 스크롤 바의 최소값, 최대값, 가시량 및 값프로퍼티를, 서로 모순되지 않게 동시에 동기적으로 설정합니다.

최대값을 Integer.MIN_VALUE로 설정하면, 새로운 최대값이 Integer.MIN_VALUE + 1 으로 설정됩니다.

정의:: 인터페이스 Adjustable 내의 setMaximum

파라미터:: newMaximum - 이 스크롤 바의 새로운 최대값
도입된 버전 :: JDK1. 1
관련 항목:: setValues(int, int, int, int), setMinimum(int)

getVisibleAmount

public int getVisibleAmount()

이 스크롤 바의 가시량을 리턴합니다.

값의 범위의 선택에 스크롤 바를 사용하는 경우, 가시량을 사용해, 현재 가시의 값의 범위를 나타냅니다. 보통, 스크롤 바의 버블 (샘 또는 스크롤 박스라고도 말한다)의 사이즈에의해 스크롤 바의 범위와 가시량의 관계를 시각적으로 표현합니다.

스크롤 바의 버블이 이동 불가능한 경우 (예를 들어 버블이 스크롤 바의 트럭의 전체의 길이를 차지하는 경우나 스크롤 바가 무효로 되고 있는 경우), 버블이 표시되지 않는 것이 있습니다. 버블이 표시되고 있을지 어떨지는 getVisibleAmount에 의해 리턴된 값에 관계 없습니다.

정의:: 인터페이스 Adjustable 내의 getVisibleAmount

반환값:: 이 스크롤 바의 가시량
도입된 버전 :: JDK1. 1
관련 항목:: setVisibleAmount(int)

getVisible

@Deprecated 
public int getVisible()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getVisibleAmount()를 사용합니다.

setVisibleAmount

public void setVisibleAmount(int newAmount)

이 스크롤 바의 가시량을 설정합니다.

지정된 가시량이 one 보다 작은 경우, 또는 현재의 maximum - minimum값보다 큰 경우는 one 또는 maximum - minimum가 적절한 값으로 옮겨집니다.

정의:: 인터페이스 Adjustable 내의 setVisibleAmount

파라미터:: newAmount - 새로운 가시량
도입된 버전 :: JDK1. 1
관련 항목:: getVisibleAmount(), setValues(int, int, int, int)

setUnitIncrement

public void setUnitIncrement(int v)

이 스크롤 바의 「유니트」증분치를 설정합니다.

유니트 증분치는 사용자가 스크롤 바의 유니트 증분치 영역을 액티브화했을 때에 가산 또는 감산되는 값입니다. 이것은 보통, 스크롤 바가 조정 이벤트로서 받는 마우스 제스추어 또는 키보드 제스추어를 통해서 행해집니다. 유니트 증분치는 제로보다 크지 않으면 안됩니다. 유니트 증분치를 1 보다 작은 값으로 설정하려고 하면, 값 1 이 설정됩니다.

정의:: 인터페이스 Adjustable 내의 setUnitIncrement

파라미터:: v - 스크롤 바의 값을 증분 또는 감 분 하는 양
도입된 버전 :: JDK1. 1
관련 항목:: getUnitIncrement()

setLineIncrement

@Deprecated 
public void setLineIncrement(int v)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setUnitIncrement(int)를 사용합니다.

getUnitIncrement

public int getUnitIncrement()

이 스크롤 바의 「유니트」증분치를 리턴합니다.

유니트 증분치는 사용자가 스크롤 바의 유니트 증분치 영역을 액티브화했을 때에 가산 또는 감산되는 값입니다. 이것은 보통, 스크롤 바가 조정 이벤트로서 받는 마우스 제스추어 또는 키보드 제스추어를 통해서 행해집니다. 유니트 증분치는 제로보다 크지 않으면 안됩니다.

정의:: 인터페이스 Adjustable 내의 getUnitIncrement

반환값:: 이 스크롤 바의 「유니트」증분치
도입된 버전 :: JDK1. 1
관련 항목:: setUnitIncrement(int)

getLineIncrement

@Deprecated 
public int getLineIncrement()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getUnitIncrement()를 사용합니다.

setBlockIncrement

public void setBlockIncrement(int v)

이 스크롤 바의 「블록」증분치를 설정합니다.

블록 증분치는 사용자가 스크롤 바의 블록 증분치 영역을 액티브화했을 때에 가산 또는 감산되는 값입니다. 이것은 보통, 스크롤 바가 조정 이벤트로서 받는 마우스 제스추어 또는 키보드 제스추어를 통해서 행해집니다. 블록 증분치는 제로보다 크지 않으면 안됩니다. 블록 증분치를 1 보다 작은 값으로 설정하려고 하면, 값 1 이 설정됩니다.

정의:: 인터페이스 Adjustable 내의 setBlockIncrement

파라미터:: v - 스크롤 바의 값을 증분 또는 감 분 하는 양
도입된 버전 :: JDK1. 1
관련 항목:: getBlockIncrement()

setPageIncrement

@Deprecated 
public void setPageIncrement(int v)

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 setBlockIncrement()를 사용합니다.

getBlockIncrement

public int getBlockIncrement()

이 스크롤 바의 「블록」증분치를 리턴합니다.

블록 증분치는 사용자가 스크롤 바의 블록 증분치 영역을 액티브화했을 때에 가산 또는 감산되는 값입니다. 이것은 보통, 스크롤 바가 조정 이벤트로서 받는 마우스 제스추어 또는 키보드 제스추어를 통해서 행해집니다. 블록 증분치는 제로보다 크지 않으면 안됩니다.

정의:: 인터페이스 Adjustable 내의 getBlockIncrement

반환값:: 이 스크롤 바의 「블록」증분치
도입된 버전 :: JDK1. 1
관련 항목:: setBlockIncrement(int)

getPageIncrement

@Deprecated 
public int getPageIncrement()

추천하지 않습니다. JDK 버전 1.1 그 뒤로는 getBlockIncrement()를 사용합니다.

setValues

public void setValues(int value,
                      int visible,
                      int minimum,
                      int maximum)

이 스크롤 바의 다음의 4개의 프로퍼티의 값을 설정합니다. value, visibleAmount, minimum 및 maximum 입니다. 이러한 프로퍼티로 설정된 값이 정합성이 없는가 또는 부정한 경우는 정합성을 확보하도록 변경됩니다.

이 메서드는 동시 또한 동기적으로 이것들 4개의 스크롤 바의 프로퍼티의 값을 설정해, 이러한 프로퍼티의 값이 서로 정합하도록 합니다. 이것에는 다음의 제약을 적용할 필요가 있습니다. 이 제약에서는 maximum는 minimum 보다 크고, maximum - minimum는 Integer.MAX_VALUE 보다 크고, visibleAmount는 제로보다 크고, visibleAmount는 maximum - minimum 보다 크지 않고, value는 minimum 보다 작지 않고, value는 maximum - visibleAmount 보다 크지 않은 것이 요구됩니다.

이 메서드를 호출해도 AdjustmentEvent는 트리거 하지 않습니다.

파라미터:: value - 현재의 윈도우내의 위치; visible - 스크롤 바의 가시량; minimum - 스크롤 바의 최소값; maximum - 스크롤 바의 최대값
관련 항목:: setMinimum(int), setMaximum(int), setVisibleAmount(int), setValue(int)

getValueIsAdjusting

public boolean getValueIsAdjusting()

사용자가 액션을 취득중이기 위해서 값의 변경이 진행되고 있는 경우에 true를 리턴합니다.

반환값:: valueIsAdjusting 프로퍼티의 값
도입된 버전 :: 1.4
관련 항목:: setValueIsAdjusting(boolean)

setValueIsAdjusting

public void setValueIsAdjusting(boolean b)

valueIsAdjusting 프로퍼티를 설정합니다.

파라미터:: b - 조정이 진행중의 새로운 상태
도입된 버전 :: 1.4
관련 항목:: getValueIsAdjusting()

addAdjustmentListener

public void addAdjustmentListener(AdjustmentListener  l)

이 스크롤 바로부터 AdjustmentEvent 인스턴스를 받기 위해서 지정된 조정 리스너를 추가합니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

정의:: 인터페이스 Adjustable 내의 addAdjustmentListener

파라미터:: l - 조정 리스너
도입된 버전 :: JDK1. 1
관련 항목:: removeAdjustmentListener(java.awt.event.AdjustmentListener), getAdjustmentListeners(), AdjustmentEvent, AdjustmentListener

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener  l)

이 스크롤 바로부터 AdjustmentEvent 인스턴스를 받지 않게, 지정된 조정 리스너를 삭제합니다. l가 null인 경우, 예외가 발생되지 않고 처리도 실행되지 않습니다.

정의:: 인터페이스 Adjustable 내의 removeAdjustmentListener

파라미터:: l - 조정 리스너
도입된 버전 :: JDK1. 1
관련 항목:: addAdjustmentListener(java.awt.event.AdjustmentListener), getAdjustmentListeners(), AdjustmentEvent, AdjustmentListener

getAdjustmentListeners

public AdjustmentListener [] getAdjustmentListeners()

이 스크롤 바에 등록된 모든 조정 리스너의 배열을 리턴합니다.

반환값:: 이 스크롤 바의 모든 AdjustmentListener, 또는 현재 조정 리스너가 등록되지 않은 경우는 비어있는 배열
도입된 버전 :: 1.4
관련 항목:: addAdjustmentListener(java.awt.event.AdjustmentListener), removeAdjustmentListener(java.awt.event.AdjustmentListener), AdjustmentEvent, AdjustmentListener

getListeners

public <T extends EventListener > T[] getListeners(Class <T> listenerType)

이 Scrollbar에 FooListener로 서 현재 등록되어 모든 객체의 배열을 리턴합니다. FooListener는 addFooListener 메서드를 사용해 등록됩니다.

FooListener.class 등의 클래스 리터럴을 가지는 listenerType인수를 지정할 수 있습니다. 예를 들어 다음의 코드를 사용해, 그 마우스 리스너의 Scrollbar c를 조회할 수 있습니다.

MouseListener[] mls = (MouseListener[])(c.getListeners(MouseListener.class));

이러한 리스너가 없는 경우는 비어있는 배열을 리턴합니다.

오버라이드(override):: 클래스 Component 내의 getListeners

파라미터:: listenerType - 요구되는 리스너의 형태. java.util.EventListener 하위 인터페이스를 지정
반환값:: 이 컴퍼넌트에 FooListener로 서 등록되어 모든 객체의 배열. 리스너가 등록되지 않은 경우는 비어있는 배열을 돌려준다
예외:: ClassCastException - listenerType가 java.util.EventListener를 구현하는 클래스 또는 인터페이스를 지정하지 않는 경우
도입된 버전 :: 1.3
관련 항목:: Component.getComponentListeners(), Component.getFocusListeners(), Component.getHierarchyListeners(), Component.getHierarchyBoundsListeners(), Component.getKeyListeners(), Component.getMouseListeners(), Component.getMouseMotionListeners(), Component.getMouseWheelListeners(), Component.getInputMethodListeners(), Component.getPropertyChangeListeners()

processEvent

protected void processEvent(AWTEvent  e)

이 스크롤 바의 이벤트를 처리합니다. 이벤트가 AdjustmentEvent 인스턴스인 경우는 processAdjustmentEvent 메서드를 호출합니다. 그렇지 않은 경우는 슈퍼 클래스의 processEvent 메서드를 호출합니다.

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

오버라이드(override):: 클래스 Component 내의 processEvent

파라미터:: e - 이벤트
도입된 버전 :: JDK1. 1
관련 항목:: AdjustmentEvent, processAdjustmentEvent(java.awt.event.AdjustmentEvent)

processAdjustmentEvent

protected void processAdjustmentEvent(AdjustmentEvent  e)

이 스크롤 바로 발생하는 조정 이벤트를, 등록되어 있는 AdjustmentListener 객체에 디스패치 하는 것으로써, 조정 이벤트를 처리합니다.

이 컴퍼넌트에 대해서 조정 이벤트가 사용 가능하지 않은 한, 이 메서드는 불려가 지 않습니다. 조정 이벤트는 다음의 어느 쪽인가의 경우에 사용 가능하게 됩니다.

AdjustmentListener 객체가 addAdjustmentListener에 의해 등록되어 있다
enableEvents에 의해 조정 이벤트가 사용 가능하게 되어 있다

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

파라미터:: e - 조정 이벤트
도입된 버전 :: JDK1. 1
관련 항목:: AdjustmentEvent, AdjustmentListener, addAdjustmentListener(java.awt.event.AdjustmentListener), Component.enableEvents(long)

paramString

protected String  paramString()

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

오버라이드(override):: 클래스 Component 내의 paramString

반환값:: 이 스크롤 바의 파라미터 캐릭터 라인

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 Scrollbar에 관련된 AccessibleContext를 리턴합니다. 스크롤 바의 경우, AccessibleContext는 AccessibleAWTScrollBar 형식을 취합니다. 필요에 따라서, 새로운 AccessibleAWTScrollBar인스턴스가 작성됩니다.

정의:: 인터페이스 Accessible 내의 getAccessibleContext
오버라이드(override):: 클래스 Component 내의 getAccessibleContext

반환값:: 이 ScrollBar AccessibleContext로 서 기능하는 AccessibleAWTScrollBar

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt 클래스 Scrollbar

HORIZONTAL

VERTICAL

Scrollbar

Scrollbar

Scrollbar

addNotify

getOrientation

setOrientation

getValue

setValue

getMinimum

setMinimum

getMaximum

setMaximum

getVisibleAmount

getVisible

setVisibleAmount

setUnitIncrement

setLineIncrement

getUnitIncrement

getLineIncrement

setBlockIncrement

setPageIncrement

getBlockIncrement

getPageIncrement

setValues

getValueIsAdjusting

setValueIsAdjusting

addAdjustmentListener

removeAdjustmentListener

getAdjustmentListeners

getListeners

processEvent

processAdjustmentEvent

paramString

getAccessibleContext

java.awt
클래스 Scrollbar