z207.html

GTK+_ Gnome Application Development

          </h3>
          <p>
            The event box widget may be the simplest container in
            GTK+; its only purpose is to have a <span class= 
            "STRUCTNAME">GdkWindow</span>. Certain operations only
            work on widgets with windows (such as setting the
            background color, or capturing events); if you want to
            perform these operations on a windowless widget, you
            can place the widget in an event box and perform the
            operations on the event box, achieving much the same
            effect.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z369"><tt class="CLASSNAME">
          GtkHandleBox</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z370">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z371">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkhandlebox.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z372">Description</a>
          </h3>
          <p>
            The handle box widget can be adds a handle to a child
            widget; by dragging on the handle, the child can be
            removed from the window and positioned elsewhere on the
            user's desktop. The handle box is often used for
            toolbars. <tt class="CLASSNAME">GnomeDock</tt> and <tt
            class="CLASSNAME">GnomeDockItem</tt> offer a more
            flexible (but more elaborate) alternative.
          </p>
          <div class="FIGURE">
            <a name="Z373"></a>
            <p>
              <img src="figures/gtkhandlebox.png">
            </p>
            <p>
              <b>Figure 12. A torn-off <tt class="CLASSNAME">
              GtkHandleBox</tt> containing a toolbar, alongside its
              original parent window.</b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z374"><tt class="CLASSNAME">
          GtkScrolledWindow</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z375">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z376">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkscrolledwindow.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z377">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkScrolledWindow</tt> provides
            horizontal and vertical scrollbars for its child
            widget. Optionally, the scrollbars are hidden when the
            entire child is visible. If a child widget has a <span
            class="STRUCTNAME">set_scroll_adjustments_signal</span>
            in its <tt class="CLASSNAME">GtkWidgetClas</tt> (see <a
            href="z144.html#SEC-OVERRIDESIGNALS">the section called
            <i>Overridable Signals</i> in the chapter called <i>
            Writing a <tt class="CLASSNAME">
            GtkWidget</tt></i></a>), the scrolled window uses them
            as the adjustments for the scrollbars. Otherwise, the
            scrolled window scrolls the entire widget using a <tt
            class="CLASSNAME">GtkViewport</tt>. (Consider <tt
            class="CLASSNAME">GtkCList</tt> for example; the column
            titles aren't scrolled, only the list contents. Thus
            <tt class="CLASSNAME">GtkCList</tt> provides scroll
            adjustment signals.)
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z378"><tt class="CLASSNAME">GtkViewport</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z379">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z380">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkviewport.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z381">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkViewport</tt> is more or less
            an implementation detail of <tt class="CLASSNAME">
            GtkScrolledWindow</tt>. It contains a widget that does
            not provide a <span class="STRUCTNAME">
            set_scroll_adjustments_signal</span>, and provides such
            a signal on the child widget's behalf. See <tt class= 
            "CLASSNAME">GtkScrolledWindow</tt> for more details.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z382"><tt class="CLASSNAME">GtkBox</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z383">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z384">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkbox.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z385">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkBox</tt> is an abstract base
            class for <tt class="CLASSNAME">GtkVBox</tt>, <tt
            class="CLASSNAME">GtkHBox</tt>, and <tt class=
            "CLASSNAME">GtkButtonBox</tt>. It's an invisible layout
            container; <a href="cha-gtk.html">the chapter called
            <i>GTK+ Basics</i></a> describes it in some detail.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z386"><tt class="CLASSNAME">GtkHBox</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z387">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z388">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkhbox.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z389">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkHBox</tt> is a <tt class= 
            "CLASSNAME">GtkBox</tt> that packs widgets from left to
            right. The left side is considered the "start" of the
            box.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z390"><tt class="CLASSNAME">GnomeAppBar</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z391">Library</a>
          </h3>
          <p>
            Gnome
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z392">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">libgnomeui/gnome-appbar.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z393">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GnomeAppBar</tt> is a simple
            status bar with an optional progress meter. It does not
            have "contexts" like <tt class="CLASSNAME">
            GtkStatusbar</tt>. <a href="z91.html#SEC-APPBAR">the
            section called <i><tt class="CLASSNAME">
            GnomeAppBar</tt></i> in the chapter called <i>The Main
            Window: <tt class="CLASSNAME">GnomeApp</tt></i></a>
            gives more details.
          </p>
          <div class="FIGURE">
            <a name="Z394"></a>
            <p>
              <img src="figures/gnomeappbar.png">
            </p>
            <p>
              <b>Figure 13. <tt class="CLASSNAME">GnomeAppBar</tt>
              with the optional progress bar turned on.</b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z395"><tt class="CLASSNAME">
          GnomeDateEdit</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z396">Library</a>
          </h3>
          <p>
            Gnome
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z397">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">libgnomeui/gnome-dateedit.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z398">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GnomeDateEdit</tt> allows the
            user to edit a date and time. The time-editing part can
            be turned off if you are only interested in the date.
          </p>
          <div class="FIGURE">
            <a name="Z399"></a>
            <p>
              <img src="figures/gnomedateedit.png">
            </p>
            <p>
              <b>Figure 14. <tt class="CLASSNAME">
              GnomeDateEdit</tt></b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z400"><tt class="CLASSNAME">GtkCombo</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z401">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z402">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkcombo.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z403">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkCombo</tt> is a text entry box
            with a drop-down menu "quick choices." If you want to
            limit the user to a fixed set of options, a <tt class= 
            "CLASSNAME">GtkOptionMenu</tt> is more appropriate. <tt
            class="CLASSNAME">GtkCombo</tt> allows the user to type
            in anything, but offers some suggestions as well. <tt
            class="CLASSNAME">GnomeEntry</tt> is a combo box that
            adds items the user types in to the list of choices in
            the drop-down menu, and automatically remembers the
            list from session to session.
          </p>
          <div class="FIGURE">
            <a name="Z404"></a>
            <p>
              <img src="figures/gtkcombo.png">
            </p>
            <p>
              <b>Figure 15. <tt class="CLASSNAME">GtkCombo</tt></b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z405"><tt class="CLASSNAME">GnomeEntry</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z406">Library</a>
          </h3>
          <p>
            Gnome
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z407">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">libgnomeui/gnome-entry.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z408">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GnomeEntry</tt> is a <tt class= 
            "CLASSNAME">GtkCombo</tt> extension that uses the
            drop-down menu as a history. If the user types
            something which isn't in the history already, <tt
            class="CLASSNAME">GnomeEntry</tt> adds it and saves it
            in a configuration file to be loaded next time the
            application starts up.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z409"><tt class="CLASSNAME">
          GnomeFileEntry</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z410">Library</a>
          </h3>
          <p>
            Gnome
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z411">Header File</a>
          </h3>
          <p>
            <tt c