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:
Robert Roebling
2008-04-29 11:34:42 +00:00
parent ea0775711c
commit 318b0bd544

View File

@@ -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