Método PathGradientBrush::SetWrapMode (gdipluspath.h)

Artigo
03/13/2024

O método PathGradientBrush::SetWrapMode define o modo de encapsulamento desse pincel de gradiente de caminho.

Sintaxe

Status SetWrapMode(
  [in] WrapMode wrapMode
);

Parâmetros

[in] wrapMode

Tipo: WrapMode

Elemento da enumeração WrapMode que especifica como as áreas pintadas com o pincel de gradiente de caminho serão lado a lado. O valor padrão é WrapModeClamp.

Retornar valor

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

O retângulo delimitador de um pincel de gradiente de caminho é o menor retângulo que inclui o caminho de limite do pincel. Quando você pinta o retângulo delimitador com o pincel de gradiente de caminho, somente a área dentro do caminho de limite é preenchida. A área dentro do retângulo delimitador, mas fora do caminho de limite, não é preenchida.

WrapModeClamp (o modo de encapsulamento padrão) indica que nenhuma pintura ocorre fora do retângulo delimitador do pincel. Todos os outros modos de encapsulamento indicam que áreas fora do retângulo delimitador do pincel serão lado a lado. Cada bloco é uma cópia (possivelmente invertida) do caminho preenchido dentro de seu retângulo delimitador.

Exemplos

O exemplo a seguir cria um objeto PathGradientBrush com base em um caminho triangular. O código chama o método PathGradientBrush::SetWrapMode do objeto PathGradientBrush para definir o modo de encapsulamento do pincel como WrapModeTileFlipX. O método Graphics::FillRectangle usa o pincel de gradiente de caminho para colocar em bloco uma área grande.

A saída do código é uma grade de blocos. Conforme você passa de um bloco para o próximo em uma determinada linha, a imagem (caminho de limite preenchido dentro do retângulo delimitador) é invertida horizontalmente.

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

   Point points[] = {
      Point(0, 0), 
      Point(100, 0), 
      Point(100, 100)};

   Color colors[] = {
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      Color(255, 0, 255, 0)};  // green

   INT count = 3;

   PathGradientBrush pthGrBrush(points, 3);
   pthGrBrush.SetSurroundColors(colors, &count);
   pthGrBrush.SetWrapMode(WrapModeTileFlipX);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 800, 800); 
}

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	gdipluspath.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll