6e8515a3e3
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@13938 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
132 lines
3.8 KiB
TeX
132 lines
3.8 KiB
TeX
%
|
|
% automatically generated by HelpGen $Revision$ from
|
|
% gcupdatesmgr.h at 21/Jan/02 21:14:19
|
|
%
|
|
|
|
|
|
\section{\class{cbGCUpdatesMgr}}\label{cbgcupdatesmgr}
|
|
|
|
|
|
This class implements optimized logic for refreshing
|
|
the areas of frame layout that actually need to be updated.
|
|
It is used as the default updates manager by wxFrameLayout.
|
|
|
|
It is called 'Garbage Collecting' updates manager because
|
|
its implementation tries to find out dependencies between bars,
|
|
and to order them into a 'hierarchy'. This hierarchical sorting resembles
|
|
the implementation of heap-garbage collectors, which resolve
|
|
dependencies between references.
|
|
|
|
Example: there are situations where the order in which the user
|
|
moves windows does matter.
|
|
|
|
\begin{verbatim}
|
|
case 1)
|
|
------ ---
|
|
| A | |B|
|
|
------ ---> | |
|
|
--- --- ------
|
|
|B| | A |
|
|
| | ------
|
|
---
|
|
(future)
|
|
(past)
|
|
\end{verbatim}
|
|
|
|
Past/future positions of A and B windows completely overlap, i.e.
|
|
depend on each other, and there is no solution for
|
|
moving the windows without refreshing both of them
|
|
-- we have a cyclic dependency here. The garbage collection algorithm will
|
|
find this cyclic dependecy and will force refresh after movement.
|
|
|
|
\begin{verbatim}
|
|
case 2)
|
|
|
|
------
|
|
| A |
|
|
------ --->
|
|
---
|
|
|B| ------
|
|
| | | A |
|
|
--- ------
|
|
---
|
|
|B|
|
|
| |
|
|
---
|
|
|
|
(future)
|
|
(past)
|
|
\end{verbatim}
|
|
|
|
In this case past/future positions do not overlap, so
|
|
it is enough only to move windows without refreshing them.
|
|
Garbage collection will 'notice' this.
|
|
|
|
There is also a third case, when overlapping is partial.
|
|
In this case the refreshing can also be avoided by
|
|
moving windows in the order of 'most-dependant' towards the
|
|
'least-dependent'. GC handles this automatically, by
|
|
sorting windows by their dependency-level (or 'hierarchy').
|
|
|
|
See garbagec.h for more details of this method; garbagec.h/cpp
|
|
implement sorting of generic dependencies and does not deal
|
|
with graphical objects directly.
|
|
|
|
Summary: garbage collection improves performance when complex or large
|
|
windows are moved around, by reducing the number of repaints. It also helps
|
|
to avoid dirty non-client areas of moved windows
|
|
in some special cases of 'overlapping anomalies'.
|
|
|
|
\wxheading{Derived from}
|
|
|
|
\helpref{cbSimpleUpdatesMgr}{cbsimpleupdatesmgr}
|
|
|
|
\wxheading{Include files}
|
|
|
|
<wx/fl/gcupdatesmgr.h>
|
|
|
|
\wxheading{Data structures}
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
|
|
\membersection{cbGCUpdatesMgr::cbGCUpdatesMgr}\label{cbgcupdatesmgrcbgcupdatesmgr}
|
|
|
|
\func{}{cbGCUpdatesMgr}{\void}
|
|
|
|
Default constructor.
|
|
|
|
|
|
\func{}{cbGCUpdatesMgr}{\param{wxFrameLayout* }{pPanel}}
|
|
|
|
Constructor, taking a frame layout.
|
|
|
|
|
|
\membersection{cbGCUpdatesMgr::AddItem}\label{cbgcupdatesmgradditem}
|
|
|
|
\func{void}{AddItem}{\param{wxList\& }{itemList}, \param{cbBarInfo* }{pBar}, \param{cbDockPane* }{pPane}, \param{wxRect\& }{curBounds}, \param{wxRect\& }{prevBounds}}
|
|
|
|
Internal function for repositioning items.
|
|
|
|
|
|
\membersection{cbGCUpdatesMgr::DoRepositionItems}\label{cbgcupdatesmgrdorepositionitems}
|
|
|
|
\func{void}{DoRepositionItems}{\param{wxList\& }{items}}
|
|
|
|
Internal function for repositioning items.
|
|
|
|
|
|
\membersection{cbGCUpdatesMgr::OnStartChanges}\label{cbgcupdatesmgronstartchanges}
|
|
|
|
\func{void}{OnStartChanges}{\void}
|
|
|
|
Receives notifications from the frame layout.
|
|
|
|
|
|
\membersection{cbGCUpdatesMgr::UpdateNow}\label{cbgcupdatesmgrupdatenow}
|
|
|
|
\func{void}{UpdateNow}{\void}
|
|
|
|
Refreshes the parts of the frame layout which need an update.
|
|
|