java.awt.event
클래스 MouseWheelEvent

java.lang.Object 
  java.util.EventObject 
      java.awt.AWTEvent 
          java.awt.event.ComponentEvent 
              java.awt.event.InputEvent 
                  java.awt.event.MouseEvent 
                      java.awt.event.MouseWheelEvent

모든 구현된 인터페이스:

Serializable

public class MouseWheelEvent
extends MouseEvent 

컴퍼넌트내에서 마우스 휠이 회전한 것을 나타내는 이벤트입니다.

휠 마우스는, 중앙의 버튼 대신에 휠을 사용하는 마우스입니다. 휠은 사용자의 방향 또는 그 반대 방향으로 회전시킬 수가 있습니다. 마우스 휠은 (다른 사용 방법도 있습니다만) 주로 스크롤 하기 위해서 사용됩니다.

MouseWheelEvent 객체는, 컴퍼넌트의 addMouseWheelListener 메소드를 사용해 「관련한다」마우스 이벤트를 받도록(듯이) 등록되어 모든 MouseWheelListener 객체에게 건네집니다. 각 청취자 객체는, 마우스 이벤트를 포함한 MouseEvent 를 가져옵니다.

마우스 휠이 특히 스크롤 Component 와 관련하기 위해(때문에), MouseWheelEvents 는 다른 MouseEvents 와는 다소 다른 형태로 송신됩니다. 이것은, 일반적으로 MouseEvents 가 마우스 커서의 바로 아래에 있는 Component 의 변경에 영향을 주는 (예를 들어, 버튼을 클릭했을 경우) 것에 대해, MouseWheelEvents 는 마우스 커서의 영향을 받지 않는 기능이 것에 의합니다 (ScrollPane 내의 Component 상에 있는 휠의 이동은 ScrollPane 의 스크롤 바의 1 개를 스크롤 합니다).

MouseWheelEvents 는 마우스 커서아래에 있는 Component 로부터 이벤트의 송신을 개시합니다. 이 Component 로 MouseWheelEvents 가 유효하지 않은 경우, 이벤트는 유효한 MouseWheelEvents 를 가지는 최초의 상위 Container 에 송신됩니다. 일반적으로, 이것은 휠 스크롤이 유효한 ScrollPane 입니다. 발생원 Component 및 x, y 축은, 이벤트의 최종 송신지 (ScrollPane)에 관련합니다. 이것에 의해, ScrollPane 를 변경하지 않고 복잡한 GUI 를 인스톨 해, 모든 MouseWheelEvents 를 ScrollPane 에 송신해 스크롤 할 수 있게 됩니다.

일부의 AWT Component 는, 독자적인 스크롤 바를 가져, 독자적인 스크롤 조작을 실시하는 네이티브위젯를 사용해 구현됩니다. 이것이 true 인 특정의 Component 는, 플랫폼 마다 다릅니다. 마우스 휠이 이러한 Component 의 몇개의 위를 이동하면(자), 이벤트는 직접 네이티브위젯에 송신되어 상위 Component 에는 송신되지 않습니다.

플랫폼은, 마우스 휠의 이동시에 발생하는 스크롤의 양을 커스터마이즈 하는 기능을 제공합니다. 무엇보다 일반적인 2 개의 설정은, 특정의 「유니트」의 수 (일반적으로은, 텍스트 베이스의 컴퍼넌트에 있어서의 텍스트행), 또는 「블록」전체 (페이지 업이나 페이지 다운에 유사한다)의 스크롤입니다. MouseWheelEvent 는, 배후에 있는 플랫폼의 설정에 준거하기 위한 메소드를 제공합니다. 사용자는, 이러한 플랫폼의 설정을 언제라도 변경할 수 있습니다. MouseWheelEvents 는 최신의 설정을 반영합니다.

도입된 버젼:

1.4

관련 항목:

MouseWheelListener , ScrollPane , ScrollPane.setWheelScrollingEnabled(boolean) , JScrollPane , JScrollPane.setWheelScrollingEnabled(boolean) , 직렬화 된 형식

필드의 개요

static int	WHEEL_BLOCK_SCROLL 「블록」에 의한 스크롤 (Page Up 키, Page Down 키에 의한 스크롤등)을 나타내는 정수입니다.
static int	WHEEL_UNIT_SCROLL 「유니트」에 의한 스크롤 (커서 키에 의한 스크롤등)을 나타내는 정수입니다.

클래스 java.awt.event. MouseEvent 로부터 상속된 필드

