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) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | directmanipulation.h |