UIElement.PreviewMouseLeftButtonDown 이벤트


마우스 포인터가 이 요소 위에 있는 동안 마우스 왼쪽 단추를 누르면 발생합니다.Occurs when the left mouse button is pressed while the mouse pointer is over this element.

 virtual event System::Windows::Input::MouseButtonEventHandler ^ PreviewMouseLeftButtonDown;
public event System.Windows.Input.MouseButtonEventHandler PreviewMouseLeftButtonDown;
member this.PreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event PreviewMouseLeftButtonDown As MouseButtonEventHandler 

이벤트 유형




라우트된 이벤트 는 요소 트리를 통해 터널링 경로를 따르는 것으로 보이지만 실제로는 발생 하는 직접 라우트된 이벤트 이며 각각에 의해 요소 트리를 따라 reraised 됩니다 UIElement .Although this routed event seems to follow a tunneling route through an element tree, it actually is a direct routed event that is raised and reraised along the element tree by each UIElement.

이 이벤트는 Mouse.PreviewMouseDown 이벤트 경로를 따라 각 요소에 의해 처리 되는 연결 된 이벤트 인 기본 이벤트의 마우스 단추 특성을 보고 하는 여러 관련 이벤트 중 하나입니다.This event is one of several related events that report the mouse-button specifics of an underlying Mouse.PreviewMouseDown event, which is an attached event that is processed by each element along an event route.

이 이벤트의 이벤트 데이터는 기본 이벤트의 이벤트 데이터를 노출 합니다 Mouse.PreviewMouseDown .The event data of this event exposes the event data of the underlying Mouse.PreviewMouseDown event. 이벤트가 이벤트 경로를 따라 처리 된 것으로 표시 되 면 마우스 단추 특정 이벤트는 계속 발생 합니다. 그러나 이벤트의 수신기가 되도록 이미 처리 된 것으로 표시 된 이벤트를 처리 하는 옵션을 사용 하 여 마우스 단추의 특정 이벤트 처리기를 명시적으로 호출 하 여 추가 해야 합니다 AddHandler .If that event is marked as handled along the event route, the mouse-button specific events are still raised; however, handlers of the mouse-button specific events must be added by explicitly calling AddHandler, with the option to handle events that are already marked as handled, in order to be listeners to the event. 처리 된 것 PreviewMouseLeftButtonDown 으로 표시 하면 기본적으로 Mouse.PreviewMouseDown 경로와 관련 된 모든 이벤트에 대 한 모든 추가 수신기가 처리 됩니다.If you mark PreviewMouseLeftButtonDown handled, you are essentially marking Mouse.PreviewMouseDown handled for all further listeners along the route, and on all related events. 여기에는와 같은 클래스 처리기 생성 이벤트가 포함 될 수 있습니다 PreviewMouseDoubleClick .This possibly includes class-handler generated events such as PreviewMouseDoubleClick.

개념적으로이 이벤트 (및의 다른 마우스 단추 이벤트 UIElement )는 마우스 "서비스" (클래스에서 제공 하는 서비스 정의 사용)로 간주 Mouse 합니다.Conceptually, think of this event (and other mouse-button events on UIElement) to be a mouse "service" (with the service definition provided by the Mouse class). 이벤트는 이벤트 데이터에서 원래 마우스 이벤트의 마우스 단추 상태 (왼쪽, 오른쪽, 아래쪽)를 확인할 필요가 없는 편의성을 추가 합니다.The event adds the convenience of not needing to check the mouse button states (left-right, up-down) of the original mouse events in the event data. 비표준 단추의 상태를 확인 하는 것과 같은 고급 시나리오의 경우에서 해당 Api를 사용 하는 대신 클래스에서 Api를 사용 해야 할 수 있습니다 Mouse UIElement .For more advanced scenarios, such as checking for states of non-standard buttons, you might need to use the APIs on the Mouse class rather than those on UIElement.

라우팅 이벤트 정보Routed Event Information

식별자 필드Identifier field PreviewMouseLeftButtonDownEvent
라우팅 전략Routing strategy 직접Direct
대리자Delegate MouseButtonEventHandler

적용 대상

추가 정보