MouseDevice.Capture Metoda

Definice

Obor názvů:

System.Windows.Input

Sestavení:

PresentationCore.dll

Zachytí vstup myši do zadaného elementu.

Přetížení

Capture(IInputElement)	Zaznamenává události myši do zadaného prvku.
Capture(IInputElement, CaptureMode)	Zachytí vstup myši do zadaného elementu pomocí zadaného CaptureModeobjektu .

Poznámky

Když prvek zachytí myš, přijme vstup myši bez ohledu na to, jestli se kurzor nachází v jejím ohraničení.

CaptureMode Pokud není zadaný, výchozí CaptureMode hodnota je Element.

Pokud chcete uvolnit zachytávání myší, volejte Capture předávání null jako prvek, který se má zachytit.

Pokud je myš zachycena, když MouseDown je vyvolána událost nebo MouseUp a vstup nejde do elementu pod myší a PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement jsou vyvolány jako první. To umožňuje zachyceným prvkům šanci uvolnit záznam před směrováním MouseDown událostí a MouseUp .

Capture(IInputElement)

Zaznamenává události myši do zadaného prvku.

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

Prvek pro zachycení myši.

Návraty

Boolean

truepokud byl prvek schopen zachytit myš; v opačném případě . false

Výjimky

InvalidOperationException

element není nebo UIElementContentElement.

Poznámky

Když prvek zachytí myš, přijme vstup myši bez ohledu na to, jestli je kurzor v jejím ohraničení.

CaptureMode Pokud není zadaný, výchozí CaptureMode hodnota je Element.

Pokud chcete uvolnit zachytávání myší, volejte Capture předávání null jako prvek, který se má zachytit.

Pokud je myš zachycena, když MouseDown je vyvolána událost nebo MouseUp a vstup nejde do elementu pod myší a PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement jsou vyvolány jako první. To umožňuje zachyceným prvkům šanci uvolnit záznam před směrováním MouseDown událostí a MouseUp .

Capture(IInputElement, CaptureMode)

Zachytí vstup myši do zadaného elementu pomocí zadaného CaptureModeobjektu .

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

Prvek pro zachycení myši.

captureMode

CaptureMode

Zásady zachytávání, které se mají použít.

Návraty

Boolean

truepokud byl prvek schopen zachytit myš; v opačném případě . false

Výjimky

InvalidOperationException

element není nebo UIElementContentElement.

InvalidEnumArgumentException

captureMode není platný CaptureMode.

Poznámky

Když prvek zachytí myš, přijme vstup myši bez ohledu na to, jestli se kurzor nachází v jejím ohraničení.

Pokud chcete uvolnit zachytávání myší, volejte Capture předávání null jako prvek, který se má zachytit.

Pokud je myš zachycena, když MouseDown je vyvolána událost nebo MouseUp a vstup nejde do elementu pod myší a PreviewMouseDownOutsideCapturedElementPreviewMouseUpOutsideCapturedElement jsou vyvolány jako první. To umožňuje zachyceným prvkům šanci uvolnit záznam před směrováním MouseDown událostí a MouseUp .