Método LinearGradientBrush::GetRectangle(Rect*) (gdiplusbrush.h)

Artículo
08/23/2023

El método LinearGradientBrush::GetRectangle obtiene el rectángulo que define los límites del degradado.

Sintaxis

Status GetRectangle(
  [out] Rect *rect
);

Parámetros

[out] rect

Tipo: Rect*

Puntero a un objeto Rect que recibe el rectángulo que define los límites del degradado. Por ejemplo, si un pincel de degradado lineal se construye con un punto inicial en (20, 50) y un punto final en (60, 110), el rectángulo que define tiene su punto superior izquierdo en (20, 50), un ancho de 40 y un alto de 60.

Valor devuelto

Tipo: Estado

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

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

Comentarios

El rectángulo define los límites del degradado de las siguientes maneras: los lados derecho e izquierdo del rectángulo forman los límites de un degradado horizontal. Los lados superior e inferior forman los límites de un degradado vertical. Dos de las esquinas diagonalmente opuestas se encuentran en los límites de un degradado diagonal. En cada uno de estos casos, cualquiera de los lados o esquinas puede estar en el límite inicial, dependiendo de cómo se pasan los puntos iniciales y finales al constructor.

Ejemplos

En el ejemplo siguiente se crea un pincel de degradado lineal. A continuación, el código obtiene el rectángulo del pincel y lo dibuja.

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

   // Create a linear gradient brush.
   LinearGradientBrush linGrBrush( 
      Point(20, 10),
      Point(60, 110),
      Color(255, 0, 0, 0),     // black
      Color(255, 0, 0, 255));  // blue

   // Obtain information about the linear gradient brush.
   Rect rect;
   linGrBrush.GetRectangle(&rect);

   // Draw the retrieved rectangle.
   Pen myPen(Color(255, 0, 0, 0));
   myGraphics.DrawRectangle(&myPen, rect);
}

Requisitos


Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusbrush.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll