wxDCClipper Class Reference

#include <wx/dc.h>

Detailed Description

wxDCClipper is a helper class for setting a clipping region on a wxDC during its lifetime.

An object of wxDCClipper class is typically created on the stack so that it is automatically destroyed when the object goes out of scope. A typical usage example:

void MyFunction(wxDC& dc)
{
    wxDCClipper clip(dc, rect);
    // ... drawing functions here are affected by clipping rect ...
}
 
void OtherFunction()
{
    wxDC dc;
    MyFunction(dc);
    // ... drawing functions here are not affected by clipping rect ...
}

Note

Since 3.1.1 wxDCClipper restores the previously active clipping region when it is destroyed. Previously it reset clipping on the associated wxDC and this has to be taken into account explicitly in previous wxWidgets versions.

Library:  wxCore

Category:  Graphics Device Interface (GDI)

See also

wxDC::SetClippingRegion(), wxDCFontChanger, wxDCTextColourChanger, wxDCPenChanger, wxDCBrushChanger

Public Member Functions
	~wxDCClipper ()
	Destroys the clipping region associated with the DC passed to the ctor. More...
	wxDCClipper (wxDC &dc, const wxRegion &region)
	Sets the clipping region to the specified region/coordinates. More...
	wxDCClipper (wxDC &dc, const wxRect &rect)
	Sets the clipping region to the specified region/coordinates. More...
	wxDCClipper (wxDC &dc, wxCoord x, wxCoord y, wxCoord w, wxCoord h)
	Sets the clipping region to the specified region/coordinates. More...

Constructor & Destructor Documentation

wxDCClipper() [1/3]

wxDCClipper::wxDCClipper	(	wxDC &	dc,
		const wxRegion &	region
	)

Sets the clipping region to the specified region/coordinates.

The clipping region is automatically unset when this object is destroyed.

wxDCClipper() [2/3]

wxDCClipper::wxDCClipper	(	wxDC &	dc,
		const wxRect &	rect
	)

Sets the clipping region to the specified region/coordinates.

The clipping region is automatically unset when this object is destroyed.

wxDCClipper() [3/3]

wxDCClipper::wxDCClipper	(	wxDC &	dc,
		wxCoord	x,
		wxCoord	y,
		wxCoord	w,
		wxCoord	h
	)

Sets the clipping region to the specified region/coordinates.

The clipping region is automatically unset when this object is destroyed.

~wxDCClipper()

wxDCClipper::~wxDCClipper

(

)

Destroys the clipping region associated with the DC passed to the ctor.