java.awt
클래스 Scrollbar

java.lang.Object 
  |
  +--java.awt.Component 
        |
        +--java.awt.Scrollbar

모든 구현 인터페이스:

Accessible , Adjustable , ImageObserver , MenuContainer , Serializable

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 를 뺀 값입니다. 상기의 예에서는 maximum 가 300 으로,visible 가 60 이므로, 실제의 최대치는 240 입니다. 스크롤 바의 트럭의 범위는 0 ~ 300 입니다. 버블의 좌단은 스크롤 바의 값을 나타냅니다.

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

유저가 스크롤 바의 값을 변경하면(자), 스크롤 바는 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 대신에 사용된다

도입된 버젼:

JDK1. 0

관련 항목:

AdjustmentEvent , AdjustmentListener , 직렬화 된 형식

중첩된 클래스의 개요

protected class

Scrollbar.AccessibleAWTScrollBar 이 클래스는 Scrollbar 클래스용의 유저 보조 기능의 서포트를 구현하고 있습니다.

클래스 java.awt. Component 을 상속받은 중첩된 클래스

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() 를 사용
EventListener []	getListeners (Class 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 , 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 , 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 , isOpaque , 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 , setName , 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
minimum	스크롤 바의 최소치	0
maximum	스크롤 바의 최대치	100
unit increment	Page Up 키 또는 Page 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 의 어느 쪽인지 나오지 않으면 안됩니다.

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

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

예외:

IllegalArgumentException - orientation 로 지정된 값이 부정한 값인 경우

도입된 버젼:

JDK1. 1

관련 항목:

getOrientation()

getValue

public int getValue()

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

정의:

인터페이스 Adjustable 내의 getValue

반환값:

이 스크롤 바의 현재의 값

관련 항목:

getMinimum() , getMaximum()

setValue

public void setValue(int newValue)

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

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

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

정의:

인터페이스 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 메소드는 스크롤 바의 최소치, 최대치, 가시량, 및 값프로퍼티를, 서로 모순되지 않게 동시에, 동기적으로 설정합니다.

정의:

인터페이스 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 메소드는 스크롤 바의 최소치, 최대치, 가시량, 및 값프로퍼티를, 서로 모순되지 않게 동시에, 동기적으로 설정합니다.

정의:

인터페이스 Adjustable 내의 setMaximum

파라미터:

newMaximum - 이 스크롤 바의 새로운 최대치

도입된 버젼:

JDK1. 1

관련 항목:

setValues(int, int, int, int) , setMinimum(int)

getVisibleAmount

public int getVisibleAmount()

이 스크롤 바의 가시량을 돌려줍니다.

스크롤 바의 가시량은 스크롤 바의 버블의 폭에 의해 나타내지는 값의 범위입니다.

정의:

인터페이스 Adjustable 내의 getVisibleAmount

반환값:

이 스크롤 바의 가시량

도입된 버젼:

JDK1. 1

관련 항목:

setVisibleAmount(int)

getVisible

public int getVisible()

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getVisibleAmount() 를 사용

setVisibleAmount

public void setVisibleAmount(int newAmount)

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

스크롤 바의 가시량은 스크롤 바의 버블의 폭에 의해 나타내지는 값의 범위입니다.

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

정의:

인터페이스 Adjustable 내의 setVisibleAmount

파라미터:

newAmount - 1 페이지 근처의 표시량

도입된 버젼:

JDK1. 1

관련 항목:

getVisibleAmount() , setValues(int, int, int, int)

setUnitIncrement

public void setUnitIncrement(int v)

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

「유니트」증분치는 유저가 스크롤 바의 「유니트」증분치 area를 액티브화했을 때에 가산 또는 감산되는 값입니다. 이것은 통상, 스크롤 바가 조정 이벤트로서 받는 마우스 제스추어 또는 키보드 제스추어를 통해서 행해집니다.

정의:

인터페이스 Adjustable 내의 setUnitIncrement

파라미터:

v - 스크롤 바의 값을 증분 또는 감 분 하는 양

도입된 버젼:

JDK1. 1

관련 항목:

getUnitIncrement()

setLineIncrement

public void setLineIncrement(int v)

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setUnitIncrement(int) 를 사용

getUnitIncrement

public int getUnitIncrement()

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

「유니트」증분치는 유저가 스크롤 바의 「유니트」증분치 area를 액티브화했을 때에 가산 또는 감산되는 값입니다. 이것은 통상, 스크롤 바가 조정 이벤트로서 받는 마우스 제스추어 또는 키보드 제스추어를 통해서 행해집니다.

정의:

인터페이스 Adjustable 내의 getUnitIncrement

반환값:

이 스크롤 바의 「유니트」증분치

도입된 버젼:

JDK1. 1

관련 항목:

setUnitIncrement(int)

getLineIncrement

public int getLineIncrement()

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 getUnitIncrement() 를 사용

setBlockIncrement

public void setBlockIncrement(int v)

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

「블록」증분치는 유저가 스크롤 바의 「블록」증분치 area를 액티브화했을 때에 가산 또는 감산되는 값입니다. 이것은 통상, 스크롤 바가 조정 이벤트로서 받는 마우스 제스추어 또는 키보드 제스추어를 통해서 행해집니다.

정의:

인터페이스 Adjustable 내의 setBlockIncrement

파라미터:

v - 스크롤 바의 값을 증분 또는 감 분 하는 양

도입된 버젼:

JDK1. 1

관련 항목:

getBlockIncrement()

setPageIncrement

public void setPageIncrement(int v)

추천 되고 있지 않습니다. JDK 버젼 1.1 이후는 setBlockIncrement() 를 사용

getBlockIncrement

public int getBlockIncrement()

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

「블록」증분치는 유저가 스크롤 바의 「블록」증분치 area를 액티브화했을 때에 가산 또는 감산되는 값입니다. 이것은 통상, 스크롤 바가 조정 이벤트로서 받는 마우스 제스추어 또는 키보드 제스추어를 통해서 행해집니다.

정의:

인터페이스 Adjustable 내의 getBlockIncrement

반환값:

이 스크롤 바의 「블록」증분치

도입된 버젼:

JDK1. 1

관련 항목:

setBlockIncrement(int)

getPageIncrement

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 보다 크고,visibleAmount 는 정의 값,visibleAmount 는 minimum 의 maximum 보다 크지 않고 value 는 minimum 보다 작지 않고 value 는 visibleAmount 의 maximum 보다 크지 않은 것이 요구됩니다.

파라미터:

value - 현재의 윈도우내의 위치

visible - 1 페이지 근처의 표시량

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 EventListener [] getListeners(Class  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