Mouse.Capture Metodo

Definizione

Spazio dei nomi:

System.Windows.Input

Assembly:

PresentationCore.dll

Acquisisce gli input del mouse nell'elemento specificato.

Overload

Capture(IInputElement)	Acquisisce gli input del mouse nell'elemento specificato.
Capture(IInputElement, CaptureMode)	Acquisisce l'input del mouse per l'elemento specificato usando l'oggetto CaptureMode specificato.

Commenti

Quando un elemento acquisisce il mouse, riceve l'input del mouse indipendentemente dal fatto che il cursore si trova all'interno dei bordi.

Se non viene specificato un CaptureMode oggetto , il valore predefinito CaptureMode è Element.

Per rilasciare l'acquisizione del mouse, chiamare Capture passando null come elemento da acquisire.

Se il mouse viene acquisito quando viene generato un MouseDown evento o MouseUp e l'input non passa all'elemento sotto il mouse PreviewMouseDownOutsideCapturedElement e PreviewMouseUpOutsideCapturedElement viene generato per primo. Ciò consente all'elemento acquisito di rilasciare l'acquisizione prima che gli MouseDown eventi e MouseUp vengano indirizzati.

Capture(IInputElement)

Acquisisce gli input del mouse nell'elemento specificato.

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

Parametri

element

IInputElement

Elemento che deve acquisire il mouse.

Restituisce

Boolean

true se l'elemento non è stato in grado di acquisire il mouse; in caso contrario false.

Esempio

Nell'esempio seguente viene illustrato come acquisire il mouse in un elemento specifico usando il Capture metodo .

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

Commenti

Quando un elemento acquisisce il mouse, riceve l'input del mouse indipendentemente dal fatto che il cursore si trova all'interno dei bordi.

Se non viene specificato un CaptureMode oggetto , il valore predefinito CaptureMode è Element.

Per rilasciare l'acquisizione del mouse, chiamare Capture passando null come elemento da acquisire.

Se il mouse viene acquisito quando viene generato un MouseDown evento o MouseUp e l'input non passa all'elemento sotto il mouse PreviewMouseDownOutsideCapturedElement e PreviewMouseUpOutsideCapturedElement viene generato per primo. Ciò consente all'elemento acquisito di rilasciare l'acquisizione prima che gli MouseDown eventi e MouseUp vengano indirizzati.

Capture(IInputElement, CaptureMode)

Acquisisce l'input del mouse per l'elemento specificato usando l'oggetto CaptureMode specificato.

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

Parametri

element

IInputElement

Elemento che deve acquisire il mouse.

captureMode

CaptureMode

I criteri di acquisizione da usare.

Restituisce

Boolean

true se l'elemento non è stato in grado di acquisire il mouse; in caso contrario false.

Esempio

Nell'esempio seguente viene illustrato come acquisire il mouse in un elemento specifico usando il Capture metodo .

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

Commenti

Quando un elemento acquisisce il mouse, riceve l'input del mouse se il cursore si trova all'interno dei bordi.

Per rilasciare l'acquisizione del mouse, chiamare Capture passando null come elemento da acquisire.

Se il mouse viene acquisito quando viene generato un MouseDown evento o MouseUp e l'input non passa all'elemento sotto il mouse PreviewMouseDownOutsideCapturedElement e PreviewMouseUpOutsideCapturedElement viene generato per primo. Ciò consente all'elemento acquisito di rilasciare l'acquisizione prima che gli MouseDown eventi e MouseUp vengano indirizzati.