Метод 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 , можно очистить, вызвав Метод SetSnapInterval с интервалом 0,0f.

Примеры

В следующем примере показано, как задать систему координат для точек привязки перевода 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);

Требования

См. также раздел

IDirectManipulationPrimaryContent

SetSnapCoordinate

SetSnapPoints