Metodo LinearGradientBrush::GetRectangle(Rect*) (gdiplusbrush.h)

Articolo
08/23/2023

Il metodo LinearGradientBrush::GetRectangle ottiene il rettangolo che definisce i limiti della sfumatura.

Sintassi

Status GetRectangle(
  [out] Rect *rect
);

Parametri

[out] rect

Tipo: Rect*

Puntatore a un oggetto Rect che riceve il rettangolo che definisce i limiti della sfumatura. Ad esempio, se un pennello a sfumatura lineare viene costruito con un punto iniziale a (20, 50) e un punto finale a (60, 110), il rettangolo di definizione ha il punto superiore sinistro in corrispondenza (20, 50), una larghezza di 40 e un'altezza di 60.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Il rettangolo definisce i limiti della sfumatura nei modi seguenti: i lati destro e sinistro del rettangolo formano i limiti di una sfumatura orizzontale. I lati superiore e inferiore formano i limiti di una sfumatura verticale. Due degli angoli diagonalmente opposti si trovano sui limiti di una sfumatura diagonale. In ognuno di questi casi, entrambi gli angoli/lati possono trovarsi nel limite iniziale, a seconda del modo in cui i punti iniziali e finali vengono passati al costruttore.

Esempio

Nell'esempio seguente viene creato un pennello sfumatura lineare. Il codice ottiene quindi il rettangolo del pennello e lo disegna.

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);
}

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusbrush.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll