]> git.saurik.com Git - wxWidgets.git/commitdiff
Removed wxUpdateIterator documentation, added wxRegionIterator documentation.
authorJulian Smart <julian@anthemion.co.uk>
Wed, 4 Nov 1998 22:16:10 +0000 (22:16 +0000)
committerJulian Smart <julian@anthemion.co.uk>
Wed, 4 Nov 1998 22:16:10 +0000 (22:16 +0000)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@961 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/latex/wx/classes.tex
docs/latex/wx/manual.tex
docs/latex/wx/referenc.tex
docs/latex/wx/region.tex
docs/latex/wx/upditer.tex [deleted file]
docs/latex/wx/window.tex

index 56b7f3fadc2c6289ea2a935e2f6bb827597d3a50..e58d9ec11be986a3bc6d9162c1c0788ce5ed89bc 100644 (file)
@@ -171,7 +171,6 @@ $$\image{14cm;0cm}{wxclass.ps}$$
 \input toolbar.tex
 \input treectrl.tex
 \input treeevt.tex
-\input upditer.tex
 \input upduievt.tex
 \input url.tex
 \input validatr.tex
index 5cceeb41068f1beb477f5bbf10afe9950c3e7d28..58365be971670764de316cd4c328e0d5adb32f40 100644 (file)
@@ -30,7 +30,7 @@
 %\winhelponly{\\$$\image{1cm;0cm}{wxwin.wmf}$$}
 }}
 \winhelpignore{\author{Julian Smart}
-\date{July 31st 1998}
+\date{November 4th 1998}
 }
 \makeindex
 \begin{document}
index ea75f9f517f8118a01df2b8ef8af3bdfa4485482..03981d1306d109de89ca7ed76f94a2361cbded4c 100644 (file)
@@ -18,7 +18,7 @@
 \parindent=0pt
 \title{Reference Manual for wxWindows 2.0: a portable C++ GUI toolkit}
 \author{Julian Smart}
-\date{July 31st 1998}
+\date{November 4th 1998}
 
 \makeindex
 \begin{document}
index 1d3c224adae32f5793fed6b3b33fb8d29217d213..a2828e8e244314f4a5791bf86e542b6380f4fcda 100644 (file)
@@ -8,6 +8,10 @@ reference counting, so copying and assignment operations are fast.
 \helpref{wxGDIObject}{wxgdiobject}\\
 \helpref{wxObject}{wxobject}
 
+\wxheading{See also}
+
+\helpref{wxRegionIterator}{wxregioniterator}
+
 \latexignore{\rtfignore{\wxheading{Members}}}
 
 \membersection{wxRegion::wxRegion}\label{wxregionconstr}
@@ -179,4 +183,105 @@ for any overlapping areas. The result is stored in this region.
 
 Copies {\it region} by reference counting.
 
+\section{\class{wxRegionIterator}}\label{wxregioniterator}
+
+This class is used to iterate through the rectangles in a region,
+typically when examining the damaged regions of a window within an OnPaint call.
+
+To use it, construct an iterator object on the stack and loop through the
+regions, testing the object and incrementing the iterator at the end of the loop.
+
+See \helpref{wxWindow::OnPaint}{wxwindowonpaint} for an example of use.
+
+\wxheading{Derived from}
+
+\helpref{wxObject}{wxobject}
+
+\wxheading{See also}
+
+\helpref{wxWindow::OnPaint}{wxwindowonpaint}
+
+\latexignore{\rtfignore{\wxheading{Members}}}
+
+\membersection{wxRegionIterator::wxRegionIterator}
+
+\func{}{wxRegionIterator}{\void}
+
+Default constructor.
+
+\func{}{wxRegionIterator}{\param{const wxRegion\&}{ region}}
+
+Creates an iterator object given a region.
+
+\membersection{wxRegionIterator::GetX}
+
+\constfunc{long}{GetX}{\void}
+
+Returns the x value for the current region.
+
+\membersection{wxRegionIterator::GetY}
+
+\constfunc{long}{GetY}{\void}
+
+Returns the y value for the current region.
+
+\membersection{wxRegionIterator::GetW}
+
+\constfunc{long}{GetW}{\void}
+
+An alias for GetWidth.
+
+\membersection{wxRegionIterator::GetWidth}
+
+\constfunc{long}{GetWidth}{\void}
+
+Returns the width value for the current region.
+
+\membersection{wxRegionIterator::GetH}
+
+\constfunc{long}{GetH}{\void}
+
+An alias for GetHeight.
+
+\membersection{wxRegionIterator::GetHeight}
+
+\constfunc{long}{GetWidth}{\void}
+
+Returns the width value for the current region.
+
+\membersection{wxRegionIterator::GetRect}
+
+\constfunc{wxRect}{GetRect}{\void}
+
+Returns the current rectangle.
+
+\membersection{wxRegionIterator::HaveRects}
+
+\constfunc{bool}{HaveRects}{\void}
+
+Returns TRUE if there are still some rectangles; otherwise returns FALSE.
+
+\membersection{wxRegionIterator::Reset}
+
+\func{void}{Reset}{\void}
+
+Resets the iterator to the beginning of the rectangles.
+
+\func{void}{Reset}{\param{const wxRegion\&}{ region}}
+
+Resets the iterator to the given region.
+
+\membersection{wxRegionIterator::operator $++$}
+
+\func{void}{operator $++$}{\void}
+
+Increment operator. Increments the iterator to the next region.
+
+\membersection{wxRegionIterator::operator bool}
+
+\constfunc{}{operator bool}{\void}
+
+Returns TRUE if there are still some rectangles; otherwise returns FALSE.
+
+You can use this to test the iterator object as if it were of type bool.
 
diff --git a/docs/latex/wx/upditer.tex b/docs/latex/wx/upditer.tex
deleted file mode 100644 (file)
index 148d496..0000000
+++ /dev/null
@@ -1,56 +0,0 @@
-\section{\class{wxUpdateIterator}}\label{wxupdateiterator}
-
-This class is used to iterate through all damaged regions of a window, within an OnPaint call.
-
-To use it, construct an iterator object on the stack and loop through the
-regions, testing the object and incrementing the iterator at the end of the loop.
-
-See \helpref{wxScrolledWindow::OnPaint}{wxscrolledwindowonpaint} for an example of use.
-
-\wxheading{Derived from}
-
-\helpref{wxObject}{wxobject}
-
-\wxheading{See also}
-
-\helpref{wxScrolledWindow::OnPaint}{wxscrolledwindowonpaint}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxUpdateIterator::wxUpdateIterator}
-
-\func{}{wxUpdateIterator}{\param{wxWindow* }{window}}
-
-Creates an iterator object.
-
-\membersection{wxUpdateIterator::GetX}
-
-\func{int}{GetX}{\void}
-
-Returns the x value for the current region.
-
-\membersection{wxUpdateIterator::GetY}
-
-\func{int}{GetY}{\void}
-
-Returns the y value for the current region.
-
-\membersection{wxUpdateIterator::GetWidth}
-
-\func{int}{GetWidth}{\void}
-
-Returns the width value for the current region.
-
-\membersection{wxUpdateIterator::GetHeight}
-
-\func{int}{GetWidth}{\void}
-
-Returns the width value for the current region.
-
-\membersection{wxUpdateIterator::operator $++$}
-
-\func{void}{operator $++$}{\void}
-
-Increments the iterator to the next region.
-
-
index 6576b10adaf1c2f4e55718e4882cc848e87ecbfd..7ed5e858dc8acfd58a30f5f2a76a3bf652b59366 100644 (file)
@@ -620,6 +620,17 @@ Gets the window's title. Applicable only to frames and dialogs.
 
 \helpref{wxWindow::SetTitle}{wxwindowsettitle}
 
+\membersection{wxWindow::GetUpdateRegion}\label{wxwindowgetupdateregion}
+
+\constfunc{virtual wxRegion}{GetUpdateRegion}{\void}
+
+Returns the region specifying which parts of the window have been damaged. Should
+only be called within an \helpref{OnPaint}{wxwindowonpaint} event handler.
+
+\wxheading{See also}
+
+\helpref{wxRegion}{wxregion}, \helpref{wxRegionIterator}{wxregioniterator}, \helpref{wxWindow::OnPaint}{wxwindowonpaint}
+
 \membersection{wxWindow::GetWindowStyleFlag}
 
 \constfunc{long}{GetWindowStyleFlag}{\void}
@@ -1146,7 +1157,7 @@ terms of the client area, and are unscrolled, so you will need to do
 some calculations using the current view position to obtain logical,
 scrolled units.
 
-Here is an example of using the \helpref{wxUpdateIterator}{wxupdateiterator} class:
+Here is an example of using the \helpref{wxRegionIterator}{wxregioniterator} class:
 
 {\small%
 \begin{verbatim}
@@ -1160,7 +1171,7 @@ void MyWindow::OnPaint(wxPaintEvent& event)
   ViewStart(&vbX,&vbY);
 
   int vX,vY,vW,vH;                 // Dimensions of client area in pixels
-  wxUpdateIterator upd(this); // get the update rect list
+  wxRegionIterator upd(GetUpdateRegion()); // get the update rect list
 
   while (upd)
   {