z207.html

GTK+_ Gnome Application Development

        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z325">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z326">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkframe.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z327">Description</a>
          </h3>
          <p>
            The frame widget draws a decorative frame around its
            child. It has an optional title describing the contents
            of the frame. To turn off the title, set it to <span
            class="STRUCTNAME">NULL</span>. It also has a
            configurable shadow style; the four possibilities are
            shown in <a href="z207.html#FIG-GTKFRAME">Figure
            10</a>. <span class="STRUCTNAME">GTK_SHADOW_NONE</span>
            is a fifth acceptable value for the shadow type; it
            turns the shadow off.
          </p>
          <div class="FIGURE">
            <a name="FIG-GTKFRAME"></a>
            <p>
              <img src="figures/gtkframe.png">
            </p>
            <p>
              <b>Figure 10. <tt class="CLASSNAME">GtkFrame</tt>,
              with the four shadow types.</b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z328"><tt class="CLASSNAME">
          GtkAspectFrame</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z329">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z330">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkaspectframe.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z331">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkAspectFrame</tt> is used to
            control the aspect ratio of its child. It also allows
            you to justify the child in both directions, similar to
            <tt class="CLASSNAME">GtkAlignment</tt>. You can
            specify an aspect ratio, or require that the ratio of
            the child's size request be preserved. Visually, <tt
            class="CLASSNAME">GtkAspectFrame</tt> looks exactly
            like <tt class="CLASSNAME">GtkFrame</tt>.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z332"><tt class="CLASSNAME">GtkItem</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z333">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z334">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkitem.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z335">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkItem</tt> is an abstract base
            class for list items, tree items, and menu items. Items
            are widgets that can be "selected," "deselected," and
            "toggled."
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z336"><tt class="CLASSNAME">GtkMenuItem</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z337">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z338">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkmenuitem.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z339">Description</a>
          </h3>
          <p>
            A menu item is an invisible container; it is the only
            kind of widget that can appear in a <tt class=
            "CLASSNAME">GtkMenu</tt>. Typically, a label or a label
            and a pixmap are placed in the menu item to indicate
            its function. If a menu item has no child widget, it
            draws a separator line instead. This saves the overhead
            of adding a <tt class="CLASSNAME">GtkSeparator</tt> to
            the menu item.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z340"><tt class="CLASSNAME">
          GtkCheckMenuItem</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z341">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z342">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkcheckmenuitem.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z343">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkCheckMenuItem</tt> is a menu
            item that works like a <tt class="CLASSNAME">
            GtkCheckButton</tt>; it has a small button next to its
            child widget, which is either "active" or "inactive."
            Because it's a subclass of <tt class="CLASSNAME">
            GtkMenuItem</tt>, it can appear in menus.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z344"><tt class="CLASSNAME">
          GtkRadioMenuItem</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z345">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z346">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkradiomenuitem.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z347">Description</a>
          </h3>
          <p>
            A radio menu item works like <tt class="CLASSNAME">
            GtkRadioButton</tt>; it allows the user to choose from
            a set of mutually exclusive options. Because it's a
            subclass of <tt class="CLASSNAME">GtkMenuItem</tt>, it
            can appear in menus.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z348"><tt class="CLASSNAME">
          GtkPixmapMenuItem</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z349">Library</a>
          </h3>
          <p>
            Gnome
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z350">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">
            libgnomeui/gtkpixmapmenuitem.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z351">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkPixmapMenuItem</tt> is a Gnome
            widget despite its name. This widget solves a very
            specific problem: namely, if a menu contains check or
            radio menu items, GTK+ indents the child widget of all
            the menu items in the menu to make room for the check
            or radio buttons. Gnome uses pixmaps next to some menu
            items; <tt class="CLASSNAME">GtkPixmapMenuItem</tt>
            indents pixmaps in the same way GTK+ indents check or
            radio buttons. If you simply added a pixmap and a label
            to a <tt class="CLASSNAME">GtkMenuItem</tt>, the pixmap
            would be incorrectly aligned with the plain labels in
            other menu items. This widget is not really
            pixmap-specific; any widget can be placed in the
            unindented "pixmap" slot. Usually <tt class=
            "CLASSNAME">GtkPixmapMenuItem</tt> is created
            implicitly with the Gnome menu creation functions.
          </p>
          <div class="FIGURE">
            <a name="Z352"></a>
            <p>
              <img src="figures/gtkpixmapmenuitem.png">
            </p>
            <p>
              <b>Figure 11. <tt class="CLASSNAME">
              GtkPixmapMenuItem</tt> correctly positions pixmaps in
              a separate column to the left of the menu item
              texts.</b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z353"><tt class="CLASSNAME">
          GtkTearoffMenuItem</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z354">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z355">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtktearoffmenuitem.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z356">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkTearoffMenuItem</tt> is a
            "perforation" representing a spot where a menu can be
            "torn off" (kept visible in a toplevel window for easy
            access). Gnome menus all include a tearoff menu item by
            default, but users can globally disable them using the
            Gnome control center.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z357"><tt class="CLASSNAME">GtkListItem</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z358">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z359">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtklistitem.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z360">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkListItem</tt> is an invisible
            container that allows its child to appear in a <tt
            class="CLASSNAME">GtkList</tt>. That is, only list
            items can appear in a list.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z361"><tt class="CLASSNAME">GtkTreeItem</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z362">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z363">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtktreeitem.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z364">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkTreeItem</tt> is an invisible
            container that gives its child the ability to appear in
            a <tt class="CLASSNAME">GtkTree</tt>. Only tree items
            can be placed in the tree widget.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z365"><tt class="CLASSNAME">GtkEventBox</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z366">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z367">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkeventbox.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z368">Description</a>