Minor doc improvements
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@53412 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -11,38 +11,36 @@
|
|||||||
@wxheader{dc.h}
|
@wxheader{dc.h}
|
||||||
|
|
||||||
A wxDC is a @e "device context" onto which graphics and text can be drawn.
|
A wxDC is a @e "device context" onto which graphics and text can be drawn.
|
||||||
It is intended to represent a number of output devices in a generic way, so
|
It is intended to represent different output devices and offers a common
|
||||||
a window can have a device context associated with it, and a printer also
|
abstract API for drawing on any of them.
|
||||||
has a device context. In this way, the same piece of code may write to a
|
|
||||||
number of different devices, if the device context is used as a parameter.
|
|
||||||
|
|
||||||
wxWidgets offers alternative drawing classes based on the modern drawing
|
wxWidgets offers an alternative drawing API based on the modern drawing
|
||||||
backends GDI+, CoreGraphics and Cairo. See wxGraphicsContext, wxGraphicsRenderer
|
backends GDI+, CoreGraphics and Cairo. See wxGraphicsContext, wxGraphicsRenderer
|
||||||
and related classes.
|
and related classes.
|
||||||
|
|
||||||
Notice that wxDC is an abstract base class and can't be created directly,
|
wxDC is an abstract base class and cannot be created directly.
|
||||||
please use wxPaintDC, wxClientDC, wxWindowDC, wxScreenDC, wxMemoryDC or
|
Use wxPaintDC, wxClientDC, wxWindowDC, wxScreenDC, wxMemoryDC or
|
||||||
wxPrinterDC.
|
wxPrinterDC.
|
||||||
|
|
||||||
Please note that in addition to the versions of the methods documented
|
In addition to the versions of the methods documented below, there
|
||||||
here, there are also versions which accept single wxPoint parameter instead
|
are also versions which accept single wxPoint parameter instead
|
||||||
of two wxCoord ones or wxPoint and wxSize instead of four of them.
|
of the two wxCoord ones or wxPoint and wxSize instead of the four
|
||||||
|
wxCoord parameters.
|
||||||
|
|
||||||
@note Beginning with wxWidgets 2.9.0 the entire wxDC code has been
|
Beginning with wxWidgets 2.9.0 the entire wxDC code has been
|
||||||
reorganized. All platform dependent code (actual all drawing code)
|
reorganized. All platform dependent code (actually all drawing code)
|
||||||
has been moved into backend classes which derive from a common
|
has been moved into backend classes which derive from a common
|
||||||
wxDCImpl class. The user-visible classes such as wxClientDC and
|
wxDCImpl class. The user-visible classes such as wxClientDC and
|
||||||
wxPaintDC merely forward all calls to the backend implementation.
|
wxPaintDC merely forward all calls to the backend implementation.
|
||||||
|
|
||||||
@section dc_alpha Support for Transparency / Alpha Channel
|
On Mac OS X colours with alpha channel are supported. Instances wxPen
|
||||||
|
or wxBrush that are built from wxColour use the colour's alpha values
|
||||||
On Mac OS X colors with alpha are supported. Instances wxPen or wxBrush
|
when stroking or filling.
|
||||||
that are built from wxColour use the color's alpha values when stroking or filling.
|
|
||||||
|
|
||||||
@library{wxcore}
|
@library{wxcore}
|
||||||
@category{dc,gdi}
|
@category{dc,gdi}
|
||||||
|
|
||||||
@see @ref overview_dc
|
@see @ref overview_dc, wxGraphicsContext
|
||||||
|
|
||||||
@todo Precise definition of default/initial state.
|
@todo Precise definition of default/initial state.
|
||||||
@todo Pixelwise definition of operations (e.g. last point of a line not
|
@todo Pixelwise definition of operations (e.g. last point of a line not
|
||||||
|
Reference in New Issue
Block a user