Método IDirectManipulationPrimaryContent::SetSnapInterval (directmanipulation.h)
Especifica los puntos de acoplamiento para la posición final de inercia a intervalos uniformes.
Sintaxis
HRESULT SetSnapInterval(
[in] DIRECTMANIPULATION_MOTION_TYPES motion,
[in] float interval,
[in] float offset
);
Parámetros
[in] motion
Uno de los valores de enumeración DIRECTMANIPULATION_MOTION_TYPES.
[in] interval
Intervalo entre cada punto de acoplamiento.
[in] offset
Desplazamiento de la coordenada especificada en SetSnapCoordinate.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Las ubicaciones de punto de acoplamiento se encuentran en unidades de coordenadas de contenido.
Especifique puntos de acoplamiento a través de SetSnapPoints o SetSnapInterval.
Si los puntos de acoplamiento no son válidos (por ejemplo, fuera de los límites de contenido), se omiten y el contenido siempre está dentro de los límites de contenido.
Los puntos de acoplamiento no están en los límites de forma predeterminada. Si desea que el contenido se detenga en un límite, se debe establecer un punto de acoplamiento en el límite.
Los puntos de acoplamiento establecidos por SetSnapInterval se pueden borrar llamando a SetSnapInterval con un intervalo de 0,0f.
Ejemplos
En el ejemplo siguiente se muestra cómo establecer el sistema de coordenadas para los puntos de acoplamiento de traducción X en el origen. Los puntos de acoplamiento se establecen cada 45 píxeles, comenzando en el origen a lo largo del eje X.
HRESULT hr = SetSnapCoordinate(testWindow, 0, DIRECTMANIPULATION_MOTION_TRANSLATEX, DIRECTMANIPULATION_COORDINATE_ORIGIN, 0.0f);
hr = pContent->SetSnapInterval(DIRECTMANIPULATION_MOTION_TRANSLATEX, 45.0f, 0.0f);
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | directmanipulation.h |