Graphics::SetClip Method (Region^, CombineMode)

 

Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified Region.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public:
void SetClip(
	Region^ region,
	CombineMode combineMode
)

Parameters

region
Type: System.Drawing::Region^

Region to combine.

combineMode
Type: System.Drawing.Drawing2D::CombineMode

Member from the CombineMode enumeration that specifies the combining operation to use.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a small rectangle for the clipping region.

  • Sets the clipping region to the rectangle with the Replace member.

  • Fills a large rectangle with a solid black brush.

The result is a small, filled, black rectangle.

public:
   void SetClipRegionCombine( PaintEventArgs^ e )
   {
      // Create region for clipping.
      System::Drawing::Region^ clipRegion = gcnew System::Drawing::Region( Rectangle(0,0,100,100) );

      // Set clipping region of graphics to region.
      e->Graphics->SetClip( clipRegion, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }

.NET Framework
Available since 1.1
Return to top
Show: