2 * Copyright (C) 2002, 2003 Kristian Rietveld <kris@gtk.org>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
20 #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
21 #error "Only <gtk/gtk.h> can be included directly."
24 #ifndef __GTK_COMBO_BOX_H__
25 #define __GTK_COMBO_BOX_H__
27 #include <gtk/gtkbin.h>
28 #include <gtk/gtktreemodel.h>
29 #include <gtk/gtktreeview.h>
33 #define GTK_TYPE_COMBO_BOX (gtk_combo_box_get_type ())
34 #define GTK_COMBO_BOX(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_COMBO_BOX, GtkComboBox))
35 #define GTK_COMBO_BOX_CLASS(vtable) (G_TYPE_CHECK_CLASS_CAST ((vtable), GTK_TYPE_COMBO_BOX, GtkComboBoxClass))
36 #define GTK_IS_COMBO_BOX(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_COMBO_BOX))
37 #define GTK_IS_COMBO_BOX_CLASS(vtable) (G_TYPE_CHECK_CLASS_TYPE ((vtable), GTK_TYPE_COMBO_BOX))
38 #define GTK_COMBO_BOX_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), GTK_TYPE_COMBO_BOX, GtkComboBoxClass))
40 typedef struct _GtkComboBox GtkComboBox;
41 typedef struct _GtkComboBoxClass GtkComboBoxClass;
42 typedef struct _GtkComboBoxPrivate GtkComboBoxPrivate;
46 GtkBin parent_instance;
49 GtkComboBoxPrivate *priv;
52 struct _GtkComboBoxClass
54 GtkBinClass parent_class;
57 void (* changed) (GtkComboBox *combo_box);
59 /* Padding for future expansion */
60 void (*_gtk_reserved1) (void);
61 void (*_gtk_reserved2) (void);
62 void (*_gtk_reserved3) (void);
63 void (*_gtk_reserved4) (void);
68 GType gtk_combo_box_get_type (void) G_GNUC_CONST;
69 GtkWidget *gtk_combo_box_new (void);
70 GtkWidget *gtk_combo_box_new_with_area (GtkCellArea *area);
71 GtkWidget *gtk_combo_box_new_with_area_and_entry (GtkCellArea *area);
72 GtkWidget *gtk_combo_box_new_with_entry (void);
73 GtkWidget *gtk_combo_box_new_with_model (GtkTreeModel *model);
74 GtkWidget *gtk_combo_box_new_with_model_and_entry (GtkTreeModel *model);
77 gint gtk_combo_box_get_wrap_width (GtkComboBox *combo_box);
78 void gtk_combo_box_set_wrap_width (GtkComboBox *combo_box,
80 gint gtk_combo_box_get_row_span_column (GtkComboBox *combo_box);
81 void gtk_combo_box_set_row_span_column (GtkComboBox *combo_box,
83 gint gtk_combo_box_get_column_span_column (GtkComboBox *combo_box);
84 void gtk_combo_box_set_column_span_column (GtkComboBox *combo_box,
87 gboolean gtk_combo_box_get_add_tearoffs (GtkComboBox *combo_box);
88 void gtk_combo_box_set_add_tearoffs (GtkComboBox *combo_box,
89 gboolean add_tearoffs);
91 const gchar * gtk_combo_box_get_title (GtkComboBox *combo_box);
92 void gtk_combo_box_set_title (GtkComboBox *combo_box,
95 gboolean gtk_combo_box_get_focus_on_click (GtkComboBox *combo);
96 void gtk_combo_box_set_focus_on_click (GtkComboBox *combo,
97 gboolean focus_on_click);
99 /* get/set active item */
100 gint gtk_combo_box_get_active (GtkComboBox *combo_box);
101 void gtk_combo_box_set_active (GtkComboBox *combo_box,
103 gboolean gtk_combo_box_get_active_iter (GtkComboBox *combo_box,
105 void gtk_combo_box_set_active_iter (GtkComboBox *combo_box,
108 /* getters and setters */
109 void gtk_combo_box_set_model (GtkComboBox *combo_box,
110 GtkTreeModel *model);
111 GtkTreeModel *gtk_combo_box_get_model (GtkComboBox *combo_box);
113 GtkTreeViewRowSeparatorFunc gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box);
114 void gtk_combo_box_set_row_separator_func (GtkComboBox *combo_box,
115 GtkTreeViewRowSeparatorFunc func,
117 GDestroyNotify destroy);
119 void gtk_combo_box_set_button_sensitivity (GtkComboBox *combo_box,
120 GtkSensitivityType sensitivity);
121 GtkSensitivityType gtk_combo_box_get_button_sensitivity (GtkComboBox *combo_box);
123 gboolean gtk_combo_box_get_has_entry (GtkComboBox *combo_box);
124 void gtk_combo_box_set_entry_text_column (GtkComboBox *combo_box,
126 gint gtk_combo_box_get_entry_text_column (GtkComboBox *combo_box);
128 void gtk_combo_box_set_popup_fixed_width (GtkComboBox *combo_box,
130 gboolean gtk_combo_box_get_popup_fixed_width (GtkComboBox *combo_box);
132 /* programmatic control */
133 void gtk_combo_box_popup (GtkComboBox *combo_box);
134 void gtk_combo_box_popup_for_device (GtkComboBox *combo_box,
136 void gtk_combo_box_popdown (GtkComboBox *combo_box);
137 AtkObject* gtk_combo_box_get_popup_accessible (GtkComboBox *combo_box);
139 gint gtk_combo_box_get_id_column (GtkComboBox *combo_box);
140 void gtk_combo_box_set_id_column (GtkComboBox *combo_box,
142 const gchar * gtk_combo_box_get_active_id (GtkComboBox *combo_box);
143 gboolean gtk_combo_box_set_active_id (GtkComboBox *combo_box,
144 const gchar *active_id);
148 #endif /* __GTK_COMBO_BOX_H__ */