Compartilhar via

Método IDirectManipulationViewport::SetViewportTransform (directmanipulation.h)

  • Artigo

Especifica a transformação do sistema de coordenadas do visor para o sistema de coordenadas do cliente de janela.

Sintaxe

HRESULT SetViewportTransform(
  [in] const float *matrix,
  [in] DWORD       pointCount
);

Parâmetros

[in] matrix

A matriz de transformação, em ordem de linha: _11, _12, _21, _22, _31, _32.

[in] pointCount

O tamanho da matriz de transformação. Esse valor é sempre 6, porque uma matriz 3x2 é usada para todas as transformações de manipulação direta.

Valor retornado

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Chame essa função para especificar a posição do visor, o dimensionamento e a orientação na tela. A posição, o dimensionamento, a orientação e o tamanho do visor são determinados exclusivamente pela transformação do visor e pelo retângulo do visor. O aplicativo pode especificar a transformação do visor usando esse método e o retângulo do visor usando SetViewportRect.

O retângulo do visor (a área retangular dentro do conteúdo visível para o usuário) é especificado nas coordenadas do visor. Se o ponto de retângulo do visor superior esquerdo for (0,0), o retângulo do visor será posicionado exatamente na origem do sistema de coordenadas do visor. O deslocamento de visores da origem do sistema de coordenadas do visor pode ser especificado de duas maneiras:

  • Por meio do ponto de retângulo do visor superior esquerdo
  • Por meio do componente de tradução de transformação do visor (_31, _32)
A transformação do visor converte do sistema de coordenadas do visor para o sistema de coordenadas do cliente de janela. A Manipulação Direta ignora a propriedade RTL da janela, portanto, a origem da área do cliente é sempre o ponto superior esquerdo. As transformações são aplicadas na seguinte ordem:
  1. Deslocamento do retângulo do visor
  2. Transformação do visor (do visor ao sistema de coordenadas do cliente)
  3. Mapeamento de cliente para tela (do cliente para o sistema de coordenadas de tela)

Requisitos

   
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

Confira também

IDirectManipulationViewport