MouseDevice.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 eventi 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 eventi del mouse nell'elemento specificato.

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

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.

Eccezioni

InvalidOperationException

element non è un oggetto UIElement né ContentElement.

Commenti

Quando un elemento acquisisce il mouse, riceve l'input del mouse se 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:
 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

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.

Eccezioni

InvalidOperationException

element non è un oggetto UIElement né ContentElement.

InvalidEnumArgumentException

captureMode non è un oggetto CaptureMode valido.

Commenti

Quando un elemento acquisisce il mouse, riceve l'input del mouse indipendentemente dal fatto che 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.