Método PathGradientBrush::TranslateTransform (gdipluspath.h)

Artículo
08/24/2023

El método PathGradientBrush::TranslateTransform actualiza la matriz de transformación actual de este pincel con el producto de sí mismo y una matriz de traducción.

Sintaxis

Status TranslateTransform(
  [in] REAL        dx,
  [in] REAL        dy,
  [in] 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] order

Tipo: MatrixOrder

Opcional. Elemento de la enumeración MatrixOrder que especifica el orden de la 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 realiza 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

Una sola matriz de 3 ×3 puede almacenar cualquier secuencia de transformaciones afín. Si tiene varias matrices de 3 ×3, cada una de las cuales representa una transformación afín, el producto de esas matrices es una sola matriz de 3 ×3 que representa toda la secuencia de transformaciones. La transformación representada por ese producto se denomina transformación compuesta. Por ejemplo, supongamos que la matriz S representa un escalado y una matriz T representa una traducción. Si la matriz M es el ST del producto, la matriz M representa una transformación compuesta: la primera escala y, a continuación, se traduce.

Ejemplos

En el ejemplo siguiente se crea un objeto PathGradientBrush basado en una ruta triangular. Las llamadas a los métodos PathGradientBrush::ScaleTransform y PathGradientBrush::TranslateTransform del objeto PathGradientBrush establecen los elementos de la matriz de transformación del pincel para que represente una transformación compuesta: primero escale y traduzca. El código usa el pincel degradado de ruta dos veces para pintar un rectángulo: una vez antes de establecer la transformación y una vez después de establecer la transformación.

VOID Example_TranslateTrans(HDC hdc)
{
   Graphics graphics(hdc);

   Point pts[] = {Point(0, 0), Point(50, 0), Point(50, 50)};
   PathGradientBrush pthGrBrush(pts, 3);

   // Fill an area with the path gradient brush (no transformation).
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);

   pthGrBrush.ScaleTransform(3.0f, 1.0f);
   pthGrBrush.TranslateTransform(100.0f, 50.0f, MatrixOrderAppend);

   // Fill the same area with the transformed path gradient brush.
   graphics.FillRectangle(&pthGrBrush, 0, 0, 500, 500);  
}

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	gdipluspath.h (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll