Metode IDirectManipulationViewport::AddConfiguration (directmanipulation.h)

Menambahkan konfigurasi interaksi untuk viewport.

Sintaks

HRESULT AddConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

Parameter

[in] configuration

Salah satu 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.

Anda tidak dapat menambahkan perilaku seret dan letakkan lain setelah perilaku yang sudah ada ditambahkan.

Metode ini dirancang untuk memungkinkan aplikasi beralih konfigurasi yang telah ditambahkan sebelumnya, karena konfigurasi tidak dapat diubah saat manipulasi terjadi. Dalam kebanyakan keadaan, lebih baik memperbarui konfigurasi menggunakan ActivateConfiguration.

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