1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<title>GtkComboBox</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
7
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
8
<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
9
<link rel="prev" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
10
<link rel="next" href="GtkComboBoxText.html" title="GtkComboBoxText">
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17
<td><a accesskey="p" href="MenusAndCombos.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
<td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
<th width="100%" align="center">GTK+ 2 Reference Manual</th>
21
<td><a accesskey="n" href="GtkComboBoxText.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23
<tr><td colspan="5" class="shortcuts">
24
<a href="#GtkComboBox.synopsis" class="shortcut">Top</a>
26
<a href="#GtkComboBox.description" class="shortcut">Description</a>
28
<a href="#GtkComboBox.object-hierarchy" class="shortcut">Object Hierarchy</a>
30
<a href="#GtkComboBox.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
32
<a href="#GtkComboBox.properties" class="shortcut">Properties</a>
34
<a href="#GtkComboBox.style-properties" class="shortcut">Style Properties</a>
36
<a href="#GtkComboBox.signals" class="shortcut">Signals</a>
39
<div class="refentry">
40
<a name="GtkComboBox"></a><div class="titlepage"></div>
41
<div class="refnamediv"><table width="100%"><tr>
43
<h2><span class="refentrytitle"><a name="GtkComboBox.top_of_page"></a>GtkComboBox</span></h2>
44
<p>GtkComboBox — A widget used to choose from a list of items</p>
46
<td valign="top" align="right"><img src="combo-box.png"></td>
48
<div class="refsynopsisdiv">
49
<a name="GtkComboBox.synopsis"></a><h2>Synopsis</h2>
50
<pre class="synopsis">
51
#include <gtk/gtk.h>
53
struct <a class="link" href="GtkComboBox.html#GtkComboBox-struct" title="struct GtkComboBox">GtkComboBox</a>;
54
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkComboBox.html#gtk-combo-box-new" title="gtk_combo_box_new ()">gtk_combo_box_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
55
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkComboBox.html#gtk-combo-box-new-with-entry" title="gtk_combo_box_new_with_entry ()">gtk_combo_box_new_with_entry</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
56
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkComboBox.html#gtk-combo-box-new-with-model" title="gtk_combo_box_new_with_model ()">gtk_combo_box_new_with_model</a> (<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);
57
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkComboBox.html#gtk-combo-box-new-with-model-and-entry" title="gtk_combo_box_new_with_model_and_entry ()">gtk_combo_box_new_with_model_and_entry</a>
58
(<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);
59
<span class="returnvalue">gint</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-wrap-width" title="gtk_combo_box_get_wrap_width ()">gtk_combo_box_get_wrap_width</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
60
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-wrap-width" title="gtk_combo_box_set_wrap_width ()">gtk_combo_box_set_wrap_width</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
61
<em class="parameter"><code><span class="type">gint</span> width</code></em>);
62
<span class="returnvalue">gint</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-row-span-column" title="gtk_combo_box_get_row_span_column ()">gtk_combo_box_get_row_span_column</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
63
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-row-span-column" title="gtk_combo_box_set_row_span_column ()">gtk_combo_box_set_row_span_column</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
64
<em class="parameter"><code><span class="type">gint</span> row_span</code></em>);
65
<span class="returnvalue">gint</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-column-span-column" title="gtk_combo_box_get_column_span_column ()">gtk_combo_box_get_column_span_column</a>
66
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
67
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-column-span-column" title="gtk_combo_box_set_column_span_column ()">gtk_combo_box_set_column_span_column</a>
68
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
69
<em class="parameter"><code><span class="type">gint</span> column_span</code></em>);
70
<span class="returnvalue">gint</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-active" title="gtk_combo_box_get_active ()">gtk_combo_box_get_active</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
71
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-active" title="gtk_combo_box_set_active ()">gtk_combo_box_set_active</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
72
<em class="parameter"><code><span class="type">gint</span> index_</code></em>);
73
<span class="returnvalue">gboolean</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-active-iter" title="gtk_combo_box_get_active_iter ()">gtk_combo_box_get_active_iter</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
74
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);
75
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-active-iter" title="gtk_combo_box_set_active_iter ()">gtk_combo_box_set_active_iter</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
76
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);
77
<a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="returnvalue">GtkTreeModel</span></a> * <a class="link" href="GtkComboBox.html#gtk-combo-box-get-model" title="gtk_combo_box_get_model ()">gtk_combo_box_get_model</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
78
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-model" title="gtk_combo_box_set_model ()">gtk_combo_box_set_model</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
79
<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);
80
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()">gtk_combo_box_new_text</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
81
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-append-text" title="gtk_combo_box_append_text ()">gtk_combo_box_append_text</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
82
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);
83
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-insert-text" title="gtk_combo_box_insert_text ()">gtk_combo_box_insert_text</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
84
<em class="parameter"><code><span class="type">gint</span> position</code></em>,
85
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);
86
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-prepend-text" title="gtk_combo_box_prepend_text ()">gtk_combo_box_prepend_text</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
87
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);
88
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-remove-text" title="gtk_combo_box_remove_text ()">gtk_combo_box_remove_text</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
89
<em class="parameter"><code><span class="type">gint</span> position</code></em>);
90
<span class="returnvalue">gchar</span> * <a class="link" href="GtkComboBox.html#gtk-combo-box-get-active-text" title="gtk_combo_box_get_active_text ()">gtk_combo_box_get_active_text</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
91
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-popup" title="gtk_combo_box_popup ()">gtk_combo_box_popup</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
92
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-popdown" title="gtk_combo_box_popdown ()">gtk_combo_box_popdown</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
93
<a href="/usr/share/gtk-doc/html/atk/AtkObject.html"><span class="returnvalue">AtkObject</span></a> * <a class="link" href="GtkComboBox.html#gtk-combo-box-get-popup-accessible" title="gtk_combo_box_get_popup_accessible ()">gtk_combo_box_get_popup_accessible</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
94
<a class="link" href="GtkTreeView.html#GtkTreeViewRowSeparatorFunc" title="GtkTreeViewRowSeparatorFunc ()"><span class="returnvalue">GtkTreeViewRowSeparatorFunc</span></a> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-row-separator-func" title="gtk_combo_box_get_row_separator_func ()">gtk_combo_box_get_row_separator_func</a>
95
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
96
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-row-separator-func" title="gtk_combo_box_set_row_separator_func ()">gtk_combo_box_set_row_separator_func</a>
97
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
98
<em class="parameter"><code><a class="link" href="GtkTreeView.html#GtkTreeViewRowSeparatorFunc" title="GtkTreeViewRowSeparatorFunc ()"><span class="type">GtkTreeViewRowSeparatorFunc</span></a> func</code></em>,
99
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
100
<em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);
101
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-add-tearoffs" title="gtk_combo_box_set_add_tearoffs ()">gtk_combo_box_set_add_tearoffs</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
102
<em class="parameter"><code><span class="type">gboolean</span> add_tearoffs</code></em>);
103
<span class="returnvalue">gboolean</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-add-tearoffs" title="gtk_combo_box_get_add_tearoffs ()">gtk_combo_box_get_add_tearoffs</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
104
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-title" title="gtk_combo_box_set_title ()">gtk_combo_box_set_title</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
105
<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>);
106
const <span class="returnvalue">gchar</span> * <a class="link" href="GtkComboBox.html#gtk-combo-box-get-title" title="gtk_combo_box_get_title ()">gtk_combo_box_get_title</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
107
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-focus-on-click" title="gtk_combo_box_set_focus_on_click ()">gtk_combo_box_set_focus_on_click</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo</code></em>,
108
<em class="parameter"><code><span class="type">gboolean</span> focus_on_click</code></em>);
109
<span class="returnvalue">gboolean</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-focus-on-click" title="gtk_combo_box_get_focus_on_click ()">gtk_combo_box_get_focus_on_click</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo</code></em>);
110
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-button-sensitivity" title="gtk_combo_box_set_button_sensitivity ()">gtk_combo_box_set_button_sensitivity</a>
111
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
112
<em class="parameter"><code><a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="type">GtkSensitivityType</span></a> sensitivity</code></em>);
113
<a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="returnvalue">GtkSensitivityType</span></a> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-button-sensitivity" title="gtk_combo_box_get_button_sensitivity ()">gtk_combo_box_get_button_sensitivity</a>
114
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
115
<span class="returnvalue">gboolean</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-has-entry" title="gtk_combo_box_get_has_entry ()">gtk_combo_box_get_has_entry</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
116
<span class="returnvalue">void</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-set-entry-text-column" title="gtk_combo_box_set_entry_text_column ()">gtk_combo_box_set_entry_text_column</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
117
<em class="parameter"><code><span class="type">gint</span> text_column</code></em>);
118
<span class="returnvalue">gint</span> <a class="link" href="GtkComboBox.html#gtk-combo-box-get-entry-text-column" title="gtk_combo_box_get_entry_text_column ()">gtk_combo_box_get_entry_text_column</a> (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);
121
<div class="refsect1">
122
<a name="GtkComboBox.object-hierarchy"></a><h2>Object Hierarchy</h2>
123
<pre class="synopsis">
125
+----GInitiallyUnowned
126
+----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
127
+----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
128
+----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
129
+----<a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
131
+----<a class="link" href="GtkComboBoxEntry.html" title="GtkComboBoxEntry">GtkComboBoxEntry</a>
132
+----<a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText">GtkComboBoxText</a>
135
<div class="refsect1">
136
<a name="GtkComboBox.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
138
GtkComboBox implements
139
AtkImplementorIface, <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>, <a class="link" href="GtkCellLayout.html" title="GtkCellLayout">GtkCellLayout</a> and <a class="link" href="GtkCellEditable.html" title="GtkCellEditable">GtkCellEditable</a>.</p>
141
<div class="refsect1">
142
<a name="GtkComboBox.properties"></a><h2>Properties</h2>
143
<pre class="synopsis">
144
"<a class="link" href="GtkComboBox.html#GtkComboBox--active" title='The "active" property'>active</a>" <span class="type">gint</span> : Read / Write
145
"<a class="link" href="GtkComboBox.html#GtkComboBox--add-tearoffs" title='The "add-tearoffs" property'>add-tearoffs</a>" <span class="type">gboolean</span> : Read / Write
146
"<a class="link" href="GtkComboBox.html#GtkComboBox--button-sensitivity" title='The "button-sensitivity" property'>button-sensitivity</a>" <a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="type">GtkSensitivityType</span></a> : Read / Write
147
"<a class="link" href="GtkComboBox.html#GtkComboBox--column-span-column" title='The "column-span-column" property'>column-span-column</a>" <span class="type">gint</span> : Read / Write
148
"<a class="link" href="GtkComboBox.html#GtkComboBox--entry-text-column" title='The "entry-text-column" property'>entry-text-column</a>" <span class="type">gint</span> : Read / Write
149
"<a class="link" href="GtkComboBox.html#GtkComboBox--focus-on-click" title='The "focus-on-click" property'>focus-on-click</a>" <span class="type">gboolean</span> : Read / Write
150
"<a class="link" href="GtkComboBox.html#GtkComboBox--has-entry" title='The "has-entry" property'>has-entry</a>" <span class="type">gboolean</span> : Read / Write / Construct Only
151
"<a class="link" href="GtkComboBox.html#GtkComboBox--has-frame" title='The "has-frame" property'>has-frame</a>" <span class="type">gboolean</span> : Read / Write
152
"<a class="link" href="GtkComboBox.html#GtkComboBox--model" title='The "model" property'>model</a>" <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>* : Read / Write
153
"<a class="link" href="GtkComboBox.html#GtkComboBox--popup-shown" title='The "popup-shown" property'>popup-shown</a>" <span class="type">gboolean</span> : Read
154
"<a class="link" href="GtkComboBox.html#GtkComboBox--row-span-column" title='The "row-span-column" property'>row-span-column</a>" <span class="type">gint</span> : Read / Write
155
"<a class="link" href="GtkComboBox.html#GtkComboBox--tearoff-title" title='The "tearoff-title" property'>tearoff-title</a>" <span class="type">gchar</span>* : Read / Write
156
"<a class="link" href="GtkComboBox.html#GtkComboBox--wrap-width" title='The "wrap-width" property'>wrap-width</a>" <span class="type">gint</span> : Read / Write
159
<div class="refsect1">
160
<a name="GtkComboBox.style-properties"></a><h2>Style Properties</h2>
161
<pre class="synopsis">
162
"<a class="link" href="GtkComboBox.html#GtkComboBox--s-appears-as-list" title='The "appears-as-list" style property'>appears-as-list</a>" <span class="type">gboolean</span> : Read
163
"<a class="link" href="GtkComboBox.html#GtkComboBox--s-arrow-size" title='The "arrow-size" style property'>arrow-size</a>" <span class="type">gint</span> : Read
164
"<a class="link" href="GtkComboBox.html#GtkComboBox--s-shadow-type" title='The "shadow-type" style property'>shadow-type</a>" <a class="link" href="gtk2-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a> : Read
167
<div class="refsect1">
168
<a name="GtkComboBox.signals"></a><h2>Signals</h2>
169
<pre class="synopsis">
170
"<a class="link" href="GtkComboBox.html#GtkComboBox-changed" title='The "changed" signal'>changed</a>" : <code class="literal">Run Last</code>
171
"<a class="link" href="GtkComboBox.html#GtkComboBox-move-active" title='The "move-active" signal'>move-active</a>" : <code class="literal">Action</code>
172
"<a class="link" href="GtkComboBox.html#GtkComboBox-popdown" title='The "popdown" signal'>popdown</a>" : <code class="literal">Action</code>
173
"<a class="link" href="GtkComboBox.html#GtkComboBox-popup" title='The "popup" signal'>popup</a>" : <code class="literal">Action</code>
176
<div class="refsect1">
177
<a name="GtkComboBox.description"></a><h2>Description</h2>
179
A GtkComboBox is a widget that allows the user to choose from a list of
180
valid choices. The GtkComboBox displays the selected choice. When
181
activated, the GtkComboBox displays a popup which allows the user to
182
make a new choice. The style in which the selected value is displayed,
183
and the style of the popup is determined by the current theme. It may
184
be similar to a Windows-style combo box.
187
The GtkComboBox uses the model-view pattern; the list of valid choices
188
is specified in the form of a tree model, and the display of the choices
189
can be adapted to the data in the model by using cell renderers, as you
190
would in a tree view. This is possible since GtkComboBox implements the
191
<a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> interface. The tree model holding the valid choices is
192
not restricted to a flat list, it can be a real tree, and the popup will
193
reflect the tree structure.
196
To allow the user to enter values not in the model, the 'has-entry'
197
property allows the GtkComboBox to contain a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. This entry
198
can be accessed by calling <a class="link" href="GtkBin.html#gtk-bin-get-child" title="gtk_bin_get_child ()"><code class="function">gtk_bin_get_child()</code></a> on the combo box.
201
For a simple list of textual choices, the model-view API of GtkComboBox
202
can be a bit overwhelming. In this case, <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> offers a
203
simple alternative. Both GtkComboBox and <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> can contain
207
A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> is a widget that allows the user to choose from a
208
list of valid choices. The <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> displays the selected
209
choice. When activated, the <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> displays a popup
210
which allows the user to make a new choice. The style in which
211
the selected value is displayed, and the style of the popup is
212
determined by the current theme. It may be similar to a <a class="link" href="GtkOptionMenu.html" title="GtkOptionMenu"><span class="type">GtkOptionMenu</span></a>,
213
or similar to a Windows-style combo box.
216
Unlike its predecessors <a class="link" href="GtkCombo.html" title="GtkCombo"><span class="type">GtkCombo</span></a> and <a class="link" href="GtkOptionMenu.html" title="GtkOptionMenu"><span class="type">GtkOptionMenu</span></a>, the <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
217
uses the model-view pattern; the list of valid choices is specified in the
218
form of a tree model, and the display of the choices can be adapted to
219
the data in the model by using cell renderers, as you would in a tree view.
220
This is possible since <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> implements the <a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> interface.
221
The tree model holding the valid choices is not restricted to a flat list,
222
it can be a real tree, and the popup will reflect the tree structure.
225
In addition to the model-view API, <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> offers a simple API which
226
is suitable for text-only combo boxes, and hides the complexity of managing
227
the data in a model. It consists of the functions <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>,
228
<a class="link" href="GtkComboBox.html#gtk-combo-box-append-text" title="gtk_combo_box_append_text ()"><code class="function">gtk_combo_box_append_text()</code></a>, <a class="link" href="GtkComboBox.html#gtk-combo-box-insert-text" title="gtk_combo_box_insert_text ()"><code class="function">gtk_combo_box_insert_text()</code></a>,
229
<a class="link" href="GtkComboBox.html#gtk-combo-box-prepend-text" title="gtk_combo_box_prepend_text ()"><code class="function">gtk_combo_box_prepend_text()</code></a>, <a class="link" href="GtkComboBox.html#gtk-combo-box-remove-text" title="gtk_combo_box_remove_text ()"><code class="function">gtk_combo_box_remove_text()</code></a> and
230
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-active-text" title="gtk_combo_box_get_active_text ()"><code class="function">gtk_combo_box_get_active_text()</code></a>.
233
<div class="refsect1">
234
<a name="GtkComboBox.details"></a><h2>Details</h2>
235
<div class="refsect2">
236
<a name="GtkComboBox-struct"></a><h3>struct GtkComboBox</h3>
237
<pre class="programlisting">struct GtkComboBox;</pre>
242
<div class="refsect2">
243
<a name="gtk-combo-box-new"></a><h3>gtk_combo_box_new ()</h3>
244
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_combo_box_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
246
Creates a new empty <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.
248
<div class="variablelist"><table border="0" class="variablelist">
250
<col align="left" valign="top">
254
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
255
<td>A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</td>
258
<p class="since">Since 2.4</p>
261
<div class="refsect2">
262
<a name="gtk-combo-box-new-with-entry"></a><h3>gtk_combo_box_new_with_entry ()</h3>
263
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_combo_box_new_with_entry (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
265
Creates a new empty <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> with an entry.
267
<div class="variablelist"><table border="0" class="variablelist">
269
<col align="left" valign="top">
273
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
274
<td>A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</td>
279
<div class="refsect2">
280
<a name="gtk-combo-box-new-with-model"></a><h3>gtk_combo_box_new_with_model ()</h3>
281
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_combo_box_new_with_model (<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);</pre>
283
Creates a new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> with the model initialized to <em class="parameter"><code>model</code></em>.
285
<div class="variablelist"><table border="0" class="variablelist">
287
<col align="left" valign="top">
292
<td><p><span class="term"><em class="parameter"><code>model</code></em> :</span></p></td>
293
<td>A <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>.</td>
296
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
297
<td>A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</td>
301
<p class="since">Since 2.4</p>
304
<div class="refsect2">
305
<a name="gtk-combo-box-new-with-model-and-entry"></a><h3>gtk_combo_box_new_with_model_and_entry ()</h3>
306
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_combo_box_new_with_model_and_entry
307
(<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);</pre>
309
Creates a new empty <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> with an entry
310
and with the model initialized to <em class="parameter"><code>model</code></em>.
312
<div class="variablelist"><table border="0" class="variablelist">
314
<col align="left" valign="top">
318
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
319
<td>A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
325
<div class="refsect2">
326
<a name="gtk-combo-box-get-wrap-width"></a><h3>gtk_combo_box_get_wrap_width ()</h3>
327
<pre class="programlisting"><span class="returnvalue">gint</span> gtk_combo_box_get_wrap_width (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
329
Returns the wrap width which is used to determine the number of columns
330
for the popup menu. If the wrap width is larger than 1, the combo box
333
<div class="variablelist"><table border="0" class="variablelist">
335
<col align="left" valign="top">
340
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
341
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
345
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
346
<td>the wrap width.</td>
350
<p class="since">Since 2.6</p>
353
<div class="refsect2">
354
<a name="gtk-combo-box-set-wrap-width"></a><h3>gtk_combo_box_set_wrap_width ()</h3>
355
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_wrap_width (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
356
<em class="parameter"><code><span class="type">gint</span> width</code></em>);</pre>
358
Sets the wrap width of <em class="parameter"><code>combo_box</code></em> to be <em class="parameter"><code>width</code></em>. The wrap width is basically
359
the preferred number of columns when you want the popup to be layed out
362
<div class="variablelist"><table border="0" class="variablelist">
364
<col align="left" valign="top">
369
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
370
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
374
<td><p><span class="term"><em class="parameter"><code>width</code></em> :</span></p></td>
375
<td>Preferred number of columns</td>
379
<p class="since">Since 2.4</p>
382
<div class="refsect2">
383
<a name="gtk-combo-box-get-row-span-column"></a><h3>gtk_combo_box_get_row_span_column ()</h3>
384
<pre class="programlisting"><span class="returnvalue">gint</span> gtk_combo_box_get_row_span_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
386
Returns the column with row span information for <em class="parameter"><code>combo_box</code></em>.
388
<div class="variablelist"><table border="0" class="variablelist">
390
<col align="left" valign="top">
395
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
396
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
400
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
401
<td>the row span column.</td>
405
<p class="since">Since 2.6</p>
408
<div class="refsect2">
409
<a name="gtk-combo-box-set-row-span-column"></a><h3>gtk_combo_box_set_row_span_column ()</h3>
410
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_row_span_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
411
<em class="parameter"><code><span class="type">gint</span> row_span</code></em>);</pre>
413
Sets the column with row span information for <em class="parameter"><code>combo_box</code></em> to be <em class="parameter"><code>row_span</code></em>.
414
The row span column contains integers which indicate how many rows
417
<div class="variablelist"><table border="0" class="variablelist">
419
<col align="left" valign="top">
424
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
425
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</td>
428
<td><p><span class="term"><em class="parameter"><code>row_span</code></em> :</span></p></td>
429
<td>A column in the model passed during construction.</td>
433
<p class="since">Since 2.4</p>
436
<div class="refsect2">
437
<a name="gtk-combo-box-get-column-span-column"></a><h3>gtk_combo_box_get_column_span_column ()</h3>
438
<pre class="programlisting"><span class="returnvalue">gint</span> gtk_combo_box_get_column_span_column
439
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
441
Returns the column with column span information for <em class="parameter"><code>combo_box</code></em>.
443
<div class="variablelist"><table border="0" class="variablelist">
445
<col align="left" valign="top">
450
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
451
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
455
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
456
<td>the column span column.</td>
460
<p class="since">Since 2.6</p>
463
<div class="refsect2">
464
<a name="gtk-combo-box-set-column-span-column"></a><h3>gtk_combo_box_set_column_span_column ()</h3>
465
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_column_span_column
466
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
467
<em class="parameter"><code><span class="type">gint</span> column_span</code></em>);</pre>
469
Sets the column with column span information for <em class="parameter"><code>combo_box</code></em> to be
470
<em class="parameter"><code>column_span</code></em>. The column span column contains integers which indicate
471
how many columns an item should span.
473
<div class="variablelist"><table border="0" class="variablelist">
475
<col align="left" valign="top">
480
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
481
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
485
<td><p><span class="term"><em class="parameter"><code>column_span</code></em> :</span></p></td>
486
<td>A column in the model passed during construction</td>
490
<p class="since">Since 2.4</p>
493
<div class="refsect2">
494
<a name="gtk-combo-box-get-active"></a><h3>gtk_combo_box_get_active ()</h3>
495
<pre class="programlisting"><span class="returnvalue">gint</span> gtk_combo_box_get_active (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
497
Returns the index of the currently active item, or -1 if there's no
498
active item. If the model is a non-flat treemodel, and the active item
499
is not an immediate child of the root of the tree, this function returns
500
<code class="literal">gtk_tree_path_get_indices (path)[0]</code>, where
501
<code class="literal">path</code> is the <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> of the active item.
503
<div class="variablelist"><table border="0" class="variablelist">
505
<col align="left" valign="top">
510
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
511
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
515
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
516
<td>An integer which is the index of the currently active item,
517
or -1 if there's no active item.</td>
521
<p class="since">Since 2.4</p>
524
<div class="refsect2">
525
<a name="gtk-combo-box-set-active"></a><h3>gtk_combo_box_set_active ()</h3>
526
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_active (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
527
<em class="parameter"><code><span class="type">gint</span> index_</code></em>);</pre>
529
Sets the active item of <em class="parameter"><code>combo_box</code></em> to be the item at <em class="parameter"><code>index</code></em>.
531
<div class="variablelist"><table border="0" class="variablelist">
533
<col align="left" valign="top">
538
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
539
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
543
<td><p><span class="term"><em class="parameter"><code>index_</code></em> :</span></p></td>
544
<td>An index in the model passed during construction, or -1 to have
549
<p class="since">Since 2.4</p>
552
<div class="refsect2">
553
<a name="gtk-combo-box-get-active-iter"></a><h3>gtk_combo_box_get_active_iter ()</h3>
554
<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_combo_box_get_active_iter (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
555
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
557
Sets <em class="parameter"><code>iter</code></em> to point to the current active item, if it exists.
559
<div class="variablelist"><table border="0" class="variablelist">
561
<col align="left" valign="top">
566
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
567
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
571
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
572
<td>The uninitialized <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
576
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
578
<code class="literal">TRUE</code>, if <em class="parameter"><code>iter</code></em> was set</td>
582
<p class="since">Since 2.4</p>
585
<div class="refsect2">
586
<a name="gtk-combo-box-set-active-iter"></a><h3>gtk_combo_box_set_active_iter ()</h3>
587
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_active_iter (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
588
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
590
Sets the current active item to be the one referenced by <em class="parameter"><code>iter</code></em>, or
591
unsets the active item if <em class="parameter"><code>iter</code></em> is <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.
593
<div class="variablelist"><table border="0" class="variablelist">
595
<col align="left" valign="top">
600
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
601
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
605
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
606
<td>The <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
611
<p class="since">Since 2.4</p>
614
<div class="refsect2">
615
<a name="gtk-combo-box-get-model"></a><h3>gtk_combo_box_get_model ()</h3>
616
<pre class="programlisting"><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="returnvalue">GtkTreeModel</span></a> * gtk_combo_box_get_model (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
618
Returns the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> which is acting as data source for <em class="parameter"><code>combo_box</code></em>.
620
<div class="variablelist"><table border="0" class="variablelist">
622
<col align="left" valign="top">
627
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
628
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
632
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
633
<td>A <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> which was passed
634
during construction. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
639
<p class="since">Since 2.4</p>
642
<div class="refsect2">
643
<a name="gtk-combo-box-set-model"></a><h3>gtk_combo_box_set_model ()</h3>
644
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_model (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
645
<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);</pre>
647
Sets the model used by <em class="parameter"><code>combo_box</code></em> to be <em class="parameter"><code>model</code></em>. Will unset a previously set
648
model (if applicable). If model is <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, then it will unset the model.
651
Note that this function does not clear the cell renderers, you have to
652
call <a class="link" href="GtkCellLayout.html#gtk-cell-layout-clear" title="gtk_cell_layout_clear ()"><code class="function">gtk_cell_layout_clear()</code></a> yourself if you need to set up different
653
cell renderers for the new model.
655
<div class="variablelist"><table border="0" class="variablelist">
657
<col align="left" valign="top">
662
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
663
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
667
<td><p><span class="term"><em class="parameter"><code>model</code></em> :</span></p></td>
668
<td>A <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
673
<p class="since">Since 2.4</p>
676
<div class="refsect2">
677
<a name="gtk-combo-box-new-text"></a><h3>gtk_combo_box_new_text ()</h3>
678
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_combo_box_new_text (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
679
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
680
<h3 class="title">Warning</h3>
681
<p><code class="literal">gtk_combo_box_new_text</code> has been deprecated since version 2.24 and should not be used in newly-written code. Use <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a></p>
684
Convenience function which constructs a new text combo box, which is a
685
<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> just displaying strings. If you use this function to create
686
a text combo box, you should only manipulate its data source with the
687
following convenience functions: <a class="link" href="GtkComboBox.html#gtk-combo-box-append-text" title="gtk_combo_box_append_text ()"><code class="function">gtk_combo_box_append_text()</code></a>,
688
<a class="link" href="GtkComboBox.html#gtk-combo-box-insert-text" title="gtk_combo_box_insert_text ()"><code class="function">gtk_combo_box_insert_text()</code></a>, <a class="link" href="GtkComboBox.html#gtk-combo-box-prepend-text" title="gtk_combo_box_prepend_text ()"><code class="function">gtk_combo_box_prepend_text()</code></a> and
689
<a class="link" href="GtkComboBox.html#gtk-combo-box-remove-text" title="gtk_combo_box_remove_text ()"><code class="function">gtk_combo_box_remove_text()</code></a>.
691
<div class="variablelist"><table border="0" class="variablelist">
693
<col align="left" valign="top">
697
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
698
<td>A new text combo box. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
702
<p class="since">Since 2.4</p>
705
<div class="refsect2">
706
<a name="gtk-combo-box-append-text"></a><h3>gtk_combo_box_append_text ()</h3>
707
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_append_text (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
708
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
709
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
710
<h3 class="title">Warning</h3>
711
<p><code class="literal">gtk_combo_box_append_text</code> has been deprecated since version 2.24 and should not be used in newly-written code. Use <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a></p>
714
Appends <em class="parameter"><code>string</code></em> to the list of strings stored in <em class="parameter"><code>combo_box</code></em>. Note that
715
you can only use this function with combo boxes constructed with
716
<a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>.
718
<div class="variablelist"><table border="0" class="variablelist">
720
<col align="left" valign="top">
725
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
726
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> constructed using <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>
730
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
735
<p class="since">Since 2.4</p>
738
<div class="refsect2">
739
<a name="gtk-combo-box-insert-text"></a><h3>gtk_combo_box_insert_text ()</h3>
740
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_insert_text (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
741
<em class="parameter"><code><span class="type">gint</span> position</code></em>,
742
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
743
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
744
<h3 class="title">Warning</h3>
745
<p><code class="literal">gtk_combo_box_insert_text</code> has been deprecated since version 2.24 and should not be used in newly-written code. Use <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a></p>
748
Inserts <em class="parameter"><code>string</code></em> at <em class="parameter"><code>position</code></em> in the list of strings stored in <em class="parameter"><code>combo_box</code></em>.
749
Note that you can only use this function with combo boxes constructed
750
with <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>.
752
<div class="variablelist"><table border="0" class="variablelist">
754
<col align="left" valign="top">
759
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
760
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> constructed using <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>
764
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
765
<td>An index to insert <em class="parameter"><code>text</code></em>
769
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
774
<p class="since">Since 2.4</p>
777
<div class="refsect2">
778
<a name="gtk-combo-box-prepend-text"></a><h3>gtk_combo_box_prepend_text ()</h3>
779
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_prepend_text (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
780
<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>);</pre>
781
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
782
<h3 class="title">Warning</h3>
783
<p><code class="literal">gtk_combo_box_prepend_text</code> has been deprecated since version 2.24 and should not be used in newly-written code. Use <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a></p>
786
Prepends <em class="parameter"><code>string</code></em> to the list of strings stored in <em class="parameter"><code>combo_box</code></em>. Note that
787
you can only use this function with combo boxes constructed with
788
<a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>.
790
<div class="variablelist"><table border="0" class="variablelist">
792
<col align="left" valign="top">
797
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
798
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> constructed with <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>
802
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
807
<p class="since">Since 2.4</p>
810
<div class="refsect2">
811
<a name="gtk-combo-box-remove-text"></a><h3>gtk_combo_box_remove_text ()</h3>
812
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_remove_text (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
813
<em class="parameter"><code><span class="type">gint</span> position</code></em>);</pre>
814
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
815
<h3 class="title">Warning</h3>
816
<p><code class="literal">gtk_combo_box_remove_text</code> has been deprecated since version 2.24 and should not be used in newly-written code. Use <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a></p>
819
Removes the string at <em class="parameter"><code>position</code></em> from <em class="parameter"><code>combo_box</code></em>. Note that you can only use
820
this function with combo boxes constructed with <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>.
822
<div class="variablelist"><table border="0" class="variablelist">
824
<col align="left" valign="top">
829
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
830
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> constructed with <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>
834
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
835
<td>Index of the item to remove</td>
839
<p class="since">Since 2.4</p>
842
<div class="refsect2">
843
<a name="gtk-combo-box-get-active-text"></a><h3>gtk_combo_box_get_active_text ()</h3>
844
<pre class="programlisting"><span class="returnvalue">gchar</span> * gtk_combo_box_get_active_text (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
845
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
846
<h3 class="title">Warning</h3>
847
<p><code class="literal">gtk_combo_box_get_active_text</code> has been deprecated since version 2.24 and should not be used in newly-written code. If you used this with a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> constructed with
848
<a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a> then you should now use <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> and
849
<a class="link" href="GtkComboBoxText.html#gtk-combo-box-text-get-active-text" title="gtk_combo_box_text_get_active_text ()"><code class="function">gtk_combo_box_text_get_active_text()</code></a> instead. Or if you used this with a
850
<a class="link" href="GtkComboBoxEntry.html" title="GtkComboBoxEntry"><span class="type">GtkComboBoxEntry</span></a> then you should now use <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> with
851
<a class="link" href="GtkComboBox.html#GtkComboBox--has-entry" title='The "has-entry" property'><span class="type">"has-entry"</span></a> as <code class="literal">TRUE</code> and use
852
gtk_entry_get_text (GTK_ENTRY (gtk_bin_get_child (GTK_BIN (combobox))).</p>
855
Returns the currently active string in <em class="parameter"><code>combo_box</code></em> or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if none
856
is selected. Note that you can only use this function with combo
857
boxes constructed with <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a> and with
858
<a class="link" href="GtkComboBoxEntry.html" title="GtkComboBoxEntry"><span class="type">GtkComboBoxEntry</span></a>s.
860
<div class="variablelist"><table border="0" class="variablelist">
862
<col align="left" valign="top">
867
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
868
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> constructed with <a class="link" href="GtkComboBox.html#gtk-combo-box-new-text" title="gtk_combo_box_new_text ()"><code class="function">gtk_combo_box_new_text()</code></a>
872
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
873
<td>a newly allocated string containing the currently active text.
874
Must be freed with <code class="function">g_free()</code>.</td>
878
<p class="since">Since 2.6</p>
881
<div class="refsect2">
882
<a name="gtk-combo-box-popup"></a><h3>gtk_combo_box_popup ()</h3>
883
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_popup (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
885
Pops up the menu or dropdown list of <em class="parameter"><code>combo_box</code></em>.
888
This function is mostly intended for use by accessibility technologies;
889
applications should have little use for it.
891
<div class="variablelist"><table border="0" class="variablelist">
893
<col align="left" valign="top">
897
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
898
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
902
<p class="since">Since 2.4</p>
905
<div class="refsect2">
906
<a name="gtk-combo-box-popdown"></a><h3>gtk_combo_box_popdown ()</h3>
907
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_popdown (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
909
Hides the menu or dropdown list of <em class="parameter"><code>combo_box</code></em>.
912
This function is mostly intended for use by accessibility technologies;
913
applications should have little use for it.
915
<div class="variablelist"><table border="0" class="variablelist">
917
<col align="left" valign="top">
921
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
922
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
926
<p class="since">Since 2.4</p>
929
<div class="refsect2">
930
<a name="gtk-combo-box-get-popup-accessible"></a><h3>gtk_combo_box_get_popup_accessible ()</h3>
931
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/atk/AtkObject.html"><span class="returnvalue">AtkObject</span></a> * gtk_combo_box_get_popup_accessible (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
933
Gets the accessible object corresponding to the combo box's popup.
936
This function is mostly intended for use by accessibility technologies;
937
applications should have little use for it.
939
<div class="variablelist"><table border="0" class="variablelist">
941
<col align="left" valign="top">
946
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
947
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
951
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
952
<td>the accessible object corresponding
953
to the combo box's popup. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
958
<p class="since">Since 2.6</p>
961
<div class="refsect2">
962
<a name="gtk-combo-box-get-row-separator-func"></a><h3>gtk_combo_box_get_row_separator_func ()</h3>
963
<pre class="programlisting"><a class="link" href="GtkTreeView.html#GtkTreeViewRowSeparatorFunc" title="GtkTreeViewRowSeparatorFunc ()"><span class="returnvalue">GtkTreeViewRowSeparatorFunc</span></a> gtk_combo_box_get_row_separator_func
964
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
966
Returns the current row separator function.
968
<div class="variablelist"><table border="0" class="variablelist">
970
<col align="left" valign="top">
975
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
976
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
980
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
981
<td>the current row separator function.</td>
985
<p class="since">Since 2.6</p>
988
<div class="refsect2">
989
<a name="gtk-combo-box-set-row-separator-func"></a><h3>gtk_combo_box_set_row_separator_func ()</h3>
990
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_row_separator_func
991
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
992
<em class="parameter"><code><a class="link" href="GtkTreeView.html#GtkTreeViewRowSeparatorFunc" title="GtkTreeViewRowSeparatorFunc ()"><span class="type">GtkTreeViewRowSeparatorFunc</span></a> func</code></em>,
993
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
994
<em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
996
Sets the row separator function, which is used to determine
997
whether a row should be drawn as a separator. If the row separator
998
function is <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, no separators are drawn. This is the default value.
1000
<div class="variablelist"><table border="0" class="variablelist">
1002
<col align="left" valign="top">
1007
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1008
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1012
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
1013
<td>a <a class="link" href="GtkTreeView.html#GtkTreeViewRowSeparatorFunc" title="GtkTreeViewRowSeparatorFunc ()"><span class="type">GtkTreeViewRowSeparatorFunc</span></a>
1017
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1018
<td>user data to pass to <em class="parameter"><code>func</code></em>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1022
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1023
<td>destroy notifier for <em class="parameter"><code>data</code></em>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1028
<p class="since">Since 2.6</p>
1031
<div class="refsect2">
1032
<a name="gtk-combo-box-set-add-tearoffs"></a><h3>gtk_combo_box_set_add_tearoffs ()</h3>
1033
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_add_tearoffs (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
1034
<em class="parameter"><code><span class="type">gboolean</span> add_tearoffs</code></em>);</pre>
1036
Sets whether the popup menu should have a tearoff
1039
<div class="variablelist"><table border="0" class="variablelist">
1041
<col align="left" valign="top">
1046
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1047
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1051
<td><p><span class="term"><em class="parameter"><code>add_tearoffs</code></em> :</span></p></td>
1053
<code class="literal">TRUE</code> to add tearoff menu items</td>
1057
<p class="since">Since 2.6</p>
1060
<div class="refsect2">
1061
<a name="gtk-combo-box-get-add-tearoffs"></a><h3>gtk_combo_box_get_add_tearoffs ()</h3>
1062
<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_combo_box_get_add_tearoffs (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
1064
Gets the current value of the :add-tearoffs property.
1066
<div class="variablelist"><table border="0" class="variablelist">
1068
<col align="left" valign="top">
1073
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1074
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1078
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1079
<td>the current value of the :add-tearoffs property.</td>
1085
<div class="refsect2">
1086
<a name="gtk-combo-box-set-title"></a><h3>gtk_combo_box_set_title ()</h3>
1087
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_title (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
1088
<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>);</pre>
1090
Sets the menu's title in tearoff mode.
1092
<div class="variablelist"><table border="0" class="variablelist">
1094
<col align="left" valign="top">
1099
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1100
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1104
<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
1105
<td>a title for the menu in tearoff mode</td>
1109
<p class="since">Since 2.10</p>
1112
<div class="refsect2">
1113
<a name="gtk-combo-box-get-title"></a><h3>gtk_combo_box_get_title ()</h3>
1114
<pre class="programlisting">const <span class="returnvalue">gchar</span> * gtk_combo_box_get_title (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
1116
Gets the current title of the menu in tearoff mode. See
1117
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-add-tearoffs" title="gtk_combo_box_set_add_tearoffs ()"><code class="function">gtk_combo_box_set_add_tearoffs()</code></a>.
1119
<div class="variablelist"><table border="0" class="variablelist">
1121
<col align="left" valign="top">
1126
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1127
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1131
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1132
<td>the menu's title in tearoff mode. This is an internal copy of the
1133
string which must not be freed.</td>
1137
<p class="since">Since 2.10</p>
1140
<div class="refsect2">
1141
<a name="gtk-combo-box-set-focus-on-click"></a><h3>gtk_combo_box_set_focus_on_click ()</h3>
1142
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_focus_on_click (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo</code></em>,
1143
<em class="parameter"><code><span class="type">gboolean</span> focus_on_click</code></em>);</pre>
1145
Sets whether the combo box will grab focus when it is clicked with
1146
the mouse. Making mouse clicks not grab focus is useful in places
1147
like toolbars where you don't want the keyboard focus removed from
1148
the main area of the application.
1150
<div class="variablelist"><table border="0" class="variablelist">
1152
<col align="left" valign="top">
1157
<td><p><span class="term"><em class="parameter"><code>combo</code></em> :</span></p></td>
1158
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1162
<td><p><span class="term"><em class="parameter"><code>focus_on_click</code></em> :</span></p></td>
1163
<td>whether the combo box grabs focus when clicked
1168
<p class="since">Since 2.6</p>
1171
<div class="refsect2">
1172
<a name="gtk-combo-box-get-focus-on-click"></a><h3>gtk_combo_box_get_focus_on_click ()</h3>
1173
<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_combo_box_get_focus_on_click (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo</code></em>);</pre>
1175
Returns whether the combo box grabs focus when it is clicked
1176
with the mouse. See <a class="link" href="GtkComboBox.html#gtk-combo-box-set-focus-on-click" title="gtk_combo_box_set_focus_on_click ()"><code class="function">gtk_combo_box_set_focus_on_click()</code></a>.
1178
<div class="variablelist"><table border="0" class="variablelist">
1180
<col align="left" valign="top">
1185
<td><p><span class="term"><em class="parameter"><code>combo</code></em> :</span></p></td>
1186
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1190
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1192
<code class="literal">TRUE</code> if the combo box grabs focus when it is
1193
clicked with the mouse.</td>
1197
<p class="since">Since 2.6</p>
1200
<div class="refsect2">
1201
<a name="gtk-combo-box-set-button-sensitivity"></a><h3>gtk_combo_box_set_button_sensitivity ()</h3>
1202
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_button_sensitivity
1203
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
1204
<em class="parameter"><code><a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="type">GtkSensitivityType</span></a> sensitivity</code></em>);</pre>
1206
Sets whether the dropdown button of the combo box should be
1207
always sensitive (<a class="link" href="GtkRange.html#GTK-SENSITIVITY-ON:CAPS"><code class="literal">GTK_SENSITIVITY_ON</code></a>), never sensitive (<a class="link" href="GtkRange.html#GTK-SENSITIVITY-OFF:CAPS"><code class="literal">GTK_SENSITIVITY_OFF</code></a>)
1208
or only if there is at least one item to display (<a class="link" href="GtkRange.html#GTK-SENSITIVITY-AUTO:CAPS"><code class="literal">GTK_SENSITIVITY_AUTO</code></a>).
1210
<div class="variablelist"><table border="0" class="variablelist">
1212
<col align="left" valign="top">
1217
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1218
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1222
<td><p><span class="term"><em class="parameter"><code>sensitivity</code></em> :</span></p></td>
1223
<td>specify the sensitivity of the dropdown button</td>
1227
<p class="since">Since 2.14</p>
1230
<div class="refsect2">
1231
<a name="gtk-combo-box-get-button-sensitivity"></a><h3>gtk_combo_box_get_button_sensitivity ()</h3>
1232
<pre class="programlisting"><a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="returnvalue">GtkSensitivityType</span></a> gtk_combo_box_get_button_sensitivity
1233
(<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
1235
Returns whether the combo box sets the dropdown button
1236
sensitive or not when there are no items in the model.
1238
<div class="variablelist"><table border="0" class="variablelist">
1240
<col align="left" valign="top">
1245
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1246
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1250
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1252
<a class="link" href="GtkRange.html#GTK-SENSITIVITY-ON:CAPS"><code class="literal">GTK_SENSITIVITY_ON</code></a> if the dropdown button
1253
is sensitive when the model is empty, <a class="link" href="GtkRange.html#GTK-SENSITIVITY-OFF:CAPS"><code class="literal">GTK_SENSITIVITY_OFF</code></a>
1254
if the button is always insensitive or
1255
<a class="link" href="GtkRange.html#GTK-SENSITIVITY-AUTO:CAPS"><code class="literal">GTK_SENSITIVITY_AUTO</code></a> if it is only sensitive as long as
1256
the model has one item to be selected.</td>
1260
<p class="since">Since 2.14</p>
1263
<div class="refsect2">
1264
<a name="gtk-combo-box-get-has-entry"></a><h3>gtk_combo_box_get_has_entry ()</h3>
1265
<pre class="programlisting"><span class="returnvalue">gboolean</span> gtk_combo_box_get_has_entry (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
1267
Returns whether the combo box has an entry.
1269
<div class="variablelist"><table border="0" class="variablelist">
1271
<col align="left" valign="top">
1276
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1277
<td>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1281
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1282
<td>whether there is an entry in <em class="parameter"><code>combo_box</code></em>.</td>
1286
<p class="since">Since 2.24</p>
1289
<div class="refsect2">
1290
<a name="gtk-combo-box-set-entry-text-column"></a><h3>gtk_combo_box_set_entry_text_column ()</h3>
1291
<pre class="programlisting"><span class="returnvalue">void</span> gtk_combo_box_set_entry_text_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
1292
<em class="parameter"><code><span class="type">gint</span> text_column</code></em>);</pre>
1294
Sets the model column which <em class="parameter"><code>combo_box</code></em> should use to get strings from
1295
to be <em class="parameter"><code>text_column</code></em>. The column <em class="parameter"><code>text_column</code></em> in the model of <em class="parameter"><code>combo_box</code></em>
1296
must be of type <code class="literal">G_TYPE_STRING</code>.
1299
This is only relevant if <em class="parameter"><code>combo_box</code></em> has been created with
1300
<a class="link" href="GtkComboBox.html#GtkComboBox--has-entry" title='The "has-entry" property'><span class="type">"has-entry"</span></a> as <code class="literal">TRUE</code>.
1302
<div class="variablelist"><table border="0" class="variablelist">
1304
<col align="left" valign="top">
1309
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1310
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>
1314
<td><p><span class="term"><em class="parameter"><code>text_column</code></em> :</span></p></td>
1315
<td>A column in <em class="parameter"><code>model</code></em> to get the strings from for
1316
the internal entry</td>
1320
<p class="since">Since 2.24</p>
1323
<div class="refsect2">
1324
<a name="gtk-combo-box-get-entry-text-column"></a><h3>gtk_combo_box_get_entry_text_column ()</h3>
1325
<pre class="programlisting"><span class="returnvalue">gint</span> gtk_combo_box_get_entry_text_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
1327
Returns the column which <em class="parameter"><code>combo_box</code></em> is using to get the strings
1328
from to display in the internal entry.
1330
<div class="variablelist"><table border="0" class="variablelist">
1332
<col align="left" valign="top">
1337
<td><p><span class="term"><em class="parameter"><code>combo_box</code></em> :</span></p></td>
1338
<td>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</td>
1341
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1342
<td>A column in the data source model of <em class="parameter"><code>combo_box</code></em>.</td>
1346
<p class="since">Since 2.24</p>
1349
<div class="refsect1">
1350
<a name="GtkComboBox.property-details"></a><h2>Property Details</h2>
1351
<div class="refsect2">
1352
<a name="GtkComboBox--active"></a><h3>The <code class="literal">"active"</code> property</h3>
1353
<pre class="programlisting"> "active" <span class="type">gint</span> : Read / Write</pre>
1355
The item which is currently active. If the model is a non-flat treemodel,
1356
and the active item is not an immediate child of the root of the tree,
1357
this property has the value
1358
<code class="literal">gtk_tree_path_get_indices (path)[0]</code>,
1359
where <code class="literal">path</code> is the <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> of the active item.
1361
<p>Allowed values: >= G_MAXULONG</p>
1362
<p>Default value: -1</p>
1363
<p class="since">Since 2.4</p>
1366
<div class="refsect2">
1367
<a name="GtkComboBox--add-tearoffs"></a><h3>The <code class="literal">"add-tearoffs"</code> property</h3>
1368
<pre class="programlisting"> "add-tearoffs" <span class="type">gboolean</span> : Read / Write</pre>
1370
The add-tearoffs property controls whether generated menus
1371
have tearoff menu items.
1374
Note that this only affects menu style combo boxes.
1376
<p>Default value: FALSE</p>
1377
<p class="since">Since 2.6</p>
1380
<div class="refsect2">
1381
<a name="GtkComboBox--button-sensitivity"></a><h3>The <code class="literal">"button-sensitivity"</code> property</h3>
1382
<pre class="programlisting"> "button-sensitivity" <a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="type">GtkSensitivityType</span></a> : Read / Write</pre>
1384
Whether the dropdown button is sensitive when
1387
<p>Default value: GTK_SENSITIVITY_AUTO</p>
1388
<p class="since">Since 2.14</p>
1391
<div class="refsect2">
1392
<a name="GtkComboBox--column-span-column"></a><h3>The <code class="literal">"column-span-column"</code> property</h3>
1393
<pre class="programlisting"> "column-span-column" <span class="type">gint</span> : Read / Write</pre>
1395
If this is set to a non-negative value, it must be the index of a column
1396
of type <code class="literal">G_TYPE_INT</code> in the model.
1399
The values of that column are used to determine how many columns a value
1400
in the list will span.
1402
<p>Allowed values: >= G_MAXULONG</p>
1403
<p>Default value: -1</p>
1404
<p class="since">Since 2.4</p>
1407
<div class="refsect2">
1408
<a name="GtkComboBox--entry-text-column"></a><h3>The <code class="literal">"entry-text-column"</code> property</h3>
1409
<pre class="programlisting"> "entry-text-column" <span class="type">gint</span> : Read / Write</pre>
1411
The column in the combo box's model to associate with strings from the entry
1412
if the combo was created with <a class="link" href="GtkComboBox.html#GtkComboBox--has-entry" title='The "has-entry" property'><span class="type">"has-entry"</span></a> = <code class="literal">TRUE</code>.
1414
<p>Allowed values: >= G_MAXULONG</p>
1415
<p>Default value: -1</p>
1416
<p class="since">Since 2.24</p>
1419
<div class="refsect2">
1420
<a name="GtkComboBox--focus-on-click"></a><h3>The <code class="literal">"focus-on-click"</code> property</h3>
1421
<pre class="programlisting"> "focus-on-click" <span class="type">gboolean</span> : Read / Write</pre>
1422
<p>Whether the combo box grabs focus when it is clicked with the mouse.</p>
1423
<p>Default value: TRUE</p>
1426
<div class="refsect2">
1427
<a name="GtkComboBox--has-entry"></a><h3>The <code class="literal">"has-entry"</code> property</h3>
1428
<pre class="programlisting"> "has-entry" <span class="type">gboolean</span> : Read / Write / Construct Only</pre>
1430
Whether the combo box has an entry.
1432
<p>Default value: FALSE</p>
1433
<p class="since">Since 2.24</p>
1436
<div class="refsect2">
1437
<a name="GtkComboBox--has-frame"></a><h3>The <code class="literal">"has-frame"</code> property</h3>
1438
<pre class="programlisting"> "has-frame" <span class="type">gboolean</span> : Read / Write</pre>
1440
The has-frame property controls whether a frame
1441
is drawn around the entry.
1443
<p>Default value: TRUE</p>
1444
<p class="since">Since 2.6</p>
1447
<div class="refsect2">
1448
<a name="GtkComboBox--model"></a><h3>The <code class="literal">"model"</code> property</h3>
1449
<pre class="programlisting"> "model" <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>* : Read / Write</pre>
1451
The model from which the combo box takes the values shown
1454
<p class="since">Since 2.4</p>
1457
<div class="refsect2">
1458
<a name="GtkComboBox--popup-shown"></a><h3>The <code class="literal">"popup-shown"</code> property</h3>
1459
<pre class="programlisting"> "popup-shown" <span class="type">gboolean</span> : Read</pre>
1461
Whether the combo boxes dropdown is popped up.
1462
Note that this property is mainly useful, because
1463
it allows you to connect to notify::popup-shown.
1465
<p>Default value: FALSE</p>
1466
<p class="since">Since 2.10</p>
1469
<div class="refsect2">
1470
<a name="GtkComboBox--row-span-column"></a><h3>The <code class="literal">"row-span-column"</code> property</h3>
1471
<pre class="programlisting"> "row-span-column" <span class="type">gint</span> : Read / Write</pre>
1473
If this is set to a non-negative value, it must be the index of a column
1474
of type <code class="literal">G_TYPE_INT</code> in the model.
1477
The values of that column are used to determine how many rows a value in
1478
the list will span. Therefore, the values in the model column pointed to
1479
by this property must be greater than zero and not larger than wrap-width.
1481
<p>Allowed values: >= G_MAXULONG</p>
1482
<p>Default value: -1</p>
1483
<p class="since">Since 2.4</p>
1486
<div class="refsect2">
1487
<a name="GtkComboBox--tearoff-title"></a><h3>The <code class="literal">"tearoff-title"</code> property</h3>
1488
<pre class="programlisting"> "tearoff-title" <span class="type">gchar</span>* : Read / Write</pre>
1490
A title that may be displayed by the window manager
1491
when the popup is torn-off.
1493
<p>Default value: NULL</p>
1494
<p class="since">Since 2.10</p>
1497
<div class="refsect2">
1498
<a name="GtkComboBox--wrap-width"></a><h3>The <code class="literal">"wrap-width"</code> property</h3>
1499
<pre class="programlisting"> "wrap-width" <span class="type">gint</span> : Read / Write</pre>
1501
If wrap-width is set to a positive value, the list will be
1502
displayed in multiple columns, the number of columns is
1503
determined by wrap-width.
1505
<p>Allowed values: >= 0</p>
1506
<p>Default value: 0</p>
1507
<p class="since">Since 2.4</p>
1510
<div class="refsect1">
1511
<a name="GtkComboBox.style-property-details"></a><h2>Style Property Details</h2>
1512
<div class="refsect2">
1513
<a name="GtkComboBox--s-appears-as-list"></a><h3>The <code class="literal">"appears-as-list"</code> style property</h3>
1514
<pre class="programlisting"> "appears-as-list" <span class="type">gboolean</span> : Read</pre>
1515
<p>Whether dropdowns should look like lists rather than menus.</p>
1516
<p>Default value: FALSE</p>
1519
<div class="refsect2">
1520
<a name="GtkComboBox--s-arrow-size"></a><h3>The <code class="literal">"arrow-size"</code> style property</h3>
1521
<pre class="programlisting"> "arrow-size" <span class="type">gint</span> : Read</pre>
1523
Sets the minimum size of the arrow in the combo box. Note
1524
that the arrow size is coupled to the font size, so in case
1525
a larger font is used, the arrow will be larger than set
1528
<p>Allowed values: >= 0</p>
1529
<p>Default value: 15</p>
1530
<p class="since">Since 2.12</p>
1533
<div class="refsect2">
1534
<a name="GtkComboBox--s-shadow-type"></a><h3>The <code class="literal">"shadow-type"</code> style property</h3>
1535
<pre class="programlisting"> "shadow-type" <a class="link" href="gtk2-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a> : Read</pre>
1537
Which kind of shadow to draw around the combo box.
1539
<p>Default value: GTK_SHADOW_NONE</p>
1540
<p class="since">Since 2.12</p>
1543
<div class="refsect1">
1544
<a name="GtkComboBox.signal-details"></a><h2>Signal Details</h2>
1545
<div class="refsect2">
1546
<a name="GtkComboBox-changed"></a><h3>The <code class="literal">"changed"</code> signal</h3>
1547
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *widget,
1548
<span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
1550
The changed signal is emitted when the active
1551
item is changed. The can be due to the user selecting
1552
a different item from the list, or due to a
1553
call to <a class="link" href="GtkComboBox.html#gtk-combo-box-set-active-iter" title="gtk_combo_box_set_active_iter ()"><code class="function">gtk_combo_box_set_active_iter()</code></a>.
1554
It will also be emitted while typing into a GtkComboBoxEntry,
1555
as well as when selecting an item from the GtkComboBoxEntry's list.
1557
<div class="variablelist"><table border="0" class="variablelist">
1559
<col align="left" valign="top">
1564
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
1565
<td>the object which received the signal</td>
1568
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1569
<td>user data set when the signal handler was connected.</td>
1573
<p class="since">Since 2.4</p>
1576
<div class="refsect2">
1577
<a name="GtkComboBox-move-active"></a><h3>The <code class="literal">"move-active"</code> signal</h3>
1578
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *widget,
1579
<a class="link" href="gtk2-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a> scroll_type,
1580
<span class="type">gpointer</span> user_data) : <code class="literal">Action</code></pre>
1582
The ::move-active signal is a
1583
<a class="link" href="gtk2-Bindings.html#keybinding-signals">keybinding signal</a>
1584
which gets emitted to move the active selection.
1586
<div class="variablelist"><table border="0" class="variablelist">
1588
<col align="left" valign="top">
1593
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
1594
<td>the object that received the signal</td>
1597
<td><p><span class="term"><em class="parameter"><code>scroll_type</code></em> :</span></p></td>
1598
<td>a <a class="link" href="gtk2-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a>
1602
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1603
<td>user data set when the signal handler was connected.</td>
1607
<p class="since">Since 2.12</p>
1610
<div class="refsect2">
1611
<a name="GtkComboBox-popdown"></a><h3>The <code class="literal">"popdown"</code> signal</h3>
1612
<pre class="programlisting"><span class="returnvalue">gboolean</span> user_function (<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *button,
1613
<span class="type">gpointer</span> user_data) : <code class="literal">Action</code></pre>
1615
The ::popdown signal is a
1616
<a class="link" href="gtk2-Bindings.html#keybinding-signals">keybinding signal</a>
1617
which gets emitted to popdown the combo box list.
1620
The default bindings for this signal are Alt+Up and Escape.
1622
<div class="variablelist"><table border="0" class="variablelist">
1624
<col align="left" valign="top">
1629
<td><p><span class="term"><em class="parameter"><code>button</code></em> :</span></p></td>
1630
<td>the object which received the signal</td>
1633
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1634
<td>user data set when the signal handler was connected.</td>
1638
<p class="since">Since 2.12</p>
1641
<div class="refsect2">
1642
<a name="GtkComboBox-popup"></a><h3>The <code class="literal">"popup"</code> signal</h3>
1643
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *widget,
1644
<span class="type">gpointer</span> user_data) : <code class="literal">Action</code></pre>
1646
The ::popup signal is a
1647
<a class="link" href="gtk2-Bindings.html#keybinding-signals">keybinding signal</a>
1648
which gets emitted to popup the combo box list.
1651
The default binding for this signal is Alt+Down.
1653
<div class="variablelist"><table border="0" class="variablelist">
1655
<col align="left" valign="top">
1660
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
1661
<td>the object that received the signal</td>
1664
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1665
<td>user data set when the signal handler was connected.</td>
1669
<p class="since">Since 2.12</p>
1672
<div class="refsect1">
1673
<a name="GtkComboBox.see-also"></a><h2>See Also</h2>
1674
<a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a>, <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>, <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a>
1677
<div class="footer">
1679
Generated by GTK-Doc V1.18</div>
b'\\ No newline at end of file'