Compartilhar via


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

Cria um objeto TextureBrush com base em uma imagem e um modo de encapsulamento. O tamanho do pincel usa como padrão o tamanho da imagem, portanto, toda a imagem é usada pelo pincel.

Sintaxe

void TextureBrush(
  [in] Image    *image,
  [in] WrapMode wrapMode
);

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

Opcional. 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. O valor padrão é WrapModeTile.

Valor retornado

Nenhum

Comentários

Uma área que se estende além dos limites do pincel é lado a lado com cópias repetidas do pincel. Um pincel de textura pode ter blocos alternativos invertidos em uma determinada direção, conforme especificado pelo modo de encapsulamento. Inverter tem o efeito de reverter a imagem do pincel. Por exemplo, se o modo de encapsulamento for especificado como WrapModeTileFlipX, o pincel será invertido sobre uma linha paralela ao eixo y.

O pincel de textura é sempre orientado em (0, 0). Se o modo de encapsulamento for especificado como WrapModeClamp, nenhuma área fora do pincel será lado a lado. Por exemplo, suponha que você crie um pincel de textura, especificando WrapModeClamp como o modo de encapsulamento:

TextureBrush(&SomeImage, WrapModeClamp)

Em seguida, você pinta uma área com o pincel. Se o tamanho do pincel tiver uma altura de 50 e a área pintada for um retângulo com seu canto superior esquerdo em (0, 50), você não verá cópias repetidas do pincel (sem lado).

O modo de encapsulamento padrão para um pincel de textura é WrapModeTile, que não especifica nenhuma inversão do bloco e nenhuma fixação.

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

Confira também

Pincéis e formas preenchidas

Imagem

Texturebrush

TextureBrush::GetWrapMode

TextureBrush::SetWrapMode

Usando um pincel para preencher formas

Wrapmode