Metodo IDirectManipulationPrimaryContent::SetSnapInterval (directmanipulation.h)
Specifica i punti di ancoraggio per la posizione finale dell'inerzia a intervalli uniformi.
Sintassi
HRESULT SetSnapInterval(
[in] DIRECTMANIPULATION_MOTION_TYPES motion,
[in] float interval,
[in] float offset
);
Parametri
[in] motion
Uno dei valori di enumerazione DIRECTMANIPULATION_MOTION_TYPES .
[in] interval
Intervallo tra ogni punto di ancoraggio.
[in] offset
Offset della coordinata specificata in SetSnapCoordinate.
Valore restituito
Se il metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Le posizioni dei punti di ancoraggio si trovano in unità di coordinate del contenuto.
Specificare punti di ancoraggio tramite SetSnapPoints o SetSnapInterval.
Se i punti di ancoraggio non sono validi, ad esempio all'esterno dei limiti del contenuto, vengono ignorati e il contenuto è sempre entro i limiti del contenuto.
Per impostazione predefinita, i punti di ancoraggio non sono presenti nei limiti. Se si desidera che il contenuto si arresti in corrispondenza di un limite, è necessario impostare un punto di ancoraggio al limite.
I punti di ancoraggio impostati da SetSnapInterval possono essere cancellati chiamando SetSnapInterval con un intervallo di 0,0f.
Esempio
Nell'esempio seguente viene illustrato come impostare il sistema di coordinate per lo snap di conversione X sull'origine. I punti di ancoraggio vengono impostati ogni 45 pixel, a partire dall'origine lungo l'asse X.
HRESULT hr = SetSnapCoordinate(testWindow, 0, DIRECTMANIPULATION_MOTION_TRANSLATEX, DIRECTMANIPULATION_COORDINATE_ORIGIN, 0.0f);
hr = pContent->SetSnapInterval(DIRECTMANIPULATION_MOTION_TRANSLATEX, 45.0f, 0.0f);
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | directmanipulation.h |