Bagikan melalui

Metode IDirectManipulationViewport::SetInputMode (directmanipulation.h)

  • Artikel

Menentukan apakah input terlihat oleh utas UI.

Sintaks

HRESULT SetInputMode(
  [in] DIRECTMANIPULATION_INPUT_MODE mode
);

Parameter

[in] mode

Salah satu nilai dari DIRECTMANIPULATION_INPUT_MODE.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

DIRECTMANIPULATION_INPUT_MODE_AUTOMATIC adalah mode default untuk Manipulasi Langsung.

Manipulasi Langsung menggunakan semua input yang mendorong manipulasi dan aplikasi menerima pesan WM_POINTERCAPTURECHANGED.

Dalam beberapa situasi, aplikasi mungkin ingin menerima input yang mendorong manipulasi. Atur DIRECTMANIPULATION_INPUT_MODE_MANUAL dalam kasus ini. Aplikasi akan menerima semua pesan input, bahkan input yang digunakan oleh Manipulasi Langsung untuk mendorong manipulasi.

Catatan Aplikasi tidak akan menerima pesan WM_POINTERCAPTURECHANGED.
 
Memanggil metode ini dengan set DIRECTMANIPULATION_INPUT_MODE_MANUAL mirip dengan memanggil SetViewportOptions(DIRECTMANIPULATION_VIEWPORT_OPTIONS_INPUT). Namun, memanggil SetViewportOptions juga mengambil alih semua pengaturan lainnya.

Contoh

Contoh berikut menunjukkan cara menggunakan metode ini.

HRESULT hr = pViewport->SetInputMode(DIRECTMANIPULATION_INPUT_MODE_AUTOMATIC);

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header directmanipulation.h

Lihat juga

IDirectManipulationViewport