IDirectManipulationViewport::AddConfiguration メソッド (directmanipulation.h)

ビューポートの相互作用構成を追加します。

構文

HRESULT AddConfiguration(
  [in] DIRECTMANIPULATION_CONFIGURATION configuration
);

[in] configuration

ビューポートの相互作用の構成を指定する DIRECTMANIPULATION_CONFIGURATION の値の 1 つ。

メソッドが成功すると、 S_OKが返されます。そうでない場合は、HRESULT エラーコードを返します。

操作の構成では、操作エンジンが入力に応答する方法と、サポートされている操作を指定します。入力を処理する前に 、AddConfiguration を使用して任意の数の構成をビューポートに追加できます。

構成は、 ActivateConfiguration を使用して実行時にアプリケーションによって切り替えることができます。

構成が不要になった場合 (および現在アクティブでない場合) は、 RemoveConfiguration を使用して削除できます。

構成が AddConfiguration を使用して追加されていない場合は、ActivateConfiguration を呼び出すことによって、構成を自動的に追加してアクティブ化できます。

メモ入力処理が行われている場合、この呼び出しは失敗します。

ドラッグアンドドロップの動作が指定されている場合、このメソッドは失敗します。

ドラッグアンドドロップ動作オブジェクトは、このメソッドを正常に呼び出した後にアタッチできません。

既存のドラッグアンドドロップ動作が既に追加された後は、別のドラッグアンドドロップ動作を追加することはできません。

このメソッドは、操作の実行中に構成を変更できないため、アプリケーションが事前に追加された構成を切り替えるように設計されています。ほとんどの状況では、 ActivateConfiguration を使用して構成を更新することをお勧めします。