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 객체를 구축합니다.

메서드 개요

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

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

getButton, getClickCount, getMouseModifiersText, getPoint, getX, getY, 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 객체를 구축합니다.

무효인 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)

메서드의 상세

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

마우스 휠을 회전시킨 「클릭」수를 리턴합니다.

반환값:

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

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

반환값:

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