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

O método TextureBrush::SetWrapMode define o modo de encapsulamento desse pincel de textura.

Sintaxe

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parâmetros

[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.

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

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. A inversão 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á em bloco. 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 peças).

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.

Exemplos

O exemplo a seguir cria um pincel de textura, define o modo de encapsulamento do pincel e usa o pincel para preencher um retângulo.

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

   Image image(L"HouseAndTree.gif");
   TextureBrush textureBrush(&image);
   textureBrush.SetWrapMode(WrapModeTileFlipX);
   graphics.FillRectangle(&textureBrush, 0, 0, 400, 200);
}

Requisitos

Confira também

Pincéis e formas preenchidas

Preenchendo uma forma com uma textura de imagem

Texturebrush

TextureBrush::GetWrapMode

Tiling a Shape with an Image

Wrapmode