MouseDevice.Capture Metode

Definisi

Ruang nama:

System.Windows.Input

Rakitan:

PresentationCore.dll

Mengambil input mouse ke elemen yang ditentukan.

Overload

Capture(IInputElement)	Mengambil peristiwa mouse ke elemen yang ditentukan.
Capture(IInputElement, CaptureMode)	Mengambil input mouse ke elemen yang ditentukan menggunakan yang ditentukan CaptureMode.

Keterangan

Saat elemen menangkap mouse, elemen menerima input mouse apakah kursor berada di dalam batasnya atau tidak.

CaptureMode Jika tidak ditentukan, defaultnya CaptureMode adalah Element.

Untuk melepaskan tangkapan mouse, panggil Capture passing null sebagai elemen untuk diambil.

Jika mouse diambil saat MouseDown atau MouseUp peristiwa dinaikkan dan input tidak masuk ke elemen di bawah mouse, PreviewMouseDownOutsideCapturedElement dan PreviewMouseUpOutsideCapturedElement dinaikkan terlebih dahulu. Ini memungkinkan elemen yang ditangkap kesempatan untuk merilis pengambilan sebelum MouseDown peristiwa dan MouseUp dirutekan.

Capture(IInputElement)

Mengambil peristiwa mouse ke elemen yang ditentukan.

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

Parameter

element

IInputElement

Elemen untuk menangkap mouse.

Mengembalikan

Boolean

true jika elemen mampu menangkap mouse; jika tidak, false.

Pengecualian

InvalidOperationException

element bukan UIElement atau ContentElement.

Keterangan

Saat elemen menangkap mouse, elemen menerima input mouse apakah kursor berada di dalam batasnya

CaptureMode Jika tidak ditentukan, defaultnya CaptureMode adalah Element.

Untuk melepaskan tangkapan mouse, panggil Capture passing null sebagai elemen untuk diambil.

Jika mouse diambil saat MouseDown atau MouseUp peristiwa dinaikkan dan input tidak masuk ke elemen di bawah mouse, PreviewMouseDownOutsideCapturedElement dan PreviewMouseUpOutsideCapturedElement dinaikkan terlebih dahulu. Ini memungkinkan elemen yang ditangkap kesempatan untuk merilis pengambilan sebelum MouseDown peristiwa dan MouseUp dirutekan.

Capture(IInputElement, CaptureMode)

Mengambil input mouse ke elemen yang ditentukan menggunakan yang ditentukan CaptureMode.

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

Parameter

element

IInputElement

Elemen untuk menangkap mouse.

captureMode

CaptureMode

Kebijakan penangkapan yang akan digunakan.

Mengembalikan

Boolean

true jika elemen mampu menangkap mouse; jika tidak, false.

Pengecualian

InvalidOperationException

element bukan UIElement atau ContentElement.

InvalidEnumArgumentException

captureMode tidak valid CaptureMode.

Keterangan

Saat elemen menangkap mouse, elemen menerima input mouse apakah kursor berada di dalam batasnya atau tidak.

Untuk melepaskan tangkapan mouse, panggil Capture passing null sebagai elemen untuk diambil.

Jika mouse diambil saat MouseDown atau MouseUp peristiwa dinaikkan dan input tidak masuk ke elemen di bawah mouse, PreviewMouseDownOutsideCapturedElement dan PreviewMouseUpOutsideCapturedElement dinaikkan terlebih dahulu. Ini memungkinkan elemen yang ditangkap kesempatan untuk merilis pengambilan sebelum MouseDown peristiwa dan MouseUp dirutekan.