## GOComboBox

GOComboBox

## Synopsis

                        GOComboBox;
    #define             GO_TYPE_COMBO_BOX
    #define             GO_COMBO_BOX                        (o)
    #define             GO_IS_COMBO_BOX                     (o)
    #define             GO_COMBO_BOX_CLASS                  (k)
                        GOComboBoxPrivate;
    GType               go_combo_box_get_type               (void);
    void                go_combo_box_set_tooltip            (GOComboBox *combo,
                                                             void *tips,
                                                             char const *text,
                                                             char const *priv_text);
    void                go_combo_box_set_relief             (GOComboBox *combo,
                                                             GtkReliefStyle relief);
    void                go_combo_box_set_title              (GOComboBox *combo,
                                                             char const *title);
    charconst *         go_combo_box_get_title              (GOComboBox *combo);
    void                go_combo_box_set_tearable           (GOComboBox *combo,
                                                             gboolean tearable);
    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);
    void                go_combo_box_popup_hide             (GOComboBox *combo);
    void                go_combo_box_popup_display          (GOComboBox *combo);
    void                go_combo_box_set_display            (GOComboBox *combo,
                                                             GtkWidget *display_widget);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkHBox
                                           +----GOComboBox
                                                 +----GOComboPixmaps
                                                 +----GOComboColor
                                                 +----GOCalendarButton
                                                 +----GOComboText

## Implemented Interfaces

GOComboBox implements AtkImplementorIface and GtkBuildable.

## Signals

      "pop-down-done"                                  : Run Last

## Description

## Details

### GOComboBox

    typedef struct _GOComboBox GOComboBox;

### GO_TYPE_COMBO_BOX

    #define GO_TYPE_COMBO_BOX	(go_combo_box_get_type())

### GO_COMBO_BOX()

    #define GO_COMBO_BOX(o)		G_TYPE_CHECK_INSTANCE_CAST ((o), GO_TYPE_COMBO_BOX, GOComboBox)

`o` : |

### GO_IS_COMBO_BOX()

    #define GO_IS_COMBO_BOX(o)	G_TYPE_CHECK_INSTANCE_TYPE ((o), GO_TYPE_COMBO_BOX)

`o` : |

### GO_COMBO_BOX_CLASS()

    #define GO_COMBO_BOX_CLASS(k)	G_TYPE_CHECK_CLASS_CAST ((k), GO_TYPE_COMBO_BOX, GOComboBoxClass)

`k` : |

### GOComboBoxPrivate

    typedef struct _GOComboBoxPrivate GOComboBoxPrivate;

### go_combo_box_get_type ()

    GType               go_combo_box_get_type               (void);

Returns : |

### go_combo_box_set_tooltip ()

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

`combo` : |
`tips` : |
`text` : |
`priv_text` : |

### go_combo_box_set_relief ()

    void                go_combo_box_set_relief             (GOComboBox *combo,
                                                             GtkReliefStyle relief);

`combo` : |
`relief` : |

### 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_get_title ()

    charconst *         go_combo_box_get_title              (GOComboBox *combo);

`combo` : |
Returns : |

### 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_construct ()

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

`combo` : |
`display_widget` : |
`popdown_container` : |
`popdown_focus` : |

### go_combo_box_get_pos ()

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

`combo` : |
`x` : |
`y` : |

### 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_popup_display ()

    void                go_combo_box_popup_display          (GOComboBox *combo);

`combo` : |

### 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

## 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.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.
Returns : |