UIElement.QueryCursor 이벤트

정의

커서를 표시하도록 요청하면 발생합니다.Occurs when the cursor is requested to display. 이 이벤트는 마우스 포인터를 새 위치로 이동할 때마다 요소에서 발생합니다. 즉, 새로운 위치에 따라 커서 개체가 변경되어야 할 수 있습니다.This event is raised on an element each time that the mouse pointer moves to a new location, which means the cursor object might need to be changed based on its new position.

public:
 event System::Windows::Input::QueryCursorEventHandler ^ QueryCursor;
public event System.Windows.Input.QueryCursorEventHandler QueryCursor;
member this.QueryCursor : System.Windows.Input.QueryCursorEventHandler 
Public Custom Event QueryCursor As QueryCursorEventHandler 

설명

이 이벤트는이 클래스에 대해 연결 된 Mouse.QueryCursor 이벤트에 대 한 별칭을 만듭니다. 따라서 UIElement 기본 요소로 상속 될 때 QueryCursor 클래스 멤버 목록의 일부가 됩니다.This event creates an alias for the Mouse.QueryCursor attached event for this class, so that QueryCursor is part of the class members list when UIElement is inherited as a base element. QueryCursor 이벤트에 연결 된 이벤트 처리기는 기본 Mouse.QueryCursor 연결 된 이벤트에 연결 되며 동일한 이벤트 데이터 인스턴스를 수신 합니다.Event handlers that are attached to the QueryCursor event are attached to the underlying Mouse.QueryCursor attached event and receive the same event data instance.

이 이벤트 이름에 의해 참조 되는 커서는 텍스트 커서 (삽입 지점이 라고도 함)가 아닐 수도 있습니다.The cursor being referred to by this event name is not necessarily the text cursor (sometimes known as the insertion point). 대신이 컨텍스트에서 커서에는 여러 가능한 입력 관련 디바이스 또는 Windows 프로그래밍의 개념과 관련 된 화면의 그래픽 표시를 선언 하는 개체입니다.Instead, the cursor in this context is the object that declares the onscreen graphical display related to several possible input-related devices or concepts in Windows programming. 이 개체는 WPF의 Cursor 클래스로 표현 됩니다.That object is represented by the Cursor class in WPF. WPF 입력 시스템을 사용 하면 마우스 포인터의 화면 위치를 나타낼 때이 커서를 변경할 수 있습니다.The WPF input system enables you to change this cursor when it represents the onscreen position of the mouse pointer. Cursors 열거형의 미리 정의 된 값을 사용 하거나 사용자 지정 커서를 이미지 파일로 선언할 수 있습니다.You can use predefined values from the Cursors enumeration, or you can declare a custom cursor as an image file.

QueryCursor 이벤트에 대 한 수신 대기는 커서 관리를 위한 효율적인 기술이 아닙니다.Listening for the QueryCursor event is not an efficient technique for cursor management. 대신 각 요소는 CursorForceCursor를 사용 하 여 고유한 커서 동작을 정의 해야 합니다.Instead, each element should define its own cursor behavior with Cursor and ForceCursor. WPF 프레임 워크 수준 기본 요소를 사용 하지 않는 경우 또는 요소 별로 커서 동작을 정의 하는 것이 요구 사항에 맞지 않는 경우에만 QueryCursor을 사용 해야 합니다.You should only rely on QueryCursor if you are not using the WPF framework-level base elements, or in extraordinary circumstances where defining cursor behavior on a per-element basis does not meet your needs. QueryCursor에 대 한 응답으로 커서 동작을 구현 하는 방법에 대 한 자세한 내용은 QueryCursorEventHandler을 참조 하세요.For more information on implementing cursor behavior in response to QueryCursor, see QueryCursorEventHandler.

라우팅 이벤트 정보Routed Event Information

식별자 필드Identifier field QueryCursorEvent
라우팅 전략Routing strategy 버블링Bubbling
대리자Delegate QueryCursorEventHandler
  • 정의 된 해당 터널링 이벤트가 없습니다.There is no defined corresponding tunneling event.

  • 파생 클래스에서이 이벤트에 대 한 클래스 처리를 구현 하려면 OnQueryCursor를 재정의 합니다.Override OnQueryCursor to implement class handling for this event in derived classes.

적용 대상

추가 정보