GOComboBox

GOComboBox

Synopsis

                    GOComboBox;
                    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

GOComboBox

typedef struct _GOComboBox GOComboBox;


GOComboBoxClass

typedef struct {
	/* 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 *);
} GOComboBoxClass;

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);

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

char const *        go_combo_box_get_title              (GOComboBox *combo);

combo :

Returns :


go_combo_box_popup_display ()

void                go_combo_box_popup_display          (GOComboBox *combo);

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);

combo :

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);

combo :

tips :

text :

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.

arg1 :

user_data :

user data set when the signal handler was connected.

Returns :