forked from AuroraMiddleware/gtk
7359903ef0
Sun Feb 29 01:51:27 2004 Jonathan Blandford <jrb@gnome.org>
* gtk/gtkfilechooserembed.c
(_gtk_file_chooser_embed_get_default_size): Add g_return_if_fail()
(_gtk_file_chooser_embed_get_resizable_hints): Add g_return_if_fail()
* gtk/gtkfilechooserdialog.c
(file_chooser_widget_default_size_changed): Get the correct
initial size for the dialog. Also, don't bother with
gtk_window_set_default_size(). It's not really meaningful.
* gtk/gtkfilechooserdefault.c
(gtk_file_chooser_default_get_default_size): Get the correct
spacing for the preview_widget
(update_preview_widget_visibility): Clear widget field after we
destroy it.
122 lines
2.9 KiB
Plaintext
122 lines
2.9 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>
|
|
|
|
<para>
|
|
As of GTK+ 2.4, #GtkOptionMenu has been deprecated in favor of #GtkComboBox.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
|
|
<!-- ##### STRUCT GtkOptionMenu ##### -->
|
|
<para>
|
|
The #GtkOptionMenu-struct struct contains private data only, and
|
|
should be accessed using the functions below.
|
|
</para>
|
|
|
|
@Deprecated: Use #GtkComboBox instead.
|
|
|
|
<!-- ##### 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>
|
|
|
|
<!-- ##### FUNCTION gtk_option_menu_new ##### -->
|
|
<para>
|
|
Creates a new #GtkOptionMenu.
|
|
</para>
|
|
|
|
@Returns: a new #GtkOptionMenu.
|
|
@Deprecated: Use #GtkComboBox instead.
|
|
|
|
|
|
<!-- ##### 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.
|
|
@Deprecated: Use #GtkComboBox instead.
|
|
|
|
|
|
<!-- ##### 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.
|
|
@Deprecated: Use #GtkComboBox instead.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_option_menu_remove_menu ##### -->
|
|
<para>
|
|
Removes the menu from the option menu.
|
|
</para>
|
|
|
|
@option_menu: a #GtkOptionMenu.
|
|
@Deprecated: Use #GtkComboBox instead.
|
|
|
|
|
|
<!-- ##### 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.
|
|
@Deprecated: Use #GtkComboBox instead.
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_option_menu_get_history ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@option_menu:
|
|
@Returns:
|
|
|
|
|