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

Artículo
07/16/2024

El método PathGradientBrush::GetRectangle obtiene el rectángulo más pequeño que incluye la ruta de acceso de límite de este pincel de degradado de ruta de acceso.

Sintaxis

Status GetRectangle(
  RectF *rect
);

Parámetros

rect

Puntero a un objeto rectF de que recibe el rectángulo delimitador.

Valor devuelto

Tipo de : estado de

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status Status.

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Observaciones

Ejemplos

En el ejemplo siguiente se crea un PathGradientBrush objeto basado en un polígono definido por cuatro puntos. El código llama al método PathGradientBrush::GetRectangle del objeto PathGradientBrush para obtener el rectángulo más pequeño que incluye la ruta de acceso de límite del pincel. El código llama al método Graphics::FillRectangle de un objeto Graphics, pasando la dirección del objeto PathGradientBrush y una referencia al rectángulo delimitador del pincel. Esa llamada rellena solo la parte del rectángulo delimitador que está dentro de la ruta de acceso de límite del pincel. Por último, el código dibuja el contorno del rectá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);
}