removing old files

[wxWidgets.git] / interface / dcclient.h

diff --git a/interface/dcclient.h b/interface/dcclient.h
index b39198cdf5926d064028aa5007e646dc79113b66..5047ac053a6b49650d5b6b433914c55cc0febf09 100644 (file)
--- a/interface/dcclient.h
+++ b/interface/dcclient.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        dcclient.h
-// Purpose:     interface of wxPaintDC
+// Purpose:     interface of wxClientDC and wxPaintDC
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -11,25 +11,25 @@
     @wxheader{dcclient.h}
 
     A wxPaintDC must be constructed if an application wishes to paint on the
-    client area of a window from within an @b OnPaint event.
-    This should normally be constructed as a temporary stack object; don't store
-    a wxPaintDC object. If you have an OnPaint handler, you @e must create a
-    wxPaintDC
-    object within it even if you don't actually use it.
+    client area of a window from within an EVT_PAINT() event handler. This
+    should normally be constructed as a temporary stack object; don't store a
+    wxPaintDC object. If you have an EVT_PAINT() handler, you @e must create a
+    wxPaintDC object within it even if you don't actually use it.
 
-    Using wxPaintDC within OnPaint is important because it automatically
-    sets the clipping area to the damaged area of the window. Attempts to draw
-    outside this area do not appear.
+    Using wxPaintDC within your EVT_PAINT() handler is important because it
+    automatically sets the clipping area to the damaged area of the window.
+    Attempts to draw outside this area do not appear.
 
-    To draw on a window from outside @b OnPaint, construct a wxClientDC object.
+    To draw on a window from outside your EVT_PAINT() handler, construct a
+    wxClientDC object.
 
-    To draw on the whole window including decorations, construct a wxWindowDC object
-    (Windows only).
+    To draw on the whole window including decorations, construct a wxWindowDC
+    object (Windows only).
 
     @library{wxcore}
     @category{dc}
 
-    @see wxDC, wxMemoryDC, wxPaintDC, wxWindowDC, wxScreenDC
+    @see wxDC, wxClientDC, wxMemoryDC, wxWindowDC, wxScreenDC
 */
 class wxPaintDC : public wxWindowDC
 {
@@ -47,14 +47,15 @@ public:
     @wxheader{dcclient.h}
 
     A wxClientDC must be constructed if an application wishes to paint on the
-    client area of a window from outside an @b OnPaint event.
-    This should normally be constructed as a temporary stack object; don't store
-    a wxClientDC object.
+    client area of a window from outside an EVT_PAINT() handler. This should
+    normally be constructed as a temporary stack object; don't store a
+    wxClientDC object.
 
-    To draw on a window from within @b OnPaint, construct a wxPaintDC object.
+    To draw on a window from within an EVT_PAINT() handler, construct a
+    wxPaintDC object instead.
 
-    To draw on the whole window including decorations, construct a wxWindowDC object
-    (Windows only).
+    To draw on the whole window including decorations, construct a wxWindowDC
+    object (Windows only).
 
     @library{wxcore}
     @category{dc}
@@ -77,17 +78,14 @@ public:
     @wxheader{dcclient.h}
 
     A wxWindowDC must be constructed if an application wishes to paint on the
-    whole area of a window (client and decorations).
-    This should normally be constructed as a temporary stack object; don't store
-    a wxWindowDC object.
+    whole area of a window (client and decorations). This should normally be
+    constructed as a temporary stack object; don't store a wxWindowDC object.
 
-    To draw on a window from inside @b OnPaint, construct a wxPaintDC object.
-
-    To draw on the client area of a window from outside @b OnPaint, construct a
-    wxClientDC object.
+    To draw on a window from inside an EVT_PAINT() handler, construct a
+    wxPaintDC object instead.
 
-    To draw on the whole window including decorations, construct a wxWindowDC object
-    (Windows only).
+    To draw on the client area of a window from outside an EVT_PAINT() handler,
+    construct a wxClientDC object.
 
     @library{wxcore}
     @category{dc}