IDirectManipulationViewport::ActivateConfiguration 方法 (directmanipulation.h)
設定輸入互動的組態。
語法
HRESULT ActivateConfiguration(
[in] DIRECTMANIPULATION_CONFIGURATION configuration
);
參數
[in] configuration
DIRECTMANIPULATION_CONFIGURATION的一或多個值,指定檢視區的互動組態。
傳回值
如果方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
互動組態會指定操作引擎如何回應輸入,以及支援哪些操作。 在處理輸入之前,可以使用 AddConfiguration 將任意數目的可能組態新增至檢視區。
您可以使用 ActivateConfiguration,在運行時間由應用程式切換組態。
當不再需要組態 (且目前不在作用中) 時,可以使用 RemoveConfiguration 加以移除。
如果尚未使用 AddConfiguration 新增設定,則可以藉由呼叫 ActivateConfiguration 自動新增並啟用。
注意 如果輸入處理發生,此呼叫將會失敗。
成功呼叫此方法之後,就無法附加 拖放 行為物件。
範例
下列範例示範如何設定水準移動瀏覽的檢視區。
HRESULT hr = pViewport>ActivateConfiguration(
DIRECTMANIPULATION_CONFIGURATION_INTERACTION |
DIRECTMANIPULATION_CONFIGURATION_TRANSLATION_X);
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | directmanipulation.h |