Méthode IDirectManipulationPrimaryContent ::SetSnapInterval (directmanipulation.h)

Spécifie des points d’ancrage pour la position de fin de l’inertie à intervalles uniformes.

Syntaxe

HRESULT SetSnapInterval(
  [in] DIRECTMANIPULATION_MOTION_TYPES motion,
  [in] float                           interval,
  [in] float                           offset
);

Paramètres

[in] motion

L’une des valeurs d’énumération DIRECTMANIPULATION_MOTION_TYPES .

[in] interval

Intervalle entre chaque point d’ancrage.

[in] offset

Décalage par rapport à la coordonnée spécifiée dans SetSnapCoordinate.

Valeur retournée

Si la méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les emplacements des points d’ancrage sont en unités de coordonnées de contenu.

Spécifiez des points d’ancrage via SetSnapPoints ou SetSnapInterval.

Si les points d’ancrage ne sont pas valides (par exemple, en dehors des limites de contenu), ils sont ignorés et le contenu se trouve toujours dans les limites du contenu.

Les points d’ancrage ne sont pas aux limites par défaut. Si vous souhaitez que le contenu s’arrête à une limite, un point d’ancrage doit être défini à la limite.

Les points d’ancrage définis par SetSnapInterval peuvent être effacés en appelant SetSnapInterval avec un intervalle de 0,0f.

Exemples

L’exemple suivant montre comment définir le système de coordonnées pour les points d’ancrage de traduction X vers l’origine. Les points d’ancrage sont définis tous les 45 pixels, en commençant à l’origine le long de l’axe X.

HRESULT hr = SetSnapCoordinate(testWindow, 0, DIRECTMANIPULATION_MOTION_TRANSLATEX, DIRECTMANIPULATION_COORDINATE_ORIGIN, 0.0f);
hr = pContent->SetSnapInterval(DIRECTMANIPULATION_MOTION_TRANSLATEX, 45.0f, 0.0f);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	directmanipulation.h

Voir aussi

IDirectManipulationPrimaryContent

SetSnapCoordinate

SetSnapPoints