z207.html

GTK+_ Gnome Application Development

            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z283"><tt class="CLASSNAME">
          GnomeColorPicker</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z284">Library</a>
          </h3>
          <p>
            Gnome
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z285">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">
            libgnomeui/gnome-color-picker.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z286">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GnomeColorPicker</tt> is a button
            containing a small colored square indicating the
            currently selected color. When clicked, it creates a
            color selection dialog to change the selected color.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z287"><tt class="CLASSNAME">
          GnomeFontPicker</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z288">Library</a>
          </h3>
          <p>
            Gnome
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z289">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">
            libgnomeui/gnome-font-picker.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z290">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GnomeFontPicker</tt> is analagous
            to <tt class="CLASSNAME">GnomeColorPicker</tt>; it's a
            button showing the currently selected font, which pops
            up a font selection dialog when clicked.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z291"><tt class="CLASSNAME">GnomeHRef</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z292">Library</a>
          </h3>
          <p>
            Gnome
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z293">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">libgnomeui/gnome-href.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z294">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GnomeHRef</tt> is a borderless
            button with a hyperlink displayed on it. When the
            button is clicked, Gnome points the user's browser at
            the hyperlink's target URL, or launches a new browser
            instance. The command used to go to the URL is globally
            configurable from the Gnome control center.
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z295"><tt class="CLASSNAME">
          GtkToggleButton</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z296">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z297">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtktogglebutton.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z298">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkToggleButton</tt> looks much
            like a regular <span class="STRUCTNAME">
            GtkButton</span>. However, it is intended to reflect a
            toggleable state; when the toggle is "active," the
            button appears to be depressed. <tt class="CLASSNAME">
            GtkCheckButton</tt> should often be used instead of the
            toggle button; the check button usually looks nicer
            than <tt class="CLASSNAME">GtkToggleButton</tt>, and
            gives the user a better idea that the button represents
            a toggleable state.
          </p>
          <div class="FIGURE">
            <a name="Z299"></a>
            <p>
              <img src="figures/gtktogglebutton.png">
            </p>
            <p>
              <b>Figure 5. Three <tt class="CLASSNAME">
              GtkToggleButton</tt> widgets; the center one is
              "active."</b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z300"><tt class="CLASSNAME">
          GtkCheckButton</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z301">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z302">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkcheckbutton.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z303">Description</a>
          </h3>
          <p>
            The <tt class="CLASSNAME">GtkCheckButton</tt> widget
            works just like the <tt class="CLASSNAME">
            GtkToggleButton</tt>, but looks different (it looks
            like a label with a small button to the left). In most
            cases, the check button is a better choice than the
            toggle button, because the toggle button does not give
            the user a visual hint that it represents a toggleable
            state.
          </p>
          <div class="FIGURE">
            <a name="Z304"></a>
            <p>
              <img src="figures/gtkcheckbutton.png">
            </p>
            <p>
              <b>Figure 6. Three <tt class="CLASSNAME">
              GtkCheckButton</tt> widgets; the center one is
              "active."</b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z305"><tt class="CLASSNAME">
          GtkRadioButton</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z306">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z307">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkradiobutton.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z308">Description</a>
          </h3>
          <p>
            A radio button represents one of several
            mutually-exclusive options. Radio buttons are placed in
            "groups"; only one button in a group can be active at a
            given time. <tt class="CLASSNAME">GtkOptionMenu</tt>
            can also be used to represent mutually exclusive
            options; an option menu is typically a better choice if
            there are more than a few options. A <tt class= 
            "CLASSNAME">GtkList</tt> or <tt class="CLASSNAME">
            GtkCList</tt> might be appropriate if there are a truly
            large number of options.
          </p>
          <div class="FIGURE">
            <a name="Z309"></a>
            <p>
              <img src="figures/gtkradiobutton.png">
            </p>
            <p>
              <b>Figure 7. A group of three <tt class="CLASSNAME">
              GtkRadioButton</tt>s</b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z310"><tt class="CLASSNAME">
          GtkOptionMenu</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z311">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z312">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkoptionmenu.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z313">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkOptionMenu</tt> displays the
            currently active item from among a number of options;
            when clicked, it pops up a menu to allow the user to
            make a new item active. The option menu is slightly
            broken; it does not take the size of the menu items
            into account when requesting its size. If you have menu
            items containing labels in the option menu, the labels
            will often be truncated. The best workaround is to give
            the option menu more space than it requests, by setting
            appropriate options on its parent container.
          </p>
          <div class="FIGURE">
            <a name="Z314"></a>
            <p>
              <img src="figures/gtkoptionmenu.png">
            </p>
            <p>
              <b>Figure 8. <tt class="CLASSNAME">
              GtkOptionMenu</tt></b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z315"><tt class="CLASSNAME">
          GnomeDockItem</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z316">Library</a>
          </h3>
          <p>
            Gnome
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z317">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">libgnomeui/gnome-dock-item.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z318">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GnomeDockItem</tt> is a container
            that allows its child to appear on a <tt class= 
            "CLASSNAME">GnomeDock</tt>. Dock items can be detached
            from their parent window and placed anywhere on the
            desktop; they can also be moved around within the dock.
            <tt class="CLASSNAME">GnomeDock</tt> lets users
            rearrange Gnome toolbars. <tt class="CLASSNAME">
            GnomeDockItem</tt> provides the "handle" for dragging
            its child. <tt class="CLASSNAME">GnomeApp</tt> uses <tt
            class="CLASSNAME">GnomeDock</tt> internally, so Gnome
            toolbars are all repositionable.
          </p>
          <div class="FIGURE">
            <a name="Z319"></a>
            <p>
              <img src="figures/gnomedock.png">
            </p>
            <p>
              <b>Figure 9. <tt class="CLASSNAME">GnomeDock</tt>,
              with several <tt class="CLASSNAME">
              GnomeDockItem</tt>s.</b>
            </p>
          </div>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z320"><tt class="CLASSNAME">
          GtkAlignment</tt></a>
        </h2>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z321">Library</a>
          </h3>
          <p>
            GTK+
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z322">Header File</a>
          </h3>
          <p>
            <tt class="FILENAME">gtk/gtkalignment.h</tt>
          </p>
        </div>
        <div class="SECT3">
          <h3 class="SECT3">
            <a name="Z323">Description</a>
          </h3>
          <p>
            <tt class="CLASSNAME">GtkAlignment</tt> is an invisible
            container used to align a child widget within some
            space. It lets you set two factors, each in both the X
            and Y direction; the <i class="FIRSTTERM">alignment</i>
            is 0.0 for left-justified (or top-justified) and 1.0
            for right-justified (or bottom-justified). An alignment
            of 0.5 centers the child in that direction. The <i
            class="FIRSTTERM">scale</i> factor determines how the
            child fills extra space it did not request; if 0.0, the
            child fills only its requisition. A scale of 1.0 means
            that the child always expands to fill all the available
            space. (Clearly, a 1.0 scale factor makes the alignment
            factor irrelevant.)
          </p>
        </div>
      </div>
      <div class="SECT2">
        <h2 class="SECT2">
          <a name="Z324"><tt class="CLASSNAME">GtkFrame</tt></a>