1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201
|
<HTML>
<!-- $Header: /cvsroot/xbae/Xbae/doc/main.html,v 1.23 2002/08/21 18:24:35 dannybackx Exp $ -->
<HEAD>
<TITLE>Xbae Matrix/Table Widget Home Page</TITLE>
</HEAD>
<BODY BGCOLOR="#FFFFFF">
<P><A NAME="whatisit"></A>
<P>
<STRONG>XbaeMatrix</STRONG> is a free
<A HREF="http://www.opengroup.org/motif" TARGET="_top">Motif®</A> table widget
(also compatible with the free <A HREF="http://www.lesstif.org" TARGET="_top">LessTif</A>)
which presents an editable array of string data to the user in a scrollable
table similar to a spreadsheet.
The rows and columns of the Matrix may optionally be labelled.
A number of "fixed" and "trailing fixed" rows or
columns may be specified.
<P>
While XbaeMatrix looks and acts like a grid of XmTextField widgets,
it actually contains only one XmTextField.
This means that XbaeMatrix widgets
with hundreds or thousands of rows have much less overhead than they would
if they used an XmTextField for each cell.
<BR>
XbaeMatrix has callbacks for doing
field validation and customizing traversal.
It allows cells to be assigned independent colors.
It allows rows, columns and regions of cells to be selected or highlighted.
The matrix can be dynamically grown or shrunk
by adding and deleting rows and columns at any position.
<BR>
The widget has many resources to allow individual customisation and
can be made to look and behave like an extended list widget with added
functionality. Pixmaps (both colour xpm and standard bitmaps) can be displayed
in individual cells with the callbacks available in the widget.
<P>
The file that is downloaded also contains the <STRONG>XbaeCaption</STRONG>
widget which is a simple Motif manager widget that associates a label with
a child.
<P>
In addition the <STRONG>XbaeInput</STRONG> widget is being distributed,
a text input field that provides generic customised data entry
and formatting for strings.
<P>
All those widgets are compatible with version 1.2 of Motif and above.
They won't be supported for versions lower than X11R6 (please...)
or any Motif release below 1.2.
<P>
<HR WIDTH="100%">
<P><A NAME="documentation"><FONT SIZE="+2">Documentation</FONT></A>
<P>
You can view the man pages converted to HTML for all three widgets:
<UL>
<LI>
<A HREF="XbaeMatrix.html">XbaeMatrix</A>
<LI>
<A HREF="XbaeCaption.html">XbaeCaption</A>
<LI>
<A HREF="XbaeInput.html">XbaeInput</A>
</UL>
<P>
<HR WIDTH="100%">
<P><A NAME="demos"><FONT SIZE="+2">Screenshots of the demos included with XbaeMatrix</FONT></A>
<UL>
<LI>
<A HREF="images/add.jpg">add </A>- dynamically adds and deletes rows or
columns</LI>
<LI>
<A HREF="images/caption.png">caption</A> - Demonstrate XbaeCaption Widget</LI>
<LI>
<A HREF="images/choice.png">choice</A> - change the way the matrix looks
on the fly</LI>
<LI>
<A HREF="images/colors.jpg">colors</A> - different foregrounds and backgrounds
for cells</LI>
<LI>
<A HREF="images/draw.png">draw</A> - use of the draw cell callback for
pixmaps and very large matrices</LI>
<LI>
<A HREF="images/fifteen.jpg">fifteen</A> - a working clone of the old puzzle
game</LI>
<LI>
<A HREF="images/input.png">input</A> - Demonstrate XbaeInput Widget</LI>
<LI>
<A HREF="images/list.jpg">list</A> - how XbaeMatrix can be used to emulate
an enhanced XmList widget</LI>
<LI>
<A HREF="images/matrix.jpg">matrix</A> - displays variations of the labels</LI>
<LI>
<A HREF="images/multifixed.jpg">multifixed</A> - fixed and trailing fixed
rows and columns</LI>
<LI>
<A HREF="images/select-push.jpg">select-push</A> - what can be achieved
with different shadows</LI>
</UL>
<HR WIDTH="100%">
<P><A NAME="objectives"><FONT SIZE="+2">Current objectives</FONT></A>
<P>
Below is a list of things that crossed the mind as possible enhancements.
Some of these range from the "doable" to useless to insane.
Mentally, and now via this page,
I keep a track of what is worth doing and what is not.
<UL>
<LI>
Smooth vertical scrolling (<A HREF="scrolling.html">more...</A>)</LI>
<LI>
Cells with more than one line of text (<A HREF="morelines.html">more...</A>)</LI>
<LI>
Different fonts in different cells (<A HREF="difffonts.html">more...</A>)</LI>
<LI>
Spannable cells (<A HREF="spancells.html">more...</A>)</LI>
</UL>
<P>
<HR WIDTH="100%">
<P><A NAME="download"></A><FONT SIZE="+2">Download Xbae</FONT>
<P>
You can download from the
<A HREF="http://sourceforge.net/projects/xbae" TARGET="_top">Xbae project page</A>
at <A HREF="http://sourceforge.net" TARGET="_top">SourceFORGE.net</A> :
<A HREF="http://sourceforge.net/project/showfiles.php?group_id=31337" TARGET="_top">
http://sourceforge.net/project/showfiles.php?group_id=31337</A>.
<HR WIDTH="100%">
<P><A NAME="cvs"></A><FONT SIZE="+2">CVS</FONT>
<P>
The sources for Xbae are kept in a CVS repository at
<A HREF="http://sourceforge.net/cvs/?group_id=31337" TARGET="_top">SourceForge</A>.
The according page explains how to access those sources.
There's also a
<A HREF="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/xbae" TARGET="_top">browsable version</A>
available.
<HR WIDTH="100%">
<P><A NAME="join"></A><FONT SIZE="+2">Join the mailing lists</FONT>
<P>
Previously we used the
<A HREF="http://www.lesstif.org/lists.html" TARGET="_top">LessTif mailing list</A>
for discussing Xbae. Now we make a new mailinglist available
at
<A HREF="http://sourceforge.net/mail/?group_id=31337" TARGET="_top">http://sourceforge.net/mail/?group_id=31337</A>.
Please subscribe to it if you want to discuss usage and development
of Xbae!
<P>
If you want to follow development in "real-time" you may
want to subscribe to the
<A HREF="http://lists.sourceforge.net/lists/listinfo/xbae-commits" TARGET="_top">Xbae-commits list</A>
which carries information about all changes applied to our public
source repository.
<P>
<HR WIDTH="100%">
<A NAME="feedback">If you have comments or suggestions</A>,
send us E-mail at
<I><A HREF="mailto:xbae-discuss@lists.sourceforge.net">xbae-discuss@lists.sourceforge.net</A></I>
<IMG SRC="images/mailbox.png" ALIGN=MIDDLE ALT="">
<P>
<small>
Latest change to this document : $Date: 2002/08/21 18:24:35 $
</small>
</body>
</html>
|