IDirectManipulationPrimaryContent：：SetSnapCoordinate 方法 (directmanipulation.h)

指定貼齊點或貼齊間隔的座標系統。

語法

HRESULT SetSnapCoordinate(
  [in] DIRECTMANIPULATION_MOTION_TYPES         motion,
  [in] DIRECTMANIPULATION_SNAPPOINT_COORDINATE coordinate,
  [in] float                                   origin
);

參數

[in] motion

DIRECTMANIPULATION_MOTION_TYPES的其中一個值。

[in] coordinate

DIRECTMANIPULATION_SNAPPOINT_COORDINATE的其中一個值。

如果 動作 設定為轉譯 (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， 則 origin 必須設定為 0.0f。

傳回值

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

備註

原點相對於內容界限。 如果未 (SetContentRect 設定任何界限，) 預設界限 (FLT_MAX，FLT_MAX) 。

規格需求

另請參閱

IDirectManipulationPrimaryContent

SetSnapInterval

SetSnapPoints