manpagez: man pages & more
html files: gtk2
Home | html | info | man

GtkOptionMenu

GtkOptionMenu — A widget used to choose from a list of valid choices

Properties

GtkMenu * menu Read / Write

Style Properties

Signals

Types and Values

struct GtkOptionMenu

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkButton
                            ╰── GtkOptionMenu

Implemented Interfaces

GtkOptionMenu implements AtkImplementorIface, GtkBuildable and GtkActivatable.

Includes

#include <gtk/gtk.h>

Description

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.

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().

As of GTK+ 2.4, GtkOptionMenu has been deprecated in favor of GtkComboBox.

Functions

gtk_option_menu_new ()

GtkWidget *
gtk_option_menu_new (void);

gtk_option_menu_new has been deprecated since version 2.4 and should not be used in newly-written code.

Use GtkComboBox instead.

Creates a new GtkOptionMenu.

Returns

a new GtkOptionMenu.


gtk_option_menu_get_menu ()

GtkWidget *
gtk_option_menu_get_menu (GtkOptionMenu *option_menu);

gtk_option_menu_get_menu has been deprecated since version 2.4 and should not be used in newly-written code.

Use GtkComboBox instead.

Returns the GtkMenu associated with the GtkOptionMenu.

Parameters

option_menu

a GtkOptionMenu.

 

Returns

the GtkMenu associated with the GtkOptionMenu.


gtk_option_menu_set_menu ()

void
gtk_option_menu_set_menu (GtkOptionMenu *option_menu,
                          GtkWidget *menu);

gtk_option_menu_set_menu has been deprecated since version 2.4 and should not be used in newly-written code.

Use GtkComboBox instead.

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.

Parameters

option_menu

a GtkOptionMenu.

 

menu

the GtkMenu to associate with the GtkOptionMenu.

 

gtk_option_menu_remove_menu ()

void
gtk_option_menu_remove_menu (GtkOptionMenu *option_menu);

gtk_option_menu_remove_menu has been deprecated since version 2.4 and should not be used in newly-written code.

Use GtkComboBox instead.

Removes the menu from the option menu.

Parameters

option_menu

a GtkOptionMenu.

 

gtk_option_menu_set_history ()

void
gtk_option_menu_set_history (GtkOptionMenu *option_menu,
                             guint index_);

gtk_option_menu_set_history has been deprecated since version 2.4 and should not be used in newly-written code.

Use GtkComboBox instead.

Selects the menu item specified by index_ making it the newly selected value for the option menu.

Parameters

option_menu

a GtkOptionMenu.

 

index_

the index of the menu item to select. Index values are from 0 to n-1.

 

gtk_option_menu_get_history ()

gint
gtk_option_menu_get_history (GtkOptionMenu *option_menu);

gtk_option_menu_get_history has been deprecated since version 2.4 and should not be used in newly-written code.

Use GtkComboBox instead.

Retrieves the index of the currently selected menu item. The menu items are numbered from top to bottom, starting with 0.

Parameters

option_menu

a GtkOptionMenu

 

Returns

index of the selected menu item, or -1 if there are no menu items

Types and Values

struct GtkOptionMenu

struct GtkOptionMenu;

GtkOptionMenu has been deprecated since version 2.4 and should not be used in newly-written code.

Use GtkComboBox instead.

The GtkOptionMenu struct contains private data only, and should be accessed using the functions below.

Property Details

The “menu” property

  “menu”                     GtkMenu *

The menu of options.

Flags: Read / Write

Style Property Details

The “indicator-size” style property

  “indicator-size”           GtkRequisition *

Size of dropdown indicator.

Flags: Read


The “indicator-spacing” style property

  “indicator-spacing”        GtkBorder *

Spacing around indicator.

Flags: Read

Signal Details

The “changed” signal

void
user_function (GtkOptionMenu *optionmenu,
               gpointer       user_data)

Parameters

optionmenu

the object which received the signal.

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last

© manpagez.com 2000-2024
Individual documents may contain additional copyright information.