Partager via


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

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

Voir aussi

Découpage

Découpage avec une région

CombineMode

GetClipBounds, méthodes

Graphismes

Graphics::GetClip

Graphics::IsClipEmpty

Graphics::ResetClip

Méthodes IntersectClip

TranslateClip, méthodes