Método IDirectManipulationPrimaryContent::SetSnapInterval (directmanipulation.h)
Especifica pontos de ajuste para a posição final de inércia em intervalos uniformes.
Sintaxe
HRESULT SetSnapInterval(
[in] DIRECTMANIPULATION_MOTION_TYPES motion,
[in] float interval,
[in] float offset
);
Parâmetros
[in] motion
Um dos valores de enumeração DIRECTMANIPULATION_MOTION_TYPES.
[in] interval
O intervalo entre cada ponto de ajuste.
[in] offset
O deslocamento da coordenada especificada em SetSnapCoordinate.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Os locais de ponto de ajuste estão em unidades de coordenadas de conteúdo.
Especifique pontos de ajuste por meio de SetSnapPoints ou SetSnapInterval.
Se os pontos de ajuste forem inválidos (por exemplo, fora dos limites de conteúdo), eles serão ignorados e o conteúdo estará sempre dentro dos limites de conteúdo.
Os pontos de ajuste não estão nos limites por padrão. Se você quiser que o conteúdo pare em um limite, um ponto de ajuste deverá ser definido no limite.
Os pontos de ajuste definidos por SetSnapInterval podem ser limpos chamando SetSnapInterval com um intervalo de 0,0f.
Exemplos
O exemplo a seguir mostra como definir o sistema de coordenadas para pontos de ajuste de tradução X para a origem. Os pontos de ajuste são definidos a cada 45 pixels, começando na origem ao longo do eixo 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 | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | directmanipulation.h |