Método PathGradientBrush::GetRectangle(RectF*) (gdipluspath.h)

Artigo
02/26/2024

O método PathGradientBrush::GetRectangle obtém o menor retângulo que inclui o caminho de limite desse pincel de gradiente de caminho.

Sintaxe

Status GetRectangle(
  RectF *rect
);

Parâmetros

rect

Ponteiro para um objeto RectF que recebe o retângulo delimitador.

Retornar valor

Type: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

Exemplos

O exemplo a seguir cria um objeto PathGradientBrush baseado em um polígono definido por quatro pontos. O código chama o método PathGradientBrush::GetRectangle do objeto PathGradientBrush para obter o menor retângulo que inclui o caminho de limite do pincel. O código chama o método Graphics::FillRectangle de um objeto Graphics, passando o endereço do objeto PathGradientBrush e uma referência ao retângulo delimitador do pincel. Essa chamada preenche apenas a parte do retângulo delimitador que está dentro do caminho de limite do pincel. Por fim, o código desenha a estrutura de tópicos do retângulo delimitador.

VOID Example_GetRect(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 0));

   // Create a path gradient brush based on an array of points.
   Point points[] = {
      Point(30, 20),
      Point(150, 40),
      Point(100, 100),
      Point(60, 200) };

   PathGradientBrush pthGrBrush(points, 4);

   // Obtain information about the path gradient brush.
   RectF rect;
   pthGrBrush.GetRectangle(&rect);

   graphics.FillRectangle(&pthGrBrush, rect);
   graphics.DrawRectangle(&pen, rect);
}