BUTTON1 , BUTTON2 , BUTTON3 , MOUSE_CLICKED , MOUSE_DRAGGED , MOUSE_ENTERED , MOUSE_EXITED , MOUSE_FIRST , MOUSE_LAST , MOUSE_MOVED , MOUSE_PRESSED , MOUSE_RELEASED , MOUSE_WHEEL , NOBUTTON

클래스 java.awt.event. InputEvent 로부터 상속된 필드

ALT_DOWN_MASK , ALT_GRAPH_DOWN_MASK , ALT_GRAPH_MASK , ALT_MASK , BUTTON1_DOWN_MASK , BUTTON1_MASK , BUTTON2_DOWN_MASK , BUTTON2_MASK , BUTTON3_DOWN_MASK , BUTTON3_MASK , CTRL_DOWN_MASK , CTRL_MASK , META_DOWN_MASK , META_MASK , SHIFT_DOWN_MASK , SHIFT_MASK

클래스 java.awt.event. ComponentEvent 로부터 상속된 필드

COMPONENT_FIRST , COMPONENT_HIDDEN , COMPONENT_LAST , COMPONENT_MOVED , COMPONENT_RESIZED , COMPONENT_SHOWN

클래스 java.awt. AWTEvent 로부터 상속된 필드

ACTION_EVENT_MASK , ADJUSTMENT_EVENT_MASK , COMPONENT_EVENT_MASK , consumed , CONTAINER_EVENT_MASK , FOCUS_EVENT_MASK , HIERARCHY_BOUNDS_EVENT_MASK , HIERARCHY_EVENT_MASK , id , INPUT_METHOD_EVENT_MASK , INVOCATION_EVENT_MASK , ITEM_EVENT_MASK , KEY_EVENT_MASK , MOUSE_EVENT_MASK , MOUSE_MOTION_EVENT_MASK , MOUSE_WHEEL_EVENT_MASK , PAINT_EVENT_MASK , RESERVED_ID_MAX , TEXT_EVENT_MASK , WINDOW_EVENT_MASK , WINDOW_FOCUS_EVENT_MASK , WINDOW_STATE_EVENT_MASK

클래스 java.util. EventObject 로부터 상속된 필드

source

생성자 의 개요

MouseWheelEvent (Component source, int id, long when, int modifiers, int x, int y, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation)
지정된 발생원의 컴퍼넌트, 형태, 수식자, 좌표, 스크롤의 타입, 스크롤의 양, 및 휠 회전으로,MouseWheelEvent 객체를 구축합니다.

MouseWheelEvent (Component source, int id, long when, int modifiers, int x, int y, int xAbs, int yAbs, int clickCount, boolean popupTrigger, int scrollType, int scrollAmount, int wheelRotation)
지정된 발생원의 컴퍼넌트, 형태, 수식자, 좌표, 절대 좌표, 스크롤의 타입, 스크롤의 양, 및 휠 회전으로,MouseWheelEvent 객체를 구축합니다.

메소드의 개요

int	getScrollAmount () 마우스 휠의 회전 클릭 마다 스크롤 되는 유니트수를 돌려줍니다.
int	getScrollType () 이 이벤트에 응답해 발생하는 스크롤의 타입을 돌려줍니다.
int	getUnitsToScroll () 플랫폼의 설정에 적합하는 범위에서, ScrollPane 또는 JScrollPane 를 스크롤 할 때에 사용하는 일반적인 MouseWheelListener 의 구현에 도움이 되는 편리한 메소드입니다.
int	getWheelRotation () 마우스 휠을 회전시킨 「클릭」수를 돌려줍니다.
String	paramString () 이 이벤트를 특정하는 파라미터의 캐릭터 라인을 돌려줍니다.

클래스 java.awt.event. MouseEvent 로부터 상속된 메소드

getButton , getClickCount , getLocationOnScreen , getMouseModifiersText , getPoint , getX , getXOnScreen , getY , getYOnScreen , isPopupTrigger , translatePoint

클래스 java.awt.event. InputEvent 로부터 상속된 메소드

consume , getModifiers , getModifiersEx , getModifiersExText , getWhen , isAltDown , isAltGraphDown , isConsumed , isControlDown , isMetaDown , isShiftDown

클래스 java.awt.event. ComponentEvent 로부터 상속된 메소드

getComponent

클래스 java.awt. AWTEvent 로부터 상속된 메소드

getID , setSource , toString

클래스 java.util. EventObject 로부터 상속된 메소드

getSource

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

필드의 상세

WHEEL_UNIT_SCROLL

public static final int WHEEL_UNIT_SCROLL

「유니트」에 의한 스크롤 (커서 키에 의한 스크롤등)을 나타내는 정수입니다.

관련 항목:

getScrollType() , 정수 필드치

WHEEL_BLOCK_SCROLL

public static final int WHEEL_BLOCK_SCROLL

「블록」에 의한 스크롤 (Page Up 키, Page Down 키에 의한 스크롤등)을 나타내는 정수입니다.

관련 항목:

getScrollType() , 정수 필드치

생성자 의 상세

MouseWheelEvent

public MouseWheelEvent(Component  source,
                       int id,
                       long when,
                       int modifiers,
                       int x,
                       int y,
                       int clickCount,
                       boolean popupTrigger,
                       int scrollType,
                       int scrollAmount,
                       int wheelRotation)

지정된 발생원의 컴퍼넌트, 형태, 수식자, 좌표, 스크롤의 타입, 스크롤의 양, 및 휠 회전으로,MouseWheelEvent 객체를 구축합니다. 　

절대 좌표 xAbs 와 yAbs 는, 화면상의 발생원컴퍼넌트의 위치에 상대 좌표 x 와 y 를 가산한 값으로 설정됩니다. 발생원컴퍼넌트가 표시되어 있지 않은 경우, xAbs 와 yAbs 는 0 으로 설정됩니다. 　

무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 source 가 null 의 경우에 IllegalArgumentException 를 throw 합니다.

파라미터:

source - 이벤트의 발생원의 Component

id - 이벤트를 특정하는 정수

when - 이벤트의 발생시각을 지정하는 long 치

modifiers - 이벤트 발생시에 밀린 수식 키 (Shift, Ctrl, Alt, 메타 등)

x - 마우스 위치의 X 좌표 (수평 방향)

y - 마우스 위치의 Y 좌표 (수직 방향)

clickCount - 이벤트에 관련한 마우스 클릭의 회수

popupTrigger - boolean 형. pop-up menu에 대한 이벤트의 경우는 true

scrollType - 이 이벤트에 응답해 발생하는 스크롤의 타입. 유효한 값은 WHEEL_UNIT_SCROLL 및 WHEEL_BLOCK_SCROLL

scrollAmount - scrollType 가 WHEEL_UNIT_SCROLL 의 경우, 스크롤 되는 유니트수

wheelRotation - 마우스 휠이 회전한 총수 ( 「클릭」수)

예외:

IllegalArgumentException - source 가 null 의 경우

관련 항목:

MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean) , MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)

MouseWheelEvent

public MouseWheelEvent(Component  source,
                       int id,
                       long when,
                       int modifiers,
                       int x,
                       int y,
                       int xAbs,
                       int yAbs,
                       int clickCount,
                       boolean popupTrigger,
                       int scrollType,
                       int scrollAmount,
                       int wheelRotation)

지정된 발생원의 컴퍼넌트, 형태, 수식자, 좌표, 절대 좌표, 스크롤의 타입, 스크롤의 양, 및 휠 회전으로,MouseWheelEvent 객체를 구축합니다. 　

무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 source 가 null 의 경우에 IllegalArgumentException 를 throw 합니다.

생성자 에게 건네진 상대 좌표와 절대 좌표의 값이 모순되고 있는 경우에서도 MouseWheelEvent 인스턴스는 작성되어 예외는 throw 되지 않습니다.

파라미터:

source - 이벤트의 발생원의 Component

id - 이벤트를 특정하는 정수

when - 이벤트의 발생시각을 지정하는 long 치

modifiers - 이벤트 발생시에 밀린 수식 키 (Shift, Ctrl, Alt, 메타 등)

x - 마우스 위치의 X 좌표 (수평 방향)

y - 마우스 위치의 Y 좌표 (수직 방향)

xAbs - 마우스 위치의 절대 X 좌표 (수평 방향)

yAbs - 마우스 위치의 절대 Y 좌표 (수직 방향)

clickCount - 이벤트에 관련한 마우스 클릭의 회수

popupTrigger - boolean 형. pop-up menu에 대한 이벤트의 경우는 true

scrollType - 이 이벤트에 응답해 발생하는 스크롤의 타입. 유효한 값은 WHEEL_UNIT_SCROLL 및 WHEEL_BLOCK_SCROLL

scrollAmount - scrollType 가 WHEEL_UNIT_SCROLL 의 경우, 스크롤 되는 유니트수

wheelRotation - 마우스 휠이 회전한 총수 ( 「클릭」수)

예외:

IllegalArgumentException - source 가 null 의 경우

