IDirectManipulationPrimaryContent：：SetSnapInterval 方法 (directmanipulation.h)
指定慣性結束位置在統一間隔的貼齊點。
語法
HRESULT SetSnapInterval(
[in] DIRECTMANIPULATION_MOTION_TYPES motion,
[in] float interval,
[in] float offset
);
參數
[in] motion
其中一個 DIRECTMANIPULATION_MOTION_TYPES 列舉值。
[in] interval
每個貼齊點之間的間隔。
[in] offset
SetSnapCoordinate 中指定的座標位移。
傳回值
如果方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
貼齊點位置以內容座標單位為單位。
透過 SetSnapPoints 或 SetSnapInterval 指定貼齊點。
例如，如果貼齊點無效 (，) 內容界限之外，則會忽略它們，而且內容一律位於內容界限內。
貼齊點預設不在界限。 如果您想要在界限停止內容，則必須在界限上設定貼齊點。
您可以呼叫 SetSnapInterval 間隔為 0.0f 的 SetSnapInterval 來清除由 SetSnapInterval 設定的貼齊點。
範例
下列範例示範如何將 X 轉譯貼齊點的座標系統設定為原點。 貼齊點每 45 像素設定一次，從 X 軸的原點開始。
HRESULT hr = SetSnapCoordinate(testWindow, 0, DIRECTMANIPULATION_MOTION_TRANSLATEX, DIRECTMANIPULATION_COORDINATE_ORIGIN, 0.0f);
hr = pContent->SetSnapInterval(DIRECTMANIPULATION_MOTION_TRANSLATEX, 45.0f, 0.0f);
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | directmanipulation.h |