Compartir a través de


Método Graphics::TranslateTransform (gdiplusgraphics.h)

El método Graphics::TranslateTransform actualiza la matriz de transformación del mundo de este objeto Graphics con el producto de sí mismo y una matriz de traducción.

Sintaxis

Status TranslateTransform(
  [in]           REAL        dx,
  [in]           REAL        dy,
  [in, optional] MatrixOrder order
);

Parámetros

[in] dx

Tipo: REAL

Número real que especifica el componente horizontal de la traducción.

[in] dy

Tipo: REAL

Número real que especifica el componente vertical de la traducción.

[in, optional] order

Tipo: MatrixOrder

Opcional. Elemento de la enumeración MatrixOrder que especifica el orden de multiplicación. MatrixOrderPrepend especifica que la matriz de traducción está a la izquierda y MatrixOrderAppend especifica que la matriz de traducción está a la derecha. El valor predeterminado es MatrixOrderPrepend.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Nota GDI+ controla los pinceles de forma diferente cuando la escala de transformación del mundo es inferior a 100%(1,0f) en la dirección x o y. Si la escala de transformación del mundo es inferior al 100 % (1,0f), asegúrese de multiplicar el desplazamiento de TranslateTransform por la escala de transformación mundial.
 

Ejemplos

En el ejemplo siguiente se establece la transformación mundial de un objeto Graphics en una rotación. La llamada a Graphics::TranslateTransform multiplica la matriz de transformación mundial (rotación) del objeto Graphics por una matriz de traducción. El argumento MatrixOrderAppend especifica que la multiplicación se realiza con la matriz de traducción a la derecha. En ese momento, la matriz de transformación mundial del objeto Graphics representa una transformación compuesta: gire primero y, a continuación, traduzca. La llamada a DrawEllipse dibuja una elipse girada y traducida.

VOID Example_TranslateTransform(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 255));

   graphics.RotateTransform(30.0f);
   graphics.TranslateTransform(100.0f, 50.0f, MatrixOrderAppend);
   graphics.DrawEllipse(&pen, 0, 0, 200, 80);
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado gdiplusgraphics.h (include Gdiplus.h)
Library Gdiplus.lib
Archivo DLL Gdiplus.dll

Consulte también

Sistemas de coordenadas y transformaciones

Elementos gráficos

Graphics::GetTransform

Graphics::ResetTransform

Graphics::ScaleTransform

Graphics::SetTransform

Graphics::TransformPoints

Matriz

MatrixOrder

Transformaciones