11aed263b7
Tue May 14 16:44:09 2002 Owen Taylor <otaylor@redhat.com> * gtk/gtklabel.c (gtk_label_ensure_layout): Set the width of the layout to the actual wrap width (our requisition) not the width we set when calculating the width. This results in the lines being justified within the correct area. (#79157, Anders Carlsson) * gtk/gtkaccelgroup.c gtk/gtkmarshelers.list: Corrected registered parameter types of "accel_activate" and "accel_changed" signals. (Patch from Murray Cumming, #78798) * gtk/gtkrc.c (gtk_rc_make_default_dir): Switch binary-version and type to correspond to the current ordering in _gtk_get_module_path. (#78746, Sergey Kuzminov) * gtk/gtkrc.c (gtk_rc_get_module_dir): Add docs pointing to the GTK_PATH documentation. * gtk/Makefile.am (uninstall-local): Delete key themes as well. (#81286, Kristian Rietveld.)
113 lines
2.6 KiB
Plaintext
113 lines
2.6 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkOptionMenu
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
a widget used to choose from a list of valid choices.
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
A #GtkOptionMenu is a widget that allows the user to choose from a
|
|
list of valid choices. The #GtkOptionMenu displays the selected
|
|
choice. When activated the #GtkOptionMenu displays a popup #GtkMenu
|
|
which allows the user to make a new choice.
|
|
</para>
|
|
|
|
<para>
|
|
Using a #GtkOptionMenu is simple; build a #GtkMenu, by calling
|
|
gtk_menu_new(), then appending menu items to it with
|
|
gtk_menu_shell_append(). Set that menu on the option menu
|
|
with gtk_option_menu_set_menu(). Set the selected menu item with
|
|
gtk_option_menu_set_history(); connect to the "changed" signal on
|
|
the option menu; in the "changed" signal, check the new selected
|
|
menu item with gtk_option_menu_get_history().
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
|
|
<!-- ##### STRUCT GtkOptionMenu ##### -->
|
|
<para>
|
|
The #GtkOptionMenu-struct struct contains private data only, and
|
|
should be accessed using the functions below.
|
|
</para>
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_option_menu_new ##### -->
|
|
<para>
|
|
Creates a new #GtkOptionMenu.
|
|
</para>
|
|
|
|
@Returns: a new #GtkOptionMenu.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_option_menu_get_menu ##### -->
|
|
<para>
|
|
Returns the #GtkMenu associated with the #GtkOptionMenu.
|
|
</para>
|
|
|
|
@option_menu: a #GtkOptionMenu.
|
|
@Returns: the #GtkMenu associated with the #GtkOptionMenu.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_option_menu_set_menu ##### -->
|
|
<para>
|
|
Provides the #GtkMenu that is popped up to allow the user to choose
|
|
a new value. You should provide a simple menu avoiding the
|
|
use of tearoff menu items, submenus, and accelerators.
|
|
</para>
|
|
|
|
@option_menu: a #GtkOptionMenu.
|
|
@menu: the #GtkMenu to associate with the #GtkOptionMenu.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_option_menu_remove_menu ##### -->
|
|
<para>
|
|
Removes the menu from the option menu.
|
|
</para>
|
|
|
|
@option_menu: a #GtkOptionMenu.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_option_menu_set_history ##### -->
|
|
<para>
|
|
Selects the menu item specified by @index making it the newly
|
|
selected value for the option menu.
|
|
</para>
|
|
|
|
@option_menu: a #GtkOptionMenu.
|
|
@index: the index of the menu item to select. Index values are from
|
|
0 to n-1.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_option_menu_get_history ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@option_menu:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### SIGNAL GtkOptionMenu::changed ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@optionmenu: the object which received the signal.
|
|
|
|
<!-- ##### ARG GtkOptionMenu:menu ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkOptionMenu:indicator-size ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkOptionMenu:indicator-spacing ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|