IDirectManipulationViewport：：AddConfiguration 方法 (directmanipulation.h)

新增檢視區的互動組態。

語法

HRESULT AddConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

[in] configuration

DIRECTMANIPULATION_CONFIGURATION的其中一個值，指定檢視區的互動組態。

如果方法成功，它會 傳回S_OK。否則，它會傳回 HRESULT 錯誤碼。

互動組態會指定操作引擎如何回應輸入，以及支援哪些操作。在處理輸入之前，可以使用 AddConfiguration 將任意數目的可能組態新增至檢視區。

應用程式可以使用 ActivateConfiguration 在運行時間切換組態。

當不再需要設定 (且目前不在作用中) 時，可以使用 RemoveConfiguration 加以移除。

如果尚未使用 AddConfiguration 新增設定，則可以藉由呼叫 ActivateConfiguration 自動新增並啟用。

注意如果發生輸入處理，此呼叫將會失敗。

如果已指定拖放行為，這個方法就會失敗。

成功呼叫這個方法之後，就無法附加拖放行為物件。

您無法在新增現有的拖放行為之後新增另一個拖放行為。

這個方法的設計目的是允許應用程式切換預先新增的設定，因為發生操作時無法變更設定。在大部分情況下，最好使用 ActivateConfiguration 來更新組態。