MouseDevice.Capture Метод

Определение

Пространство имен:

System.Windows.Input

Сборка:

PresentationCore.dll

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

Перегрузки

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

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

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

Boolean

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

Исключения

InvalidOperationException

Параметр 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);

public bool Capture (System.Windows.IInputElement element, System.Windows.Input.CaptureMode captureMode);

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

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

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

Boolean

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

Исключения

InvalidOperationException

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

InvalidEnumArgumentException

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

Комментарии

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

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

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