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

Artigo
08/23/2023

O método LinearGradientBrush::SetWrapMode define o modo de encapsulamento desse pincel de gradiente linear.

Sintaxe

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parâmetros

[in] wrapMode

Tipo: WrapMode

Elemento da enumeração WrapMode que especifica como as áreas pintadas com esse pincel de gradiente linear serão lado a lado. O valor desse parâmetro deve ser um dos seguintes elementos:

WrapModeTile
WrapModeTileFlipX
WrapModeTileFlipY
WrapModeTileFlipXY

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

As linhas de limite de um pincel de gradiente linear formam um bloco. Quando você pinta uma área com um pincel de gradiente linear, o bloco se repete. Um pincel de gradiente linear pode ter blocos alternativos invertidos em uma determinada direção, conforme especificado pelo modo de encapsulamento. Inverter tem o efeito de reverter a ordem das cores.

O modo de encapsulamento assume como padrão WrapModeTile quando um objeto LinearGradientBrush é construído.

Exemplos

O exemplo a seguir cria um pincel de gradiente linear e o usa para preencher um retângulo. Em seguida, o código modifica o modo de encapsulamento do pincel e usa o pincel modificado para preencher outro retângulo.

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

   LinearGradientBrush linGrBrush( 
      Rect(0, 0, 100, 50),
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 0, 255),  // blue
      LinearGradientModeHorizontal);

   // Fill a large area using the gradient brush with the default wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 800, 50);

   linGrBrush.SetWrapMode(WrapModeTileFlipX);

   // Fill a large area using the gradient brush with the new wrap mode.
   myGraphics.FillRectangle(&linGrBrush, 0, 75, 800, 50);
}

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