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 |