도입된 버젼:

1.6

관련 항목:

MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, boolean) , MouseEvent.MouseEvent(java.awt.Component, int, long, int, int, int, int, int, int, boolean, int)

메소드의 상세

getScrollType

public int getScrollType()

이 이벤트에 응답해 발생하는 스크롤의 타입을 돌려줍니다. 이것은 네이티브 플랫폼에 의해 정해집니다. 다음에 유효한 값을 나타냅니다.

• MouseWheelEvent.WHEEL_UNIT_SCROLL
• MouseWheelEvent.WHEEL_BLOCK_SCROLL

반환값:

네이티브 플랫폼의 구성에 의해, MouseWheelEvent.WHEEL_UNIT_SCROLL 또는 MouseWheelEvent.WHEEL_BLOCK_SCROLL 의 어느쪽이든

관련 항목:

Adjustable.getUnitIncrement() , Adjustable.getBlockIncrement() , Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int) , Scrollable.getScrollableBlockIncrement(java.awt.Rectangle, int, int)

getScrollAmount

public int getScrollAmount()

마우스 휠의 회전 클릭 마다 스크롤 되는 유니트수를 돌려줍니다. getScrollType 가 MouseWheelEvent.WHEEL_UNIT_SCROLL 를 돌려주는 경우에게만 유효합니다.

반환값:

스크롤 하는 유니트수, 또는 미정도리의 값 (getScrollType 가 MouseWheelEvent.WHEEL_BLOCK_SCROLL 를 돌려주는 경우)

관련 항목:

getScrollType()

getWheelRotation

public int getWheelRotation()

마우스 휠을 회전시킨 「클릭」수를 돌려줍니다.

반환값:

마우스 휠이 위쪽 또는 사용자로부터 봐 반대 방향으로 회전했을 경우는 0 보다 작은 값, 마우스 휠이 아래 쪽 또는 사용자 방향으로 회전했을 경우는 정의 값

getUnitsToScroll

public int getUnitsToScroll()

플랫폼의 설정에 적합하는 범위에서, ScrollPane 또는 JScrollPane 를 스크롤 할 때에 사용하는 일반적인 MouseWheelListener 의 구현에 도움이 되는 편리한 메소드입니다. 다만,ScrollPane 및 JScrollPane 에는, 벌써 이 기능이 짜넣어지고 있습니다.

이 메소드는, 스크롤의 타입이 MouseWheelEvent.WHEEL_UNIT_SCROLL 의 경우에 스크롤 하는 유니트수를 돌려줍니다. 이것은,getScrollType 가 MouseWheelEvent.WHEEL_UNIT_SCROLL 를 돌려주는 경우에게만 호출합니다.

스크롤의 방향, 휠의 이동량, 및 휠 스크롤에 관한 플랫폼의 설정이 모두 관계합니다. 이 메소드는 Adjustable 또는 Scrollable 유니트 증분치를 고려하지 않고, 또 고려할 수 없습니다. 이 값은 스크롤 컴퍼넌트에 의해 바뀌기 (위해)때문에입니다.

이 메소드가 청취자로 사용되는 간단한 예를 다음에 나타냅니다.

  mouseWheelMoved(MouseWheelEvent event) {
      ScrollPane sp = getScrollPaneFromSomewhere(); 
      Adjustable adj = sp.getVAdjustable()
      if (MouseWheelEvent.getScrollType() == WHEEL_UNIT_SCROLL) {
          int totalScrollAmount =
              event.getUnitsToScroll() *
              adj.getUnitIncrement();
          adj.setValue(adj.getValue() + totalScrollAmount);
      }
  }
 

반환값:

마우스 휠의 회전의 방향과 양, 및 네이티브 플랫폼의 휠 스크롤 설정에 근거해 스크롤 되는 유니트수

관련 항목:

getScrollType() , getScrollAmount() , MouseWheelListener , Adjustable , Adjustable.getUnitIncrement() , Scrollable , Scrollable.getScrollableUnitIncrement(java.awt.Rectangle, int, int) , ScrollPane , ScrollPane.setWheelScrollingEnabled(boolean) , JScrollPane , JScrollPane.setWheelScrollingEnabled(boolean)

paramString

public String  paramString()

이 이벤트를 특정하는 파라미터의 캐릭터 라인을 돌려줍니다. 이 메소드는, 이벤트 로그의 작성 및 디버그에 사용합니다.

오버라이드(override):

클래스 MouseEvent 내의 paramString

반환값:

이벤트를 특정하는 캐릭터 라인과 그 속성