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

Artículo
02/29/2024

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