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

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM 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

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

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

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

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

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

>      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.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

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

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

  이 생성자 으로 지정되는 파라미터는 `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)

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

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

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

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

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

  정의:
    인터페이스 `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 | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요 : 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.