Método TextureBrush::TextureBrush(Image,constRect&,constImageAttributes) (gdiplusbrush.h)

Artigo
01/10/2024

Cria um objeto TextureBrush com base em uma imagem, um retângulo definidor e um conjunto de propriedades de imagem.

Sintaxe

void TextureBrush(
  [in]      Image                 *image,
  [in, ref] const Rect &          dstRect,
  [in]      const ImageAttributes *imageAttributes
);

Parâmetros

[in] image

Tipo: Imagem*

Ponteiro para um objeto Image que contém o bitmap da imagem a ser usada.

[in, ref] dstRect

Tipo: Rect

Referência a um retângulo que define o tamanho desse pincel de textura e a parte da imagem a ser usada por esse pincel de textura. Se o objeto Image for criado a partir de um metarquivo, o pincel usará toda a imagem, que é dimensionada para se ajustar ao tamanho do pincel.

[in] imageAttributes

Tipo: ImageAttributes*

Opcional. Ponteiro para um objeto ImageAttributes que contém propriedades da imagem. O valor padrão é NULL.

Retornar valor

Nenhum

Comentários

A largura e a altura do retângulo dstRect definem a largura e a altura de um pincel de textura. Um pincel de textura é sempre orientado em (0, 0). O ponto superior esquerdo, a largura e a altura do retângulo especificam o ponto inicial, a largura e a altura da parte da imagem a ser usada por um pincel de textura.

Como esse construtor usa o retângulo dstRect com imagens não estruturais

Se as dimensões do retângulo dstRect forem menores do que as da imagem na qual o pincel se baseia, a imagem do pincel será cortada , ela será uma parte da imagem. Se as dimensões do retângulo dstRect forem iguais às da imagem, a imagem do pincel será idêntica à imagem. O retângulo dstRect não deve incluir áreas fora das dimensões da imagem. Isso produzirá um comportamento imprevisível ou gerará um erro em tempo de execução. Por exemplo, suponha que você tenha uma imagem de 256 × 256 pixels e crie um objeto TextureBrush com base nessa imagem, passando como o parâmetro dstRect . O pincel usará a parte inferior esquerda da imagem. O canto inferior esquerdo dessa parte também é o canto inferior esquerdo da imagem. Agora suponha que você crie outro objeto TextureBrush com base na mesma imagem, passando como o parâmetro dstRect . Observe que esse retângulo tem sua coordenada superior em 157 em vez de 156. Esse retângulo estende uma unidade além da altura da imagem e provavelmente gerará uma violação de acesso.

Como esse construtor usa o retângulo dstRect com imagens de metarquivo

Se as dimensões do retângulo dstRect forem diferentes das da imagem, a imagem do pincel será dimensionada menor ou maior conforme necessário para caber no retângulo. Por exemplo, suponha que você tenha uma imagem de metarquivo com 256 pixels ×256 e crie um objeto TextureBrush , passando como o parâmetro dstRect . A imagem do pincel incluirá toda a imagem de metarquivo, mas será dimensionada para caber no pincel: ela será esplêndida verticalmente e estendida horizontalmente. Se as dimensões do retângulo forem iguais às da imagem, a imagem do pincel será idêntica à imagem.

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