## GOComboBox

GOComboBox

## Synopsis

    struct              GOComboBox;
    struct              GOComboBoxClass;
    void                go_combo_box_construct              (GOComboBox *combo,
                                                             GtkWidget *display_widget,
                                                             GtkWidget *popdown_container,
                                                             GtkWidget *popdown_focus);
    void                go_combo_box_get_pos                (GOComboBox *combo,
                                                             int *x,
                                                             int *y);
    char const *        go_combo_box_get_title              (GOComboBox *combo);
    void                go_combo_box_popup_display          (GOComboBox *combo);
    void                go_combo_box_popup_hide             (GOComboBox *combo);
    void                go_combo_box_set_display            (GOComboBox *combo,
                                                             GtkWidget *display_widget);
    void                go_combo_box_set_relief             (GOComboBox *combo,
                                                             GtkReliefStyle relief);
    void                go_combo_box_set_tearable           (GOComboBox *combo,
                                                             gboolean tearable);
    void                go_combo_box_set_title              (GOComboBox *combo,
                                                             char const *title);
    void                go_combo_box_set_tooltip            (GOComboBox *combo,
                                                             void *tips,
                                                             char const *text,
                                                             char const *priv_text);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkWidget
                   +----GtkContainer
                         +----GtkBox
                               +----GOComboBox
                                     +----GOCalendarButton
                                     +----GOComboColor
                                     +----GOComboPixmaps

## Implemented Interfaces

GOComboBox implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Signals

      "pop-down-done"                                  : Run Last

## Description

## Details

### struct GOComboBox

    struct GOComboBox;

### struct GOComboBoxClass

    struct GOComboBoxClass {
    	/* virtual */
    	void  (*set_title) (GOComboBox *combo, char const *title);

    	/* invoked when the popup has been hidden, if the signal
    	 * returns TRUE, it means it should be killed */
    	gboolean   (*pop_down_done)   (GOComboBox *combo, GtkWidget *);
    };

`set_title` () | sets the title.
`pop_down_done` () | invoked when the popup has been hidden, if the signal returns `TRUE`, it means it should be killed

### go_combo_box_construct ()

    void                go_combo_box_construct              (GOComboBox *combo,
                                                             GtkWidget *display_widget,
                                                             GtkWidget *popdown_container,
                                                             GtkWidget *popdown_focus);

### go_combo_box_get_pos ()

    void                go_combo_box_get_pos                (GOComboBox *combo,
                                                             int *x,
                                                             int *y);

### go_combo_box_get_title ()

    char const *        go_combo_box_get_title              (GOComboBox *combo);

### go_combo_box_popup_display ()

    void                go_combo_box_popup_display          (GOComboBox *combo);

### go_combo_box_popup_hide ()

    void                go_combo_box_popup_hide             (GOComboBox *combo);

Hides popup, but not when it is torn off. This is the external interface - for subclasses and apps which expect a regular combo which doesn't do tearoffs.

`combo` : | a GOComboBox

### go_combo_box_set_display ()

    void                go_combo_box_set_display            (GOComboBox *combo,
                                                             GtkWidget *display_widget);

Sets the displayed widget for the `combo_box` to be `display_widget`

`combo` : | the GOComboBox to modify
`display_widget` : | The widget to be displayed

### go_combo_box_set_relief ()

    void                go_combo_box_set_relief             (GOComboBox *combo,
                                                             GtkReliefStyle relief);

### go_combo_box_set_tearable ()

    void                go_combo_box_set_tearable           (GOComboBox *combo,
                                                             gboolean tearable);

controls whether the combo box's pop up widget can be torn off.

`combo` : | Combo box
`tearable` : | whether to allow the `combo` to be tearable

### go_combo_box_set_title ()

    void                go_combo_box_set_title              (GOComboBox *combo,
                                                             char const *title);

Set a title to display over the tearoff window.

FIXME:

This should really change the title even when the popup is already torn off. I guess the tearoff window could attach a listener to title change or something. But I don't think we need the functionality, so I didn't bother to investigate.

MW: Just make it a property.

`combo` : | Combo box
`title` : | Title

### go_combo_box_set_tooltip ()

    void                go_combo_box_set_tooltip            (GOComboBox *combo,
                                                             void *tips,
                                                             char const *text,
                                                             char const *priv_text);

## Signal Details

### The `"pop-down-done"` signal

    gboolean            user_function                      (GOComboBox *gocombobox,
                                                            GObject    *arg1,
                                                            gpointer    user_data)       : Run Last

`gocombobox` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.