Método GraphicsPath::GetBounds(RectF*,constMatrix*,constPen*) (gdipluspath.h)

O método GraphicsPath::GetBounds obtém um retângulo delimitador para esse caminho.

Sintaxe

Status GetBounds(
  RectF        *bounds,
  const Matrix *matrix,
  const Pen    *pen
);

Parâmetros

bounds

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

matrix

Opcional. Ponteiro para um objeto Matrix que especifica uma transformação a ser aplicada a esse caminho antes que o retângulo delimitador seja calculado. Esse caminho não é transformado permanentemente; a transformação é usada somente durante o processo de cálculo do retângulo delimitador. O valor padrão é NULL.

pen

Opcional. Ponteiro para um objeto Pen que influencia o tamanho do retângulo delimitador. O retângulo delimitador recebido nos limites será grande o suficiente para colocar esse caminho quando o caminho for desenhado com a caneta especificada por esse parâmetro. Isso garante que o caminho seja delimitado pelo retângulo delimitador mesmo que o caminho seja desenhado com uma caneta larga. O valor padrão é NULL.

Valor de retorno

Tipo de : de 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.

Observações

O retângulo retornado por esse método pode ser maior do que o necessário para colocar o caminho como desenhado pela caneta especificada. O retângulo é calculado para permitir o limite de miter da caneta em cantos afiados e para permitir as tampas finais da caneta.

Exemplos

O exemplo a seguir cria um caminho que tem uma curva e uma elipse. O código desenha o caminho com uma caneta amarela grossa e uma caneta preta fina. O método GraphicsPath::GetBounds recebe o endereço da caneta amarela grossa e calcula um retângulo delimitador para o caminho. Em seguida, o código desenha o retângulo delimitador.

VOID GetBoundsExample(HDC hdc)
{
   Graphics graphics(hdc);
   Pen blackPen(Color(255, 0, 0, 0), 1);
   Pen yellowPen(Color(255, 255, 255, 0), 10);
   Pen redPen(Color(255, 255, 0, 0), 1);

   Point pts[] = {Point(120,120), 
                  Point(200,130), 
                  Point(150,200), 
                  Point(130,180)};

   // Create a path that has one curve and one ellipse.
   GraphicsPath path;
   path.AddClosedCurve(pts, 4);
   path.AddEllipse(120, 220, 100, 40);

   // Draw the path with a thick yellow pen and a thin black pen.
   graphics.DrawPath(&yellowPen, &path);
   graphics.DrawPath(&blackPen, &path);

   // Get the path's bounding rectangle.
   RectF rect;
   path.GetBounds(&rect, NULL, &yellowPen);
   graphics.DrawRectangle(&redPen, rect);  
}

Color(255, 0, 0, 0)Color(255, 255, 0,  0)

Requisitos

Requisito	Valor
cabeçalho	gdipluspath.h

Consulte também

recorte de com um de região

de construção e desenho

criando um de gradiente de caminho

GraphicsPath

de Matriz

caminhos

Pen

do RectF