Metodo Graphics::SetClip(HRGN,CombineMode) (gdiplusgraphics.h)

Articolo
08/24/2023

Il metodo Graphics::SetClip aggiorna l'area di ritaglio di questo oggetto Graphics in un'area che rappresenta la combinazione di se stessa e un'area GDI (Windows Graphics Device Interface).

Sintassi

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

Parametri

[in] hRgn

Tipo: HRGN

Handle in un'area GDI da combinare con l'area di ritaglio di questo oggetto Graphics . Viene fornito per il codice legacy. Le nuove applicazioni devono passare un oggetto Region come primo parametro.

[in] combineMode

Tipo: CombineMode

Facoltativa. Elemento dell'enumerazione CombineMode che specifica come l'area GDI viene combinata con l'area di ritaglio di questo oggetto Graphics . Il valore predefinito è CombineModeReplace.

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

Questo metodo presuppone che l'area GDI specificata da hRgn sia già in unità dispositivo, quindi non trasforma le coordinate dell'area GDI.

Esempio

Nell'esempio seguente viene usata un'area GDI per aggiornare l'area di ritaglio.

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

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	gdiplusgraphics.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll