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

Artigo
08/23/2023

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

Sintaxe

Status GetTransform(
  [out] Matrix *matrix
);

Parâmetros

[out] matrix

Tipo: Matriz*

Ponteiro para um objeto Matrix que recebe a matriz de transformação.

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 afim. Quando você usa um pincel de textura para preencher uma área, o 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 someTextureBrush.ScaleTransform(3) e 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 obtém a matriz de transformação do pincel e prossegue para inspecionar ou usar os elementos.

VOID Example_GetTransform(HDC hdc)
{
   Graphics graphics(hdc);
  
   // Create a texture brush, and set its transform.
   Image image(L"marble.jpg");
   TextureBrush textureBrush(&image);
   textureBrush.ScaleTransform(3, 2);

   // Obtain information about the texture brush.
   Matrix matrix;
   REAL elements[6];

   textureBrush.GetTransform(&matrix);
   matrix.GetElements(elements);

   for(INT j = 0; j <=5; ++j)
   {
      // Inspect or use the value in elements[j].
   }
}

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