Share via

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

另請參閱

IDirectManipulationViewport