Method function IGDIPlus.IGPGraphics.ExcludeClip(IGPRegion) : TGPGraphics

Latest revision as of 17:19, 18 October 2012

This is a Beta Read Only version of this page. Please review and send recommendations to mitov@mitov.com. We will enable the editing as soon as we are happy with the overall Wiki site.

Class: IGPGraphics

Syntax

Delphi:

function ExcludeClip( region : IGPRegion ) : TGPGraphics;

C++ Builder:

TGPGraphics __fastcall ExcludeClip( IGPRegion region );

Visual C++ (MFC):

ExcludeClip(  region );

Summary

Updates the clipping region with the portion of itself that does not overlap the specified region.

Description

Call this method to update the clipping region with the portion of itself that does not overlap the specified region.

Example:

The following example uses a rectangle to update a clipping region and then draws a rectangle that demonstrates the updated clipping region.

var
  AGraphics : IGPGraphics;
  AExcludeRegion : IGPRegion;


begin
  AGraphics := TGPGraphics.Create( ACanvas );

  // Create a Region object, and set the clipping region to its exclusion.
  AExcludeRegion := TGPRegion.Create(MakeRect(100, 100, 200, 200));

  AGraphics.ExcludeClip( AExcludeRegion );

  // Fill a rectangle to demonstrate the clipping region.
  AGraphics.FillRectangle( TGPSolidBrush( aclRed ), 0, 0, 600, 600 );
end;