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 |