Método TextureBrush::TextureBrush(Image*,WrapMode,REAL,REAL,REAL,REAL) (gdiplusbrush.h)

Cria um objeto TextureBrush com base em uma imagem, um modo de encapsulamento e um conjunto definidor de coordenadas.

Sintaxe

void TextureBrush(
  [in] Image    *image,
  [in] WrapMode wrapMode,
  [in] REAL     dstX,
  [in] REAL     dstY,
  [in] REAL     dstWidth,
  [in] REAL     dstHeight
);

Parâmetros

[in] image

Tipo: Imagem*

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

[in] wrapMode

Tipo: WrapMode

Elemento da enumeração WrapMode que especifica como cópias repetidas de uma imagem são usadas para colocar em bloco uma área quando ela é pintada com esse pincel de textura.

[in] dstX

Tipo: REAL

Coordenada mais à esquerda da parte da imagem a ser usada por esse pincel.

[in] dstY

Tipo: REAL

Coordenada superior da parte da imagem a ser usada por esse pincel.

[in] dstWidth

Tipo: REAL

Largura do pincel e largura da parte da imagem a ser usada pelo pincel.

[in] dstHeight

Tipo: REAL

Altura do pincel e altura da parte da imagem a ser usada pelo pincel.

Retornar valor

Nenhum

Comentários

Os parâmetros dstX, dstY, dstWidth e dstHeight especificam um retângulo. O tamanho do pincel é definido por dstWidth e dstHeight. Os parâmetros dstX e dstY não têm efeito sobre o tamanho ou a posição do pincel — o pincel é sempre orientado em (0, 0). Os parâmetros dstX, dstY, dstWidth e dstHeight definem a parte da imagem a ser usada pelo pincel.

Por exemplo, suponha que você tenha uma imagem armazenada em um objeto Image e tenha 256 pixels ×512 (largura ×height). Em seguida, você cria um objeto TextureBrush com base nessa imagem da seguinte maneira:

TextureBrush(&someImage, WrapModeTile, 12, 50, 100, 150)

O pincel terá uma largura de 100 unidades e uma altura de 150 unidades. O pincel usará uma parte retangular da imagem. Essa parte começa no pixel com coordenadas (12, 50). A largura e a altura da parte são 100 e 150, respectivamente, medidas do pixel inicial.

Agora, suponha que você crie outro objeto TextureBrush com base na mesma imagem e especifique um retângulo diferente:

TextureBrush(&someImage, WrapModeTile, 0, 0, 256, 512)

O pincel terá largura e altura iguais a 256 e 512, respectivamente. O pincel usará toda a imagem em vez de uma parte dela porque o retângulo especifica um pixel inicial em coordenadas (0, 0) e dimensões idênticas às da imagem.

Requisitos

Requisito	Valor
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