UIElement.MouseLeftButtonDown UIElement.MouseLeftButtonDown UIElement.MouseLeftButtonDown UIElement.MouseLeftButtonDown Event

Определение

Происходит при нажатии левой кнопки мыши в тот момент, когда указатель мыши находится над данным элементом.Occurs when the left mouse button is pressed while the mouse pointer is over this element.

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

Реализации

Комментарии

Несмотря на то что это перенаправленное событие кажется маршруту через дерево элементов, фактически является прямой перенаправленное событие, которое возникает и восходящему на дереве элементов друг UIElement.Although this routed event seems to follow a bubbling 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.MouseDown событие, которое является присоединенного события, обрабатываемого каждым элементом на маршруте события.This event is one of several related events that report the mouse-button specifics of an underlying Mouse.MouseDown event, which is an attached event that is processed by each element along an event route.

Данные события это событие предоставляет данные события базового Mouse.MouseDown событий.The event data of this event exposes the event data of the underlying Mouse.MouseDown 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. Если пометить MouseLeftButtonDown обрабатывается, вы по сути пометки Mouse.MouseDown обрабатываются для всех последующих прослушивателей в маршруте и на всех событий, связанных с.If you mark MouseLeftButtonDown handled, you are essentially marking Mouse.MouseDown handled for all further listeners along the route, and on all related events. Это возможно содержит созданный класс обработчика события например MouseDoubleClick.This possibly includes class-handler generated events such as MouseDoubleClick.

С концептуальной точки зрения это событие (и другие события кнопки мыши 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 - интерфейсыAPIs на Mouse класса вместо тех, на UIElement.For more advanced scenarios, such as checking for states of non-standard buttons, you might need to use the API - интерфейсыAPIs on the Mouse class rather than those on UIElement.

Важно!

Некоторые классы элементов управления может иметь внутреннюю обработку классов для события кнопки мыши.Some control classes might have inherent class handling for mouse button events. Событие нажатия левой кнопки является событие, скорее всего, чтобы класс, обработка в элементе управления.The left mouse button down event is the most likely event to have class handling in a control. Обработку часто класса помечает базовый Mouse класс событие как обработанное.The class handling often marks the underlying Mouse class event as handled. После пометки события как обработанного другие обработчики экземпляров, подключенных к этому элементу, не инициируются.Once the event is marked handled, other instance handlers that are attached to that element are not ordinarily raised. Любые другие обработчики класса или экземпляра, присоединенные к элементам в восходящем направлении к корню дерева пользовательского интерфейса, также обычно не инициируются.Any other class or instance handlers that are attached to elements in the bubbling direction towards the root in the UI tree are also not ordinarily raised.

Можно устранить проблему, описанную в Важном и по-прежнему получать MouseLeftButtonDown событий для кнопки мыши в производном классе с обработкой класса с помощью любого из следующих решений:You can resolve the issue that is outlined in the preceding Important and still receive MouseLeftButtonDown events for left mouse button down events on a derived class that has class handling by using either of these solutions:

  • Присоединять обработчики для PreviewMouseDown события, который не помечен как обработанное в элементах управления.Attach handlers for the PreviewMouseDown event, which is not marked as handled by the controls. Обратите внимание на то, что так как это события предварительного просмотра, маршрут начинается от корня и туннелируется вниз к элемента управления.Notice that because this is a preview event, the route starts at the root and tunnels down to the control.

  • Процедурному зарегистрировать обработчик для элемента управления путем вызова AddHandler и выбрать вариант подписи, который позволяет обработчику прослушивать события, даже если уже отмечены как обработанное в данных перенаправленного события.Register a handler on the control procedurally by calling AddHandler and choosing the signature option that enables handlers to listen for events even if they are already marked as handled in the routed event data.

Сведения о маршрутизируемом событииRouted Event Information

Поле идентификатораIdentifier field MouseLeftButtonDownEvent
Стратегия маршрутизацииRouting strategy DirectDirect
делегатDelegate MouseButtonEventHandler
  • Переопределить OnMouseLeftButtonDown реализовать обработчик класса для этого события в производных классах.Override OnMouseLeftButtonDown to implement class handling for this event in derived classes.

Применяется к

Дополнительно