sec-gnomeuiinfo.html

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

          </tr>
          <tr>
            <td align="LEFT" valign="TOP">
              <span class="STRUCTNAME">
              GNOME_APP_UI_RADIOITEMS</span>
            </td>
            <td align="LEFT" valign="TOP">
              Radio item group
            </td>
            <td align="LEFT" valign="TOP">
              Array of radio items in the group
            </td>
          </tr>
          <tr>
            <td align="LEFT" valign="TOP">
              <span class="STRUCTNAME">GNOME_APP_UI_SUBTREE</span>
            </td>
            <td align="LEFT" valign="TOP">
              Submenu
            </td>
            <td align="LEFT" valign="TOP">
              Array of <span class="STRUCTNAME">GnomeUIInfo</span>
              in the subtree
            </td>
          </tr>
          <tr>
            <td align="LEFT" valign="TOP">
              <span class="STRUCTNAME">
              GNOME_APP_UI_SEPARATOR</span>
            </td>
            <td align="LEFT" valign="TOP">
              Separator
            </td>
            <td align="LEFT" valign="TOP">
              None
            </td>
          </tr>
          <tr>
            <td align="LEFT" valign="TOP">
              <span class="STRUCTNAME">GNOME_APP_UI_HELP</span>
            </td>
            <td align="LEFT" valign="TOP">
              Help item
            </td>
            <td align="LEFT" valign="TOP">
              Help node to load
            </td>
          </tr>
        </table>
      </div>
      <p>
        To create an entire menu tree, you include pointers to
        previous menu tables using the <tt class="FUNCTION">
        GNOMEUIINFO_SUBTREE()</tt> macro:
      </p>
      <table border="0" bgcolor="#E0E0E0" width="100%">
        <tr>
          <td>
<pre class="PROGRAMLISTING">
&#13;static GnomeUIInfo main_menu[] = {
  GNOMEUIINFO_SUBTREE(N_("_File"), file_menu),
  GNOMEUIINFO_END
};&#13;
</pre>
          </td>
        </tr>
      </table>
      <p>
        In this particular case, there is a better macro to use,
        however:
      </p>
      <table border="0" bgcolor="#E0E0E0" width="100%">
        <tr>
          <td>
<pre class="PROGRAMLISTING">
&#13;static GnomeUIInfo main_menu[] = {
  GNOMEUIINFO_MENU_FILE_TREE(file_menu),
  GNOMEUIINFO_END
};&#13;
</pre>
          </td>
        </tr>
      </table>
      <p>
        The main advantage of this macro is standardization; it
        ensures that all Gnome file menus use the same key shortcut
        and have the same name. There are quite a few analagous
        macros; see <tt class="FILENAME">
        libgnomeui/gnome-app-helper.h</tt> for the complete list.
      </p>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z89">Converting <span class="STRUCTNAME">
          GnomeUIInfo</span> to a Widget</a>
        </h2>
        <p>
          Once you have a menu table, Gnome will process it and
          convert it to a widget. The functions are listed in <a
          href="sec-gnomeuiinfo.html#GNOMEAPP-APPHELPER">Figure
          4</a>
        </p>
        <div class="FIGURE">
          <a name="GNOMEAPP-APPHELPER"></a>
          <div class="FUNCSYNOPSIS">
            <a name="GNOMEAPP-APPHELPER.SYNOPSIS"></a>
            <table border="0" bgcolor="#E0E0E0" width="100%">
              <tr>
                <td>
