IDirectManipulationPrimaryContent::SetSnapCoordinate メソッド (directmanipulation.h)
スナップポイントまたはスナップ間隔の座標系を指定します。
構文
HRESULT SetSnapCoordinate(
[in] DIRECTMANIPULATION_MOTION_TYPES motion,
[in] DIRECTMANIPULATION_SNAPPOINT_COORDINATE coordinate,
[in] float origin
);
パラメーター
[in] motion
DIRECTMANIPULATION_MOTION_TYPESの値の 1 つ。
[in] coordinate
DIRECTMANIPULATION_SNAPPOINT_COORDINATEの値の 1 つ。
モーションが翻訳 (DIRECTMANIPULATION_MOTION_TRANSLATEXまたはDIRECTMANIPULATION_MOTION_TRANSLATEY) に設定されている場合、DIRECTMANIPULATION_SNAPPOINT_COORDINATEのすべての値が有効です。
モーションがDIRECTMANIPULATION_MOTION_ZOOMに設定されている場合、DIRECTMANIPULATION_SNAPPOINT_COORDINATEのDIRECTMANIPULATION_COORDINATE_ORIGINのみが有効です (原点は 0.0f に設定する必要があります)。
[in] origin
最初または開始位置のスナップ ポイント。 すべてのスナップポイントは、この点に対して相対的です。 DIRECTMANIPULATION_COORDINATE_ORIGINが設定されている場合にのみ使用されます。
モーションがDIRECTMANIPULATION_MOTION_ZOOMに設定されている場合は、原点を 0.0f に設定する必要があります。
戻り値
メソッドが成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
注釈
配信元はコンテンツ境界を基準にしています。 境界が設定されていない場合 (SetContentRect は呼び出されません)、既定の境界は (-FLT_MAX、 FLT_MAX) です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | directmanipulation.h |