IDirectManipulationViewport::ActivateConfiguration method (directmanipulation.h)

Artikel
02/29/2024

Mengatur konfigurasi untuk interaksi input.

Sintaks

HRESULT ActivateConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

Parameter

[in] configuration

Satu atau beberapa nilai dari DIRECTMANIPULATION_CONFIGURATION yang menentukan konfigurasi interaksi untuk viewport.

Nilai kembali

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

Keterangan

Konfigurasi interaksi menentukan bagaimana mesin manipulasi merespons input dan manipulasi mana yang didukung. Sejumlah konfigurasi yang mungkin dapat ditambahkan ke viewport menggunakan AddConfiguration sebelum memproses input.

Konfigurasi dapat dialihkan oleh aplikasi saat runtime menggunakan ActivateConfiguration.

Ketika konfigurasi tidak lagi diperlukan (dan saat ini tidak aktif), konfigurasi dapat dihapus menggunakan RemoveConfiguration.

Jika konfigurasi belum ditambahkan menggunakan AddConfiguration, konfigurasi dapat ditambahkan secara otomatis lalu diaktifkan dengan memanggil ActivateConfiguration.

Catatan Jika pemrosesan input terjadi, panggilan ini akan gagal.

Metode ini gagal jika perilaku seret dan letakkan telah ditentukan.

Objek perilaku seret dan letakkan tidak dapat dilampirkan setelah berhasil memanggil metode ini.

Contoh

Contoh berikut menunjukkan cara mengonfigurasi viewport untuk panning horizontal.

HRESULT hr = pViewport>ActivateConfiguration(
    DIRECTMANIPULATION_CONFIGURATION_INTERACTION | 
    DIRECTMANIPULATION_CONFIGURATION_TRANSLATION_X);

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

Bagikan melalui