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

Artigo
08/23/2023

O método LinearGradientBrush::GetWrapMode obtém o modo de encapsulamento para esse pincel. O modo de encapsulamento determina como uma área é remendada quando é pintada com um pincel.

Sintaxe

WrapMode GetWrapMode();

Valor retornado

Tipo: WrapMode

Esse método retorna um dos seguintes elementos da enumeração WrapMode :

WrapModeTile
WrapModeTileFlipX
WrapModeTileFlipY
WrapModeTileFlipXY

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 padrão para um pincel de gradiente linear é WrapModeTile, que indica que nenhuma inversão ocorre.

Exemplos

O exemplo a seguir cria um pincel de gradiente linear e define seu modo de encapsulamento. Em seguida, o código obtém o modo de encapsulamento do pincel e executa tarefas com base no modo de encapsulamento atual do pincel.

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

   // Create a linear gradient brush, and set its wrap mode.
   LinearGradientBrush linGrBrush( 
      Point(0,0),
      Point(200, 0),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   linGrBrush.SetWrapMode(WrapModeTileFlipX);

   // Obtain information about the linear gradient brush.
   WrapMode wrapMode;
   wrapMode = linGrBrush.GetWrapMode();

   if (wrapMode == WrapModeTileFlipX)
   {
       // Do some task. 
   }
   else if (wrapMode == WrapModeTileFlipY)
   {
       // Do a different task.
   }
}

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