Mouse.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:
 static bool Capture(System::Windows::IInputElement ^ element);

public static bool Capture (System.Windows.IInputElement element);

static member Capture : System.Windows.IInputElement -> bool

Public Shared Function Capture (element As IInputElement) As Boolean

Параметры

element

IInputElement

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

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

Boolean

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

Примеры

В следующем примере показано, как записать мышь в определенный элемент с помощью Capture метода .

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}

Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

Комментарии

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

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

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

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

Capture(IInputElement, CaptureMode)

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

public:
 static bool Capture(System::Windows::IInputElement ^ element, System::Windows::Input::CaptureMode captureMode);

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

static member Capture : System.Windows.IInputElement * System.Windows.Input.CaptureMode -> bool

Public Shared Function Capture (element As IInputElement, captureMode As CaptureMode) As Boolean

Параметры

element

IInputElement

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

captureMode

CaptureMode

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

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

Boolean

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

Примеры

В следующем примере показано, как записать мышь в определенный элемент с помощью Capture метода .

private void OnCaptureMouseRequest(object sender, RoutedEventArgs e)
{
    Mouse.Capture(_elementToCapture);
}

Private Sub OnCaptureMouseRequest(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Mouse.Capture(_elementToCapture)
End Sub

Комментарии

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

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

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