Método TextureBrush::SetTransform (gdiplusbrush.h)

Artigo
08/24/2023

O método TextureBrush::SetTransform define a matriz de transformação desse pincel de textura.

Sintaxe

Status SetTransform(
  [in] const Matrix *matrix
);

Parâmetros

[in] matrix

Tipo: const Matrix*

Ponteiro para um objeto Matrix que especifica a matriz de transformação a ser usada.

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Um objeto TextureBrush mantém uma matriz de transformação que pode armazenar qualquer transformação de afins. Quando você usa um pincel de textura para preencher uma área, o Windows GDI+ transforma a imagem do pincel de acordo com a matriz de transformação do pincel e preenche a área. A imagem transformada existe somente durante a renderização; a imagem armazenada no objeto TextureBrush não é transformada. Por exemplo, suponha que você chame e pinte uma área com someTextureBrush.ScaleTransform(3) e, em seguida, pinte uma área com someTextureBrush. A largura da imagem do pincel triplica quando a área é pintada, mas a imagem armazenada em someTextureBrush permanece inalterada.

Exemplos

O exemplo a seguir cria um pincel de textura e define a transformação do pincel. Em seguida, o código usa o pincel transformado para preencher uma elipse.

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

   Matrix matrix(2, 0, 0, 1, 0, 0);  // Horizontal stretch

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetTransform(&matrix);
   graphics.FillEllipse(&textureBrush, 0, 0, 400, 200); 
}

Requisitos


Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusbrush.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll