The GtkFramedCombo widget is derivated from GtkFrame.
Its purpose is to provide a better aspect to ComboBox by putting a label
on top of it and a nice frame around.
It basically looks like this:
+-------------------+
| descriptive label |
| [ combo ][V] |
+-------------------+
Description:
------------
The GtkFramedCombo is very similar in its use to the GtkCombo widget.
Only the creation function is different.
Functions:
----------
The GtkFramedCombo widgets are created with this function:
GtkWidget *gtk_framed_combo_new(gchar *Label);
where 'Label' is the label to be displayed on top of the Combo.
And you can use all these functions which are very similar to the
GtkCombo ones' appart from the function name (obviously) and the
type of the first parameter.
void gtk_framed_combo_set_value_in_list(GtkFramedCombo *FramedCombo,
gint val,
gint ok_if_empty);
void gtk_framed_combo_set_use_arrows(GtkFramedCombo *FramedCombo,
gint val);
void gtk_framed_combo_set_use_arrows_always(GtkFramedCombo *FramedCombo,
gint val);
void gtk_framed_combo_set_case_sensitive(GtkFramedCombo *FramedCombo,
gint val);
void gtk_framed_combo_set_item_string(GtkFramedCombo *FramedCombo,
GtkItem *item,
const gchar *item_value);
void gtk_framed_combo_set_popdown_strings(GtkFramedCombo *FramedCombo,
GList *strings);
void gtk_framed_combo_disable_activate(GtkFramedCombo *FramedCombo);
Be carefull that you can't use gtk_combo_* function with GtkFramedCombo
widgets.
Signals:
--------
No new signals for this widget.
Args:
-----
No new args for this widget.
Fields:
-------
You can access these read only fields of GtkFramedCombo:
GtkWidget *Label; The On top label.
GtkWidget *Combo; The inner combo.
GtkWidget *entry, *list; These are helper fields. They are strictly
equivalents to Combo->entry and Combo->list.
They are here so you can simply write:
GTK_FRAMED_COMBO(MyframedCombo)->entry
so it should be easier to convert your apps that were using GTK_COMBO.
