sec-containers.html

gtk 开发手册和参考文档。 包括gtk glib gdk等

            </p>
            <p>
              <b>Figure 14. <span class="STRUCTNAME">
              GtkTable</span> after expanding the window
              vertically</b>
            </p>
          </div>
          <p>
            Next, imagine the user expanding the window
            horizontally; only child widget number three can expand
            horizontally. <a href= 
            "sec-containers.html#FIG-TABLEHORIZRESIZE">Figure
            15</a> shows this.
          </p>
          <div class="FIGURE">
            <a name="FIG-TABLEHORIZRESIZE"></a>
            <p>
              <img src="figures/tablehorizresize.png">
            </p>
            <p>
              <b>Figure 15. <span class="STRUCTNAME">
              GtkTable</span> after expanding the window
              horizontally</b>
            </p>
          </div>
          <p>
            <a href="sec-containers.html#FIG-TABLEVERTSHRINK">
            Figure 16</a> shows the result if the user shrinks the
            table vertically, so that there isn't enough vertical
            space to give all the widgets their size requests.
            Child number two gets shortchanged, while child number
            one gets all the vertical space it needs.
          </p>
          <div class="FIGURE">
            <a name="FIG-TABLEVERTSHRINK"></a>
            <p>
              <img src="figures/tablevertshrink.png">
            </p>
            <p>
              <b>Figure 16. <span class="STRUCTNAME">
              GtkTable</span> after shrinking the window
              vertically</b>
            </p>
          </div>
          <p>
            Finally, <a href= 
            "sec-containers.html#FIG-TABLEHORIZSHRINK">Figure
            17</a> shows the result if the user shrinks the table
            horizontally. Child number three gets the short end of
            the stick in this situation.
          </p>
          <div class="FIGURE">
            <a name="FIG-TABLEHORIZSHRINK"></a>
            <p>
              <img src="figures/tablehorizshrink.png">
            </p>
            <p>
              <b>Figure 17. <span class="STRUCTNAME">
              GtkTable</span> after shrinking the window
              horizontally</b>
            </p>
          </div>
          <p>
            It's not a bad idea to try resizing your window like
            this whenever you're designing a layout, just to be
            sure something sane happens. The definition of "sane"
            varies with the exact widgets you've placed in the
            layout.
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z54">Using <tt class="FUNCTION">
            gtk_table_attach_defaults()</tt></a>
          </h3>
          <p>
            Since <tt class="FUNCTION">gtk_table_attach()</tt> is
            somewhat cumbersome, there's a simpler version called
            <tt class="FUNCTION">gtk_table_attach_defaults()</tt>,
            shown in <a href=
            "sec-containers.html#FL-ATTACHDEFAULTS">Figure 18</a>.
            This version attaches the child with the options <span
            class="STRUCTNAME">GTK_EXPAND</span> and <span class= 
            "STRUCTNAME">GTK_FILL</span>, and no padding.
          </p>
          <p>
            It's tempting to use <tt class="FUNCTION">
            gtk_table_attach_defaults()</tt> all the time to save
            typing, but really you shouldn't; in fact, it's
            probably fair to say that it's rarely used. The
            function is only useful if the defaults happen to be
            exactly the settings you want. Most of the time, you
            need to carefully tweak your table attachment
            parameters to get really nice behavior when your window
            is resized. Always try resizing your window to be sure
            you've designed your layout well.
          </p>
          <div class="FIGURE">
            <a name="FL-ATTACHDEFAULTS"></a>
            <div class="FUNCSYNOPSIS">
              <a name="FL-ATTACHDEFAULTS.SYNOPSIS"></a>
              <table border="0" bgcolor="#E0E0E0" width="100%">
                <tr>
                  <td>
