LinearGradientBrush::GetRectangle(Rect*), méthode (gdiplusbrush.h)

La méthode LinearGradientBrush::GetRectangle obtient le rectangle qui définit les limites du dégradé.

Syntaxe

Status GetRectangle(
  [out] Rect *rect
);

Paramètres

[out] rect

Type : Rect*

Pointeur vers un objet Rect qui reçoit le rectangle qui définit les limites du dégradé. Par exemple, si un pinceau de dégradé linéaire est construit avec un point de départ à (20, 50) et un point de fin à (60, 110), le rectangle de définition a son point supérieur gauche à (20, 50), une largeur de 40 et une hauteur de 60.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

Le rectangle définit les limites du dégradé de la manière suivante : Les côtés droit et gauche du rectangle forment les limites d’un dégradé horizontal. Les côtés supérieur et inférieur forment les limites d’un dégradé vertical. Deux des coins diagonalement opposés se trouvent sur les limites d’un dégradé diagonal. Dans chacun de ces cas, chaque côté/coin peut se trouver sur la limite de départ, en fonction de la façon dont les points de départ et de fin sont passés au constructeur.

Exemples

L’exemple suivant crée un pinceau de dégradé linéaire. Ensuite, le code obtient le rectangle du pinceau et le dessine.

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

Spécifications

Voir aussi

Pinceaux et formes remplies

Création d’un dégradé linéaire

LinearGradientBrush

Stylet

Stylos, lignes et rectangles

Point

Rect

Utilisation d’un stylo pour tracer des lignes et des rectangles