<BODY >
<DIV CLASS="navigation"><!--Navigation Panel-->
-<A NAME="tex2html240"
+<A NAME="tex2html266"
HREF="node4.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html234"
+<A NAME="tex2html260"
HREF="ionconf.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html228"
+<A NAME="tex2html254"
HREF="node2.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html236"
+<A NAME="tex2html262"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html238"
+<A NAME="tex2html264"
HREF="node11.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html241"
+<B> Next:</B> <A NAME="tex2html267"
HREF="node4.html">3. Basic configuration</A>
-<B> Up:</B> <A NAME="tex2html235"
+<B> Up:</B> <A NAME="tex2html261"
HREF="ionconf.html">Configuring and extending Ion3</A>
-<B> Previous:</B> <A NAME="tex2html229"
+<B> Previous:</B> <A NAME="tex2html255"
HREF="node2.html">1. Introduction</A>
- <B> <A NAME="tex2html237"
+ <B> <A NAME="tex2html263"
HREF="node1.html">Contents</A></B>
- <B> <A NAME="tex2html239"
+ <B> <A NAME="tex2html265"
HREF="node11.html">Index</A></B>
<BR>
<BR></DIV>
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL CLASS="ChildLinks">
-<LI><A NAME="tex2html242"
+<LI><A NAME="tex2html268"
HREF="node3.html#SECTION00310000000000000000"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN> Modules</A>
-<LI><A NAME="tex2html243"
+<LI><A NAME="tex2html269"
HREF="node3.html#SECTION00320000000000000000"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN> Class and object hierarchies</A>
<UL>
-<LI><A NAME="tex2html244"
+<LI><A NAME="tex2html270"
HREF="node3.html#SECTION00321000000000000000"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN> Class hierarchy</A>
-<LI><A NAME="tex2html245"
+<LI><A NAME="tex2html271"
HREF="node3.html#SECTION00322000000000000000"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN> Object hierarchies: WRegion parents and managers</A>
<UL>
-<LI><A NAME="tex2html246"
+<LI><A NAME="tex2html272"
HREF="node3.html#SECTION00322100000000000000"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN> Parent-child relations</A>
-<LI><A NAME="tex2html247"
+<LI><A NAME="tex2html273"
HREF="node3.html#SECTION00322200000000000000"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN> Manager-managed relations</A>
</UL>
-<LI><A NAME="tex2html248"
+<LI><A NAME="tex2html274"
HREF="node3.html#SECTION00323000000000000000"><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">3</SPAN> Summary</A>
</UL></UL>
<!--End of Table of Child-Links-->
</DD>
<DT><STRONG><SPAN CLASS="textit">mod_dock</SPAN></STRONG></DT>
-<DD>Module for docking Window Maker dockapps.
+<DD>Module for docking Window Maker dock-apps.
The dock can both float and be embedded as the statusbar.
</DD>
be toggled on/off everywhere. Think of the 'console' in some
first-person shooters.
-</DD>
-<DT><STRONG><SPAN CLASS="textit">mod_mgmtmode</SPAN></STRONG></DT>
-<DD>Support module for implementing ''management
- modes'' with a XOR-frame similar to move/resize mode around selected
- region.
-
</DD>
<DT><STRONG><SPAN CLASS="textit">mod_sm</SPAN></STRONG></DT>
<DD>Session management support module.
but they are not discussed here; see chapter <A HREF="node5.html#chap:gr">4</A>.
<P>
-The stock configuration for the 'ion3' executable loads all of the modules
-mentioned above except <SPAN CLASS="textit">mod_dock</SPAN> and filemod_mgmtmode.
-The stock configuration for the 'pwm3' executable (which differs from the
-'ion3' executable in a few configuration details, such as Xinerama usage)
+The stock configuration for the <SPAN CLASS="textit">ion3</SPAN> executable loads all of the
+modules mentioned above except <SPAN CLASS="textit">mod_dock</SPAN>.
+The stock configuration for the <SPAN CLASS="textit">pwm3</SPAN> executable (which differs
+from the <SPAN CLASS="textit">ion3</SPAN> executable in a few configuration details)
loads another set of modules.
<P>
<P>
While Ion does not not have a truly object-oriented design
<A NAME="tex2html3"
- HREF="#foot306"><SUP><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A>,
+ HREF="#foot303"><SUP><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A>,
things that appear on the computer screen are, however, quite
-naturally expressed as such ''objects''. Therefore Ion implements
+naturally expressed as such ``objects''. Therefore Ion implements
a rather primitive OO system for these screen objects and some
other things.
<P>
For simplicity we consider only the essential-for-basic-configuration
Ioncore, <SPAN CLASS="textit">mod_tiling</SPAN> and <SPAN CLASS="textit">mod_query</SPAN> classes.
-See Appendix <A HREF="node9.html#app:fullhierarchy">B</A> for the full class hierachy visible
+See Appendix <A HREF="node9.html#app:fullhierarchy">B</A> for the full class hierarchy visible
to Lua side.
<P>
<P>
-<DIV ALIGN="CENTER"><A NAME="fig:classhierarchy"></A><A NAME="413"></A>
+<DIV ALIGN="CENTER"><A NAME="fig:classhierarchy"></A><A NAME="410"></A>
<TABLE>
<CAPTION ALIGN="BOTTOM"><STRONG>Figure 2.1:</STRONG>
Partial Ioncore, <SPAN CLASS="textit">mod_tiling</SPAN> and <SPAN CLASS="textit">mod_query</SPAN>
|-->WRegion
| |-->WClientWin
| |-->WWindow
- | | |-->WRootWin
| | |-->WMPlex
- | | | |-->WScreen
| | | |-->WFrame
- | | |-->WInput (mod_query)
+ | | | `-->WScreen
+ | | | `-->WRootWin
+ | | `-->WInput (mod_query)
| | |-->WEdln (mod_query)
- | | |-->WMessage (mod_query)
+ | | `-->WMessage (mod_query)
| |-->WGroup
| | |-->WGroupWS
- | | |-->WGroupCW
- | |-->WTiling (mod_tiling)
- |-->WSplit (mod_tiling)
+ | | `-->WGroupCW
+ | `-->WTiling (mod_tiling)
+ `-->WSplit (mod_tiling)
</PRE></TD></TR>
</TABLE>
</DIV>
<P>
<DL>
<DT><STRONG>Obj</STRONG></DT>
-<DD><A NAME="419"></A>
+<DD><A NAME="416"></A>
Is the base of Ion's object system.
<P>
</DD>
<DT><STRONG>WRegion</STRONG></DT>
-<DD><A NAME="420"></A>
+<DD><A NAME="417"></A>
is the base class for everything corresponding to something on the
screen. Each object of type WRegion has a size and position
relative to the parent WRegion. While a big part of Ion
operates on these instead of more specialised classes, WRegion
- is a ''virtual'' base class in that there are no objects of ''pure''
+ is a ``virtual'' base class in that there are no objects of ``pure''
type WRegion; all concrete regions are objects of some class
that inherits WRegion.
<P>
</DD>
<DT><STRONG>WClientWin</STRONG></DT>
-<DD><A NAME="421"></A> is a class for
+<DD><A NAME="418"></A> is a class for
client window objects, the objects that window managers are
supposed to manage.
<P>
</DD>
<DT><STRONG>WWindow</STRONG></DT>
-<DD><A NAME="422"></A> is the base class for all
+<DD><A NAME="419"></A> is the base class for all
internal objects having an X window associated to them
(WClientWins also have X windows associated to them).
-<P>
-</DD>
-<DT><STRONG>WRootWin</STRONG></DT>
-<DD><A NAME="423"></A> is the class for
- root windows<A NAME="336"></A> of X screens<A NAME="337"></A>.
- Note that an ''X screen'' or root window is not necessarily a
- single physical screen<A NAME="338"></A> as a root window
- may be split over multiple screens when multi-head extensions
- such as Xinerama<A NAME="339"></A> are used. (Actually there
- can be only one WRootWin when Xinerama is used.)
-
<P>
</DD>
<DT><STRONG>WMPlex</STRONG></DT>
-<DD>is a base class for all regions that''multiplex''
+<DD>is a base class for all regions that ``multiplex''
other regions. This means that of the regions managed by the multiplexer,
- only one can be displayed at a time. Classes that inhereit WMPlex
- include screens and frames.
+ only one can be displayed at a time.
<P>
</DD>
<DT><STRONG>WScreen</STRONG></DT>
-<DD><A NAME="424"></A> is the class for objects
- corresponding to physical screens. Screens may share a root
- window when Xinerama multihead extensions are used as explained
- above.
+<DD><A NAME="420"></A> is an instance of WMPlex
+ for screens.
+
+<P>
+</DD>
+<DT><STRONG>WRootWin</STRONG></DT>
+<DD><A NAME="421"></A> is the class for
+ root windows<A NAME="337"></A> of X screens<A NAME="338"></A>.
+ It is an instance of WScreen.
+ Note that an ``X screen'' or root window is not necessarily a
+ single physical screen<A NAME="340"></A> as a root window
+ may be split over multiple screens when ugly hacks such as
+ Xinerama<A NAME="341"></A> are used. (Actually there can be only
+ one root window when Xinerama is used.)
<P>
</DD>
<DT><STRONG>WFrame</STRONG></DT>
-<DD><A NAME="425"></A> is the class for frames.
- While most Ion's objects have no graphical presentation, frames basically
- add to WMPlexes the decorations around client windows
- (borders, tabs).
+<DD><A NAME="422"></A> is the class for frames.
+ While most Ion's objects have no graphical presentation, frames
+ basically add to WMPlexes the decorations around client
+ windows (borders, tabs).
<P>
</DD>
<DT><STRONG>WGroup</STRONG></DT>
-<DD><A NAME="426"></A> is the base class for groups.
+<DD><A NAME="423"></A> is the base class for groups.
Particular types of groups are workspaces
- (WGroupWS<A NAME="427"></A>)
+ (WGroupWS<A NAME="424"></A>)
and groups of client windows
- (WGroupCW<A NAME="428"></A>).
+ (WGroupCW<A NAME="425"></A>).
</DD>
</DL>
<P>
<DL>
<DT><STRONG>WTiling</STRONG></DT>
-<DD><A NAME="430"></A> is the class for tilings
+<DD><A NAME="427"></A> is the class for tilings
of frames.
</DD>
<DT><STRONG>WSplit</STRONG></DT>
-<DD><A NAME="431"></A> (or, more specifically, classes
+<DD><A NAME="428"></A> (or, more specifically, classes
that inherit it) encode the WTiling tree structure.
</DD>
</DL>
<P>
<DL>
<DT><STRONG>WInput</STRONG></DT>
-<DD><A NAME="433"></A> is a virtual base class for the
+<DD><A NAME="430"></A> is a virtual base class for the
two classes below.
</DD>
<DT><STRONG>WEdln</STRONG></DT>
-<DD><A NAME="434"></A> is the class for the ''queries'',
+<DD><A NAME="431"></A> is the class for the ``queries'',
the text inputs that usually appear at bottoms of frames and sometimes
- screens. Queries are the functional equivalent of ''mini buffers'' in
+ screens. Queries are the functional equivalent of ``mini buffers'' in
many text editors.
</DD>
<DT><STRONG>WMessage</STRONG></DT>
-<DD><A NAME="435"></A> implements the boxes for
+<DD><A NAME="432"></A> implements the boxes for
warning and other messages that Ion may wish to display to the user.
These also usually appear at bottoms of frames.
</DD>
</DL>
<P>
-There are also some other ''proxy'' classes that do not refer
+There are also some other ``proxy'' classes that do not refer
to objects on the screen. The only important one of these for
basic configuration is WMoveresMode that is used for
binding callbacks in the move and resize mode.
<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN> Parent-child relations</A>
</H4>
Each object of type WRegion has a parent and possibly a manager
-associated to it. The parent<A NAME="376"></A> for an object is always a
+associated to it. The parent<A NAME="373"></A> for an object is always a
WWindow and for WRegion with an X window (WClientWin,
WWindow) the parent WWindow is given by the same relation of
the X windows. For other WRegions the relation is not as clear.
<P>
-<DIV ALIGN="CENTER"><A NAME="fig:parentship"></A><A NAME="387"></A>
+<DIV ALIGN="CENTER"><A NAME="fig:parentship"></A><A NAME="384"></A>
<TABLE>
<CAPTION ALIGN="BOTTOM"><STRONG>Figure 2.2:</STRONG>
Most common parent-child relations</CAPTION>
<TR><TD><PRE>
WRootWins
- |-->WScreens
- |-->WGroupWSs
- |-->WTilings
- |-->WClientWins in full screen mode
- |-->WFrames
- |-->WGroupCWs
- |-->WClientWins
- |-->WFrames for transients
- |-->a possible WEdln or WMessage
+ |-->WGroupWSs
+ |-->WTilings
+ |-->WClientWins in full screen mode
+ `-->WFrames
+ |-->WGroupCWs
+ |-->WClientWins
+ |-->WFrames for transients
+ `-->a possible WEdln or WMessage
</PRE></TD></TR>
</TABLE>
</DIV>
<P>
WRegions have very little control over their children as a parent.
-The manager<A NAME="391"></A> WRegion has much more control over its
+The manager<A NAME="388"></A> WRegion has much more control over its
managed WRegions. Managers, for example, handle resize requests,
focusing and displaying of the managed regions. Indeed the manager--managed
relationship gives a better picture of the logical ordering of objects on
the screen. Again, there are generally few limits, but the most common
hierarchy is given in Figure <A HREF="#fig:managership">2.3</A>. Note that sometimes
-the parent and manager are the same object and not all objects may have
-a manager (e.g. the dock in the dock module at the time of writing this)
-but all have a parent-a screen if not anything else.
+the parent and manager are the same object and not all regions may have
+a manager, but all non-screen regions have a parent--a screen if not
+anything else.
<P>
<P>
-<DIV ALIGN="CENTER"><A NAME="fig:managership"></A><A NAME="399"></A>
+<DIV ALIGN="CENTER"><A NAME="fig:managership"></A><A NAME="396"></A>
<TABLE>
<CAPTION ALIGN="BOTTOM"><STRONG>Figure 2.3:</STRONG>
Most common manager-managed relations</CAPTION>
<TR><TD><PRE>
WRootWins
- |-->WScreens
- |-->WGroupCWs for full screen WClientWins
- | |-->WClientWins
- | |-->WFrames for transients (dialogs)
- | |--> WClientWin
- |-->WGroupWSs for workspaces
- | |-->WTiling
- | | |-->possibly a WEdln, WMessage or WMenu
- | | |-->WFrames
- | | |-->WGroupCWs (with contents as above)
- | |-->WFrames for floating content
- |-->WFrames for sticky stuff, such as the scratchpad
+ |-->WGroupCWs for full screen WClientWins
+ | |-->WClientWins
+ | `-->WFrames for transients (dialogs)
+ | `--> WClientWin
+ |-->WGroupWSs for workspaces
+ | |-->WTiling
+ | | |-->WFrames
+ | | | `-->WGroupCWs (with contents as above)
+ | | `-->possibly a WStatusBar or WDock
+ | |-->WFrames for floating content
+ | |-->possibly a WEdln, WMessage or WMenu
+ | `-->possibly a WStatusBar or WDock (if no tiling)
+ `-->WFrames for sticky stuff, such as the scratchpad
</PRE></TD></TR>
</TABLE>
</DIV>
<P>
<BR><HR><H4>Footnotes</H4>
<DL>
-<DT><A NAME="foot306">... design</A><A
+<DT><A NAME="foot303">... design</A><A
HREF="node3.html#tex2html3"><SUP><SPAN CLASS="arabic">2</SPAN>.<SPAN CLASS="arabic">1</SPAN></SUP></A></DT>
<DD>the author doesn't like such artificial designs
</DL>
<DIV CLASS="navigation"><HR>
<!--Navigation Panel-->
-<A NAME="tex2html240"
+<A NAME="tex2html266"
HREF="node4.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
-<A NAME="tex2html234"
+<A NAME="tex2html260"
HREF="ionconf.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
-<A NAME="tex2html228"
+<A NAME="tex2html254"
HREF="node2.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
-<A NAME="tex2html236"
+<A NAME="tex2html262"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
-<A NAME="tex2html238"
+<A NAME="tex2html264"
HREF="node11.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
-<B> Next:</B> <A NAME="tex2html241"
+<B> Next:</B> <A NAME="tex2html267"
HREF="node4.html">3. Basic configuration</A>
-<B> Up:</B> <A NAME="tex2html235"
+<B> Up:</B> <A NAME="tex2html261"
HREF="ionconf.html">Configuring and extending Ion3</A>
-<B> Previous:</B> <A NAME="tex2html229"
+<B> Previous:</B> <A NAME="tex2html255"
HREF="node2.html">1. Introduction</A>
- <B> <A NAME="tex2html237"
+ <B> <A NAME="tex2html263"
HREF="node1.html">Contents</A></B>
- <B> <A NAME="tex2html239"
+ <B> <A NAME="tex2html265"
HREF="node11.html">Index</A></B> </DIV>
<!--End of Navigation Panel-->