doc/ml_table_layout_pack.3.html

   1 <html>
   2 <head>
   3 <meta name="generator" content="groff -Thtml, see www.gnu.org">
   4 <meta name="Content-Style" content="text/css">
   5 <title>new_ml_table_layout</title>
   6 </head>
   7 <body>
   8
   9 <h1 align=center>new_ml_table_layout</h1>
  10 <a href="#NAME">NAME</a><br>
  11 <a href="#SYNOPSIS">SYNOPSIS</a><br>
  12 <a href="#DESCRIPTION">DESCRIPTION</a><br>
  13 <a href="#AUTHOR">AUTHOR</a><br>
  14 <a href="#LICENSE">LICENSE</a><br>
  15 <a href="#VERSION">VERSION</a><br>
  16 <a href="#SEE ALSO">SEE ALSO</a><br>
  17
  18 <hr>
  19 <!-- Creator     : groff version 1.17.2 -->
  20 <!-- CreationDate: Sat Aug 31 18:06:05 2002 -->
  21 <a name="NAME"></a>
  22 <h2>NAME</h2>
  23 <table width="100%" border=0 rules="none" frame="void"
  24        cols="2" cellspacing="0" cellpadding="0">
  25 <tr valign="top" align="left">
  26 <td width="10%"></td><td width="90%">
  27 new_ml_table_layout, ml_table_layout_pack, ml_table_layout_set_colspan, ml_table_layout_set_rowspan, ml_table_layout_set_align, ml_table_layout_set_valign - monolith table layout widget</td></table>
  28 <a name="SYNOPSIS"></a>
  29 <h2>SYNOPSIS</h2>
  30
  31 <table width="100%" border=0 rules="none" frame="void"
  32        cols="2" cellspacing="0" cellpadding="0">
  33 <tr valign="top" align="left">
  34 <td width="10%"></td><td width="90%">
  35 <pre><b>#include &lt;ml_table_layout.h&gt;
  36
  37 ml_table_layout new_ml_table_layout (pool, int rows, int cols);
  38 void ml_table_layout_pack (ml_table_layout, ml_widget, int row, int col);
  39 void ml_table_layout_set_colspan (ml_table_layout, int row, int col, int colspan);
  40 void ml_table_layout_set_rowspan (ml_table_layout, int row, int col, int rowspan);
  41 void ml_table_layout_set_align (ml_table_layout, int row, int col, const char *align);
  42 void ml_table_layout_set_valign (ml_table_layout, int row, int col, const char *valign);
  43 </b></pre></td></table>
  44 <a name="DESCRIPTION"></a>
  45 <h2>DESCRIPTION</h2>
  46
  47 <table width="100%" border=0 rules="none" frame="void"
  48        cols="2" cellspacing="0" cellpadding="0">
  49 <tr valign="top" align="left">
  50 <td width="10%"></td><td width="90%">
  51 The monolith table layout widget is a very powerful layout
  52 tool. It is modelled on, and indeed implemented using, HTML
  53 &lt;table&gt;s. Table layouts are grids of widgets with a
  54 fixed number of rows and columns. Each widget normally
  55 occupies a single cell of the table, but widgets may occupy
  56 a rectangle of several adjacent cells. All cells in the
  57 table are referenced using the row and column number, with
  58 row and column numbers starting from zero.</td></table>
  59
  60 <table width="100%" border=0 rules="none" frame="void"
  61        cols="2" cellspacing="0" cellpadding="0">
  62 <tr valign="top" align="left">
  63 <td width="10%"></td><td width="90%">
  64 <b>new_ml_table_layout</b> creates a new table layout widget
  65 with <b>rows</b> cells across and <b>cols</b> cells down.
  66 The cells are numbered <b>0 .. rows-1</b> across and code{0
  67 .. cols-1} down.</td></table>
  68
  69 <table width="100%" border=0 rules="none" frame="void"
  70        cols="2" cellspacing="0" cellpadding="0">
  71 <tr valign="top" align="left">
  72 <td width="10%"></td><td width="90%">
  73 <b>ml_table_layout_pack</b> packs a widget at position
  74 <b>(row,col)</b> within the table. To remove a widget and
  75 leave a cell empty, pack a <b>NULL</b> widget.</td></table>
  76
  77 <table width="100%" border=0 rules="none" frame="void"
  78        cols="2" cellspacing="0" cellpadding="0">
  79 <tr valign="top" align="left">
  80 <td width="10%"></td><td width="90%">
  81 <b>ml_table_layout_set_colspan</b> and
  82 <b>ml_table_layout_set_rowspan</b> set the column span and
  83 row span for a particular table cell respectively. The
  84 col/row-span allow a cell to occupy one or more adjacent
  85 cells in the table (any widgets packed in those adjacent
  86 cells are silently ignored). The default column and row span
  87 for every cell is 1.</td></table>
  88
  89 <table width="100%" border=0 rules="none" frame="void"
  90        cols="2" cellspacing="0" cellpadding="0">
  91 <tr valign="top" align="left">
  92 <td width="10%"></td><td width="90%">
  93 <b>ml_table_layout_set_align</b> sets the horizontal
  94 alignment for the content of a cell. The possibilities are
  95 <b>&quot;left&quot;</b>, <b>&quot;center&quot;</b> or
  96 <b>&quot;right&quot;</b>, with the default being
  97 left-aligned.</td></table>
  98
  99 <table width="100%" border=0 rules="none" frame="void"
 100        cols="2" cellspacing="0" cellpadding="0">
 101 <tr valign="top" align="left">
 102 <td width="10%"></td><td width="90%">
 103 <b>ml_table_layout_set_valign</b> sets the vertical
 104 alignment for the content of a cell. The possibilities are
 105 <b>&quot;top&quot;</b>, <b>&quot;middle&quot;</b> or
 106 <b>&quot;bottom&quot;</b>, with the default being
 107 middle.</td></table>
 108 <a name="AUTHOR"></a>
 109 <h2>AUTHOR</h2>
 110
 111 <table width="100%" border=0 rules="none" frame="void"
 112        cols="2" cellspacing="0" cellpadding="0">
 113 <tr valign="top" align="left">
 114 <td width="10%"></td><td width="90%">
 115 Richard Jones &lt;rich@annexia.org&gt;</td></table>
 116 <a name="LICENSE"></a>
 117 <h2>LICENSE</h2>
 118
 119 <table width="100%" border=0 rules="none" frame="void"
 120        cols="2" cellspacing="0" cellpadding="0">
 121 <tr valign="top" align="left">
 122 <td width="10%"></td><td width="90%">
 123 GNU LGPL (see http://www.gnu.org/)</td></table>
 124 <a name="VERSION"></a>
 125 <h2>VERSION</h2>
 126
 127 <table width="100%" border=0 rules="none" frame="void"
 128        cols="2" cellspacing="0" cellpadding="0">
 129 <tr valign="top" align="left">
 130 <td width="10%"></td><td width="90%">
 131 monolith-1.0.0</td></table>
 132 <a name="SEE ALSO"></a>
 133 <h2>SEE ALSO</h2>
 134
 135 <table width="100%" border=0 rules="none" frame="void"
 136        cols="2" cellspacing="0" cellpadding="0">
 137 <tr valign="top" align="left">
 138 <td width="10%"></td><td width="90%">
 139 <b>new_ml_widget(3)</b>.</td></table>
 140 <hr>
 141 </body>
 142 </html>