Condividi tramite


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

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

Vedi anche

Ritaglio

Ritaglio con un'area

CombineMode

Metodi GetClipBounds

Grafica

Grafica::GetClip

Grafica::IsClipEmpty

Grafica::ResetClip

Metodi IntersectClip

Metodi TranslateClip