MouseDevice.Capture Metoda

Definicja

Przestrzeń nazw:

System.Windows.Input

Zestaw:

PresentationCore.dll

Przechwytuje dane wejściowe myszy do określonego elementu.

Przeciążenia

Capture(IInputElement)	Przechwytuje zdarzenia myszy do określonego elementu.
Capture(IInputElement, CaptureMode)	Przechwytuje dane wejściowe myszy do określonego elementu przy użyciu określonego CaptureModeelementu .

Uwagi

Gdy element przechwytuje mysz, otrzymuje dane wejściowe myszy niezależnie od tego, czy kursor znajduje się w jego obramowaniach.

Jeśli parametr CaptureMode nie zostanie określony, wartość domyślna CaptureMode to Element.

Aby zwolnić przechwytywanie myszy, wywołaj Capture przekazywanie null jako element do przechwycenia.

Jeśli mysz zostanie przechwycona, gdy zostanie podniesione MouseDown zdarzenie lub MouseUp , a dane wejściowe nie trafią do elementu pod myszą PreviewMouseDownOutsideCapturedElement i PreviewMouseUpOutsideCapturedElement zostaną podniesione jako pierwsze. Dzięki temu przechwycony element będzie mógł zwolnić przechwytywanie przed kierowaniem MouseDown zdarzeń i MouseUp .

Capture(IInputElement)

Przechwytuje zdarzenia myszy do określonego elementu.

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

Parametry

element

IInputElement

Element do przechwytywania myszy.

Zwraca

Boolean

true jeżeli element był w stanie przechwycić mysz; w przeciwnym razie , false.

Wyjątki

InvalidOperationException

element nie jest elementem UIElement lub ContentElement.

Uwagi

Gdy element przechwytuje mysz, otrzymuje dane wejściowe myszy, czy kursor znajduje się w jego granicach

Jeśli parametr CaptureMode nie zostanie określony, wartość domyślna CaptureMode to Element.

Aby zwolnić przechwytywanie myszy, wywołaj Capture przekazywanie null jako element do przechwycenia.

Jeśli mysz zostanie przechwycona, gdy zostanie podniesione MouseDown zdarzenie lub MouseUp , a dane wejściowe nie trafią do elementu pod myszą PreviewMouseDownOutsideCapturedElement i PreviewMouseUpOutsideCapturedElement zostaną podniesione jako pierwsze. Dzięki temu przechwycony element będzie mógł zwolnić przechwytywanie przed kierowaniem MouseDown zdarzeń i MouseUp .

Capture(IInputElement, CaptureMode)

Przechwytuje dane wejściowe myszy do określonego elementu przy użyciu określonego CaptureModeelementu .

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

Parametry

element

IInputElement

Element do przechwytywania myszy.

captureMode

CaptureMode

Zasady przechwytywania do użycia.

Zwraca

Boolean

true jeżeli element był w stanie przechwycić mysz; w przeciwnym razie , false.

Wyjątki

InvalidOperationException

element nie jest elementem UIElement lub ContentElement.

InvalidEnumArgumentException

captureMode element nie jest prawidłowym CaptureModeelementem .

Uwagi

Gdy element przechwytuje mysz, otrzymuje dane wejściowe myszy niezależnie od tego, czy kursor znajduje się w jego obramowaniach.

Aby zwolnić przechwytywanie myszy, wywołaj Capture przekazywanie null jako element do przechwycenia.

Jeśli mysz zostanie przechwycona, gdy zostanie podniesione MouseDown zdarzenie lub MouseUp , a dane wejściowe nie trafią do elementu pod myszą PreviewMouseDownOutsideCapturedElement i PreviewMouseUpOutsideCapturedElement zostaną podniesione jako pierwsze. Dzięki temu przechwycony element będzie mógł zwolnić przechwytywanie przed kierowaniem MouseDown zdarzeń i MouseUp .