Поделиться через


MouseDevice.Capture Метод

Определение

Захватывает ввод мыши в указанный элемент.

Перегрузки

Capture(IInputElement)

Захватывает события мыши заданным элементом.

Capture(IInputElement, CaptureMode)

Захватывает ввод мыши в указанный элемент, используя заданный режим CaptureMode.

Комментарии

Когда элемент захватывает мышь, он получает входные данные, независимо от того, находится ли курсор в его границах.

Если параметр CaptureMode не указан, по умолчанию CaptureMode используется значение Element.

Чтобы освободить захват мыши, вызовите Capture передачу null в качестве элемента для записи.

Если мышь захватывается при MouseDown возникновении события или MouseUp и входные данные не поедут к элементу под мышью, PreviewMouseDownOutsideCapturedElement и PreviewMouseUpOutsideCapturedElement вызываются первым. Это позволяет захваченным элементу освободить запись до перенаправления MouseDown событий и MouseUp .

Capture(IInputElement)

Захватывает события мыши заданным элементом.

public:
 bool Capture(System::Windows::IInputElement ^ element);
public bool Capture (System.Windows.IInputElement element);
member this.Capture : System.Windows.IInputElement -> bool
Public Function Capture (element As IInputElement) As Boolean

Параметры

element
IInputElement

Элемент, захватывающий мышь.

Возвращаемое значение

Значение true, если элемент смог захватить мышь; в противном случае — значение false.

Исключения

Параметр element не является объектом UIElement или ContentElement.

Комментарии

Когда элемент захватывает мышь, он получает входные данные мыши независимо от того, находится ли курсор в пределах его границ

Если параметр CaptureMode не указан, по умолчанию CaptureMode используется значение Element.

Чтобы освободить захват мыши, вызовите Capture передачу null в качестве элемента для записи.

Если мышь захватывается при MouseDown возникновении события или MouseUp и входные данные не поедут к элементу под мышью, PreviewMouseDownOutsideCapturedElement и PreviewMouseUpOutsideCapturedElement вызываются первым. Это позволяет захваченным элементу освободить запись до перенаправления MouseDown событий и MouseUp .

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

Capture(IInputElement, CaptureMode)

Захватывает ввод мыши в указанный элемент, используя заданный режим CaptureMode.

public:
 bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);
[System.Security.SecurityCritical]
public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);
[<System.Security.SecurityCritical>]
member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
member this.Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool
Public Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

Параметры

element
IInputElement

Элемент, захватывающий мышь.

captureMode
CaptureMode

Используемая политика захвата.

Возвращаемое значение

Значение true, если элемент смог захватить мышь; в противном случае — значение false.

Атрибуты

Исключения

Параметр element не является объектом UIElement или ContentElement.

captureMode не является допустимым CaptureMode.

Комментарии

Когда элемент захватывает мышь, он получает входные данные, независимо от того, находится ли курсор в его границах.

Чтобы освободить захват мыши, вызовите Capture передачу null в качестве элемента для записи.

Если мышь захватывается при MouseDown возникновении события или MouseUp и входные данные не поедут к элементу под мышью, PreviewMouseDownOutsideCapturedElement и PreviewMouseUpOutsideCapturedElement вызываются первым. Это позволяет захваченным элементу освободить запись до перенаправления MouseDown событий и MouseUp .

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