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

Especifica la transformación del sistema de coordenadas de ventanilla al sistema de coordenadas del cliente de la ventana.

Sintaxis

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

Parámetros

[in] matrix

Matriz de transformación, en orden de fila: _11, _12, _21, _22, _31, _32.

[in] pointCount

Tamaño de la matriz de transformación. Este valor siempre es 6, porque se usa una matriz 3x2 para todas las transformaciones de manipulación directa.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Llame a esta función para especificar la posición de la ventanilla, el escalado y la orientación en la pantalla. La posición de la ventanilla, el escalado, la orientación y el tamaño se determinan de forma única por la transformación de ventanilla y el rectángulo de la ventanilla. La aplicación puede especificar la transformación de ventanilla mediante este método y el rectángulo de ventanilla mediante SetViewportRect.

El rectángulo de ventanilla (el área rectangular dentro del contenido visible para el usuario) se especifica en coordenadas de ventanilla. Si el rectángulo de ventanilla superior izquierda es (0,0), el rectángulo de la ventanilla se coloca exactamente en el origen del sistema de coordenadas de ventanilla. Los desplazamientos de ventanilla desde el origen del sistema de coordenadas de ventanilla se pueden especificar de dos maneras:

• A través del rectángulo de ventanilla superior izquierda
• Mediante el componente de traducción de transformación de ventanilla (_31, _32)

La transformación de ventanilla se convierte desde el sistema de coordenadas de ventanilla al sistema de coordenadas del cliente de la ventana. La manipulación directa omite la propiedad RTL de la ventana, por lo que el origen del área de cliente siempre es el punto superior izquierdo. Las transformaciones se aplican en el orden siguiente:

1. Desplazamiento del rectángulo de ventanilla
2. Transformación de ventanilla (desde la ventanilla al sistema de coordenadas de cliente)
3. Asignación de cliente a pantalla (desde el cliente al sistema de coordenadas de pantalla)

Requisitos

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

Consulte también

IDirectManipulationViewport