<pre class="FUNCSYNOPSISINFO">
#include &lt;gtk/gtktable.h&gt;
</pre>
                  </td>
                </tr>
              </table>
              <p>
                <code><code class="FUNCDEF">GtkWidget* <tt class= 
                "FUNCTION">
                gtk_table_attach_defaults</tt></code>(GtkTable* <tt
                class="PARAMETER"><i>table</i></tt>, GtkWidget* <tt
                class="PARAMETER"><i>child</i></tt>, guint <tt
                class="PARAMETER"><i>left_side</i></tt>, guint <tt
                class="PARAMETER"><i>right_side</i></tt>, guint <tt
                class="PARAMETER"><i>top_side</i></tt>, guint <tt
                class="PARAMETER"><i>bottom_side</i></tt>);</code>
              </p>
            </div>
            <p>
              <b>Figure 18. Attaching with Defaults</b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z55">Other Layout Widgets</a>
        </h2>
        <p>
          Boxes and tables are the most commonly-used layout
          widgets by far. However, there are a few others for
          special situations.
        </p>
        <ul>
          <li>
            <p>
              <tt class="CLASSNAME">GtkButtonBox</tt> is a special
              kind of box appropriate for the "action area" of a
              dialog.&#13;
            </p>
          </li>
          <li>
            <p>
              <tt class="CLASSNAME">GtkPacker</tt> supports <tt
              class="APPLICATION">Tk</tt>-style packing, useful if
              you're familiar with <tt class="APPLICATION">
              Tk</tt>.&#13;
            </p>
          </li>
          <li>
            <p>
              <tt class="CLASSNAME">GtkLayout</tt> provides an
              infinite scrolling area. In general, scrolling areas
              in GTK+ are limited to just over 30,000 pixels,
              because that is the maximum size of an X window.&#13;
            </p>
          </li>
          <li>
            <p>
              <tt class="CLASSNAME">GtkFixed</tt> allows you to
              manually position widgets at fixed coordinates.&#13;
            </p>
          </li>
        </ul>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z56">Manually Affecting Layout</a>
        </h2>
        <p>
          It's possible to manually override GTK+'s geometry
          management. This is a bad idea 95% of the time, because
          GTK+'s geometry is essentially the user's preferred
          geometry, determined by the theme, and resizing toplevel
          windows. If you find yourself wanting to do things
          manually, it's probably because you're using the wrong
          layout container, or you really should be writing a
          custom container widget.
        </p>
        <p>
          You can force a size or position on a widget with the
          functions shown in <a href="sec-containers.html#FL-SETU">
          Figure 19</a>. However, it is rarely a good idea to use
          them. In particular, <tt class="FUNCTION">
          gtk_widget_set_usize()</tt> should not be used to set a
          toplevel window's default size. Usually you want to set
          window size because you've saved the application's state
          and you're restoring it, or because the user specified a
          window geometry on the command line. Unfortunately, if
          you use <tt class="FUNCTION">gtk_widget_set_usize()</tt>
          the user will be unable to shrink the window, and you'll
          get hate mail. Rather than force a size, you want to
          specify an initial size with <tt class="FUNCTION">
          gtk_window_set_default_size()</tt>, shown in <a href= 
          "sec-containers.html#FL-DEFAULTSIZE">Figure 20</a>. <tt
          class="FUNCTION">gtk_widget_set_usize()</tt> is almost
          never a good idea for non-toplevel widgets either; most
          of the time, you can get better results using the proper
          layout widget.
        </p>
        <p>
          <tt class="FUNCTION">gtk_widget_set_uposition()</tt> is
          only useful for toplevel windows; it borders on
          nonsensical for other widgets, and will most likely cause
          bad things to happen. It's primarily used to honor a <tt
          class="APPLICATION">--geometry</tt> command line
          argument.
        </p>
        <p>
          All three of these functions can accept <span class= 
          "STRUCTNAME">-1</span> for the <span class="STRUCTNAME">
          x</span>, <span class="STRUCTNAME">y</span>, <span class= 
          "STRUCTNAME">width</span>, or <span class="STRUCTNAME">
          height</span> argument. The functions ignore any <span
          class="STRUCTNAME">-1</span> argument; this allows you to
          set only one of the two arguments, leaving the default
          value for the other.
        </p>
        <div class="FIGURE">
          <a name="FL-SETU"></a>
          <div class="FUNCSYNOPSIS">
            <a name="FL-SETU.SYNOPSIS"></a>
            <table border="0" bgcolor="#E0E0E0" width="100%">
              <tr>
                <td>
<pre class="FUNCSYNOPSISINFO">
#include &lt;gtk/gtkwidget.h&gt;
</pre>
                </td>
              </tr>
            </table>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gtk_widget_set_uposition</tt></code>(GtkWidget* <tt
              class="PARAMETER"><i>widget</i></tt>, gint <tt class= 
              "PARAMETER"><i>x</i></tt>, gint <tt class=
              "PARAMETER"><i>y</i></tt>);</code>
            </p>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gtk_widget_set_usize</tt></code>(GtkWidget* <tt
              class="PARAMETER"><i>widget</i></tt>, gint <tt class= 
              "PARAMETER"><i>width</i></tt>, gint <tt class= 
              "PARAMETER"><i>height</i></tt>);</code>
            </p>
          </div>
          <p>
            <b>Figure 19. Forcing Allocations</b>
          </p>
        </div>
        <div class="FIGURE">
          <a name="FL-DEFAULTSIZE"></a>
          <div class="FUNCSYNOPSIS">
            <a name="FL-DEFAULTSIZE.SYNOPSIS"></a>
            <table border="0" bgcolor="#E0E0E0" width="100%">
              <tr>
                <td>
<pre class="FUNCSYNOPSISINFO">
#include &lt;gtk/gtkwindow.h&gt;
</pre>
                </td>
              </tr>
            </table>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gtk_window_set_default_size</tt></code>(GtkWindow*
              <tt class="PARAMETER"><i>window</i></tt>, gint <tt
              class="PARAMETER"><i>width</i></tt>, gint <tt class= 
              "PARAMETER"><i>height</i></tt>);</code>
            </p>
          </div>
          <p>
            <b>Figure 20. Default Window Size</b>
          </p>
        </div>
      </div>
    </div>
    <div class="NAVFOOTER">
      <br>
      <br>
      <table width="100%" border="0" bgcolor="#ffffff" cellpadding= 
      "1" cellspacing="0">
        <tr>
          <td width="25%" bgcolor="#ffffff" align="left">
            <a href="cha-gtk.html"><font color="#0000ff" size="2">
            <b>&lt;&lt;&lt; Previous</b></font></a>
          </td>
          <td width="25%" colspan="2" bgcolor="#ffffff" align= 
          "center">
            <font color="#0000ff" size="2"><b><a href="ggad.html">
            <font color="#0000ff" size="2"><b>
            Home</b></font></a></b></font>
          </td>
          <td width="25%" bgcolor="#ffffff" align="right">
            <a href="z57.html"><font color="#0000ff" size="2"><b>
            Next &gt;&gt;&gt;</b></font></a>
          </td>
        </tr>
        <tr>
          <td colspan="2" align="left">
            <font color="#000000" size="2"><b>GTK+
            Basics</b></font>
          </td>
          <td colspan="2" align="right">
            <font color="#000000" size="2"><b>Widget
            Concepts</b></font>
          </td>
        </tr>
      </table>
    </div>
  </body>
</html>