Graphics::SetClip(HRGN,CombineMode) , méthode (gdiplusgraphics.h)

Article
08/24/2023

La méthode Graphics::SetClip met à jour la zone de découpage de cet objet Graphics en une région qui est la combinaison de lui-même et d’une région GDI (Graphics Device Interface) Windows.

Syntaxe

Status SetClip(
  [in] HRGN        hRgn,
  [in] CombineMode combineMode
);

Paramètres

[in] hRgn

Type : HRGN

Gérez vers une région GDI à combiner avec la zone de découpage de cet objet Graphics . Ceci est fourni pour le code hérité. Les nouvelles applications doivent passer un objet Region comme premier paramètre.

[in] combineMode

Type : CombineMode

Optionnel. Élément de l’énumération CombineMode qui spécifie comment la région GDI est combinée avec la zone de découpage de cet objet Graphics . La valeur par défaut est CombineModeReplace.

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

Cette méthode suppose que la région GDI spécifiée par hRgn est déjà en unités d’appareil, de sorte qu’elle ne transforme pas les coordonnées de la région GDI.

Exemples

L’exemple suivant utilise une région GDI pour mettre à jour la région de découpage.

VOID Example_SetClip2(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Region object, and get its handle.
   Region region(Rect(0, 0, 100, 100));
   HRGN hRegion = region.GetHRGN(&graphics);

   // Set the clipping region with hRegion.
   graphics.SetClip(hRegion);

   // Fill a rectangle to demonstrate the clipping region.
   graphics.FillRectangle(&SolidBrush(Color(255, 0, 0, 0)), 0, 0, 500, 500);
}

Spécifications


Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdiplusgraphics.h (include Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll