Mouse.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)	Zachytí vstup myši do zadaného elementu.
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)

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

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

Parametry

element

IInputElement

Prvek pro zachycení myši.

Návraty

Boolean

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

Příklady

Následující příklad ukazuje, jak zachytit myš na konkrétní prvek pomocí Capture metody .

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

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, CaptureMode)

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

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

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

Příklady

Následující příklad ukazuje, jak zachytit myš na konkrétní prvek pomocí Capture metody .

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

Poznámky

Když prvek zachytí myš, přijme vstup myši, zda je kurzor 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 .