Scrollbar (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요 : 상자 | 필드 | 생성자 | 메소드

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

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);

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

<img src=

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

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

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

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

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

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

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

AdjustmentEvent.TRACK. 이 조정 이벤트는, 사용자가 스크롤 바의 버블을 드래그 했을 때에 송출된다
AdjustmentEvent.UNIT_INCREMENT. 이 조정 이벤트는, 사용자가 수평 스크롤 바의 왼쪽 화살표 또는 수직 스크롤 바 상 화살표를 클릭하는지, 키보드로부터 거기에 상당하는 제스처(gesture)를 행했을 때에 송출된다
AdjustmentEvent.UNIT_DECREMENT. 이 조정 이벤트는, 사용자가 수평 스크롤 바의 오른쪽 화살표 또는 수직 스크롤 바하 화살표를 클릭하는지, 키보드로부터 거기에 상당하는 제스처(gesture)를 행했을 때에 송출된다
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 , 직렬화 된 형식

상자의 클래스의 개요
`protected class`	`Scrollbar.AccessibleAWTScrollBar` 이 클래스는 `Scrollbar` 클래스용의 접근성?의 지원를 구현하고 있습니다.

클래스 java.awt. Component 로부터 상속된 상자의 클래스/인터페이스
`Component.AccessibleAWTComponent , Component.BaselineResizeBehavior , 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 version 1.1 이후는, getUnitIncrement() 로 옮겨졌습니다.





<T extends EventListener > 


T[]

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

int getMaximum ()
이 스크롤 바의 최대치를 돌려줍니다.

int getMinimum ()
이 스크롤 바의 최소치를 돌려줍니다.

int getOrientation ()
이 스크롤 바의 방향을 돌려줍니다.

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

int getUnitIncrement ()
이 스크롤 바의 「유니트」증분치를 돌려줍니다.

int getValue ()
이 스크롤 바의 현재가를 돌려줍니다.

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

int getVisible ()
추천 되고 있지 않습니다. JDK version 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 version 1.1 이후는, setUnitIncrement(int) 로 옮겨졌습니다.

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

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

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

void setPageIncrement (int v)
추천 되고 있지 않습니다. JDK version 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 , getBaseline , getBaselineResizeBehavior , 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 , getBaseline , getBaselineResizeBehavior , 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 version 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)

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

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

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

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

setLineIncrement

@Deprecated 
public void setLineIncrement(int v)

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

getUnitIncrement

public int getUnitIncrement()

이 스크롤 바의 「유니트」증분치를 돌려줍니다.

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

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

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

getLineIncrement

@Deprecated 
public int getLineIncrement()

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

setBlockIncrement

public void setBlockIncrement(int v)

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

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

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

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

setPageIncrement

@Deprecated 
public void setPageIncrement(int v)

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

getBlockIncrement

public int getBlockIncrement()

이 스크롤 바의 「블록」증분치를 돌려줍니다.

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

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

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

getPageIncrement

@Deprecated 
public int getPageIncrement()

추천 되고 있지 않습니다. JDK version 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 의 경우, 예외는 throw 되지 않고, 처리도 실행되지 않습니다. 　

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

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

파라미터:: l - 조정 청취자
도입된 버젼:: JDK1. 1
관련 항목:: removeAdjustmentListener(java.awt.event.AdjustmentListener) , getAdjustmentListeners() , AdjustmentEvent , AdjustmentListener

removeAdjustmentListener

public void removeAdjustmentListener(AdjustmentListener  l)

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

AWT thread 모델의 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

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

파라미터:: l - 조정 청취자
도입된 버젼:: JDK1. 1
관련 항목:: addAdjustmentListener(java.awt.event.AdjustmentListener) , getAdjustmentListeners() , AdjustmentEvent , AdjustmentListener

getAdjustmentListeners

public AdjustmentListener [] getAdjustmentListeners()

이 스크롤 바에 등록된 모든 조정 청취자의 배열을 돌려줍니다.

반환값:: 이 스크롤 바의 모든 AdjustmentListener, 또는 현재 조정 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열
도입된 버젼:: 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));

이러한 청취자가 없는 경우는 빈 상태(empty)의 배열을 돌려줍니다.

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

파라미터:: listenerType - 요구되는 청취자의 형태. java.util.EventListener 의 하위 인터페이스를 지정
반환값:: 이 컴퍼넌트에 FooListener 로서 등록되어 모든 객체의 배열. 그러한 청취자가 추가되어 있지 않은 경우는 빈 상태(empty)의 배열
예외:: 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 의 경우의 동작은 정의되어 있지 않기 때문에 예외가 throw 됩니다.

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

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

processAdjustmentEvent

protected void processAdjustmentEvent(AdjustmentEvent  e)

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

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

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

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

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

paramString

protected String  paramString()

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

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

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

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 Scrollbar 에 관련지을 수 있었던 AccessibleContext 를 돌려줍니다. 스크롤 바의 경우,AccessibleContext 는 AccessibleAWTScrollBar 의 형식을 취합니다. 필요에 따라서, 새로운 AccessibleAWTScrollBar 인스턴스가 작성됩니다.

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

반환값:: 이 ScrollBar 의 AccessibleContext 로서 기능한다 AccessibleAWTScrollBar
도입된 버젼:: 1.3

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요 : 상자 | 필드 | 생성자 | 메소드

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

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

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