<pre class="FUNCSYNOPSISINFO">
#include &lt;libgnomeui/gnome-app-helper.h&gt;
</pre>
                </td>
              </tr>
            </table>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gnome_app_create_menus</tt></code>(GnomeApp* <tt
              class="PARAMETER"><i>app</i></tt>, GnomeUIInfo* <tt
              class="PARAMETER"><i>uiinfo</i></tt>);</code>
            </p>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gnome_app_create_menus_with_data</tt></code>(GnomeApp*
              <tt class="PARAMETER"><i>app</i></tt>, GnomeUIInfo*
              <tt class="PARAMETER"><i>uiinfo</i></tt>, gpointer
              <tt class="PARAMETER"><i>user_data</i></tt>);</code>
            </p>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gnome_app_create_toolbar</tt></code>(GnomeApp* <tt
              class="PARAMETER"><i>app</i></tt>, GnomeUIInfo* <tt
              class="PARAMETER"><i>uiinfo</i></tt>);</code>
            </p>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gnome_app_create_toolbar_with_data</tt></code>(GnomeApp*
              <tt class="PARAMETER"><i>app</i></tt>, GnomeUIInfo*
              <tt class="PARAMETER"><i>uiinfo</i></tt>, gpointer
              <tt class="PARAMETER"><i>user_data</i></tt>);</code>
            </p>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gnome_app_fill_toolbar</tt></code>(GtkToolbar* <tt
              class="PARAMETER"><i>toolbar</i></tt>, GnomeUIInfo*
              <tt class="PARAMETER"><i>uiinfo</i></tt>,
              GtkAccelGroup* <tt class="PARAMETER"><i>
              accel_group</i></tt>);</code>
            </p>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gnome_app_fill_toolbar_with_data</tt></code>(GtkToolbar*
              <tt class="PARAMETER"><i>toolbar</i></tt>,
              GnomeUIInfo* <tt class="PARAMETER"><i>
              uiinfo</i></tt>, GtkAccelGroup* <tt class=
              "PARAMETER"><i>accel_group</i></tt>, gpointer <tt
              class="PARAMETER"><i>data</i></tt>);</code>
            </p>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gnome_app_fill_menu</tt></code>(GtkMenuShell* <tt
              class="PARAMETER"><i>menushell</i></tt>, GnomeUIInfo*
              <tt class="PARAMETER"><i>uiinfo</i></tt>,
              GtkAccelGroup* <tt class="PARAMETER"><i>
              accel_group</i></tt>, gboolean <tt class="PARAMETER">
              <i>uline_accels</i></tt>, gint <tt class="PARAMETER">
              <i>pos</i></tt>);</code>
            </p>
            <p>
              <code><code class="FUNCDEF">void <tt class=
              "FUNCTION">
              gnome_app_fill_menu_with_data</tt></code>(GtkMenuShell*
              <tt class="PARAMETER"><i>menushell</i></tt>,
              GnomeUIInfo* <tt class="PARAMETER"><i>
              uiinfo</i></tt>, GtkAccelGroup* <tt class=
              "PARAMETER"><i>accel_group</i></tt>, gboolean <tt
              class="PARAMETER"><i>uline_accels</i></tt>, gint <tt
              class="PARAMETER"><i>pos</i></tt>, gpointer <tt
              class="PARAMETER"><i>user_data</i></tt>);</code>
            </p>
          </div>
          <p>
            <b>Figure 4. Creating Widgets from <span class= 
            "STRUCTNAME">GnomeUIInfo</span></b>
          </p>
        </div>
        <p>
          If you are using the <tt class="CLASSNAME">GnomeApp</tt>
          widget, <tt class="FUNCTION">
          gnome_app_create_menus()</tt> and <tt class="FUNCTION">
          gnome_app_create_toolbar()</tt> create a menubar or
          toolbar from the <span class="STRUCTNAME">
          GnomeUIInfo</span> table you provide, then attach that to
          the <tt class="CLASSNAME">GnomeApp</tt>. Most of the time
          these are the functions you want to use; they do
          everything automatically. There is a <span class= 
          "STRUCTNAME">_with_data()</span> variant of each function
          which overrides the <span class="STRUCTNAME">
          user_data</span> field of <span class="STRUCTNAME">
          GnomeUIInfo</span>.
        </p>
        <p>
          If you have more specialized needs, you can manually fill
          a menubar or toolbar and then add it to the container of
          your choice. The <span class="STRUCTNAME">fill</span>
          functions require you to specify an accelerator group to
          add accelerators to; for <tt class="CLASSNAME">
          GnomeApp</tt>, an accelerator group already exists in the
          widget struct (the <span class="STRUCTNAME">
          accel_group</span> member). The <span class="STRUCTNAME">
          fill</span> functions for menus take two additional
          arguments: you can toggle whether to parse the
          underscores in menu item labels to extract accelerators,
          and you can specify at which position in the <tt class= 
          "CLASSNAME">GtkMenuShell</tt> the function will begin
          inserting menu items.
        </p>
        <p>
          (<tt class="CLASSNAME">GtkMenuShell</tt> is simply the
          base class for <tt class="CLASSNAME">GtkMenuBar</tt> and
          <tt class="CLASSNAME">GtkMenu</tt>, i.e. it is a widget
          that contains menu items. An accelerator group is just a
          collection of accelerators, normally attached to a <tt
          class="CLASSNAME">GtkWindow</tt>; use <span class= 
          "STRUCTNAME">GNOME_APP(widget)-&gt;accel_group</span> in
          this case.)
        </p>
        <p>
          When you use a <span class="STRUCTNAME">
          GnomeUIInfo</span> table to create a menubar or toolbar,
          pointers to the individual menu item or toolbar button
          widgets are placed in the <span class="STRUCTNAME">
          widget</span> member of each <span class="STRUCTNAME">
          GnomeUIInfo</span> struct. You can use these pointers to
          access the individual widgets; for example, if you create
          a check menu item you might want to set the state of the
          check. The pointer is also useful if you want to manually
          create some part of the menu; you can create an empty
          subtree item, for example, and manually build the
          contents of the subtree.
        </p>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z90">GnomeHello: An Example</a>
        </h2>
        <p>
          The GnomeHello application has menus and a toolbar
          created using the <span class="STRUCTNAME">
          GnomeUIInfo</span> method; the relevant code is in a
          separate file, <tt class="FILENAME">menus.c</tt>.
          Appendix E lists this file in its entirety.
        </p>
      </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-main.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="z91.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>The Main Window: <tt
            class="CLASSNAME">GnomeApp</tt></b></font>
          </td>
          <td colspan="2" align="right">
            <font color="#000000" size="2"><b>Adding a Status
            Bar</b></font>
          </td>
        </tr>
      </table>
    </div>
  </body>
</html>