← Back to branch summary

~ubuntu-branches/debian/experimental/gtk+2.0/experimental

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkCellRendererCombo.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-09-17 11:15:05 UTC
  • mto: (72.1.1 lenny) (1.4.1 upstream)
  • mto: This revision was merged to the branch mainline in revision 55.
  • Revision ID: james.westby@ubuntu.com-20070917111505-giz9c5xltxkb5y54
Tags: upstream-2.12.0
Import upstream version 2.12.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkCellRendererCombo.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>GtkCellRendererCombo</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
8
8
<link rel="up" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
9
9
<link rel="prev" href="GtkCellRendererAccel.html" title="GtkCellRendererAccel">
10
10
<link rel="next" href="GtkCellRendererPixbuf.html" title="GtkCellRendererPixbuf">
11
 
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.8 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="part" href="gtk.html" title="Part&#160;I.&#160;GTK+ Overview">
14
14
<link rel="part" href="gtkbase.html" title="Part&#160;II.&#160;GTK+ Core Reference">
68
68
<th width="100%" align="center">GTK+ Reference Manual</th>
69
69
<td><a accesskey="n" href="GtkCellRendererPixbuf.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
70
70
</tr>
71
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3669426" class="shortcut">Top</a>
72
 
                  &#160;|&#160;
73
 
                  <a href="#id3669583" class="shortcut">Description</a>
74
 
                  &#160;|&#160;
75
 
                  <a href="#id3669464" class="shortcut">Object Hierarchy</a>
76
 
                  &#160;|&#160;
77
 
                  <a href="#id3669518" class="shortcut">Properties</a></nobr></td></tr>
 
71
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3421808" class="shortcut">Top</a>
 
72
                  &#160;|&#160;
 
73
                  <a href="#id3421969" class="shortcut">Description</a>
 
74
                  &#160;|&#160;
 
75
                  <a href="#id3421845" class="shortcut">Object Hierarchy</a>
 
76
                  &#160;|&#160;
 
77
                  <a href="#id3421900" class="shortcut">Properties</a></nobr></td></tr>
78
78
</table>
79
79
<div class="refentry" lang="en">
80
80
<a name="GtkCellRendererCombo"></a><div class="titlepage"></div>
81
81
<div class="refnamediv"><table width="100%"><tr>
82
82
<td valign="top">
83
83
<h2>
84
 
<a name="id3669426"></a><span class="refentrytitle">GtkCellRendererCombo</span>
 
84
<a name="id3421808"></a><span class="refentrytitle">GtkCellRendererCombo</span>
85
85
</h2>
86
86
<p>GtkCellRendererCombo &#8212; Renders a combobox in a cell</p>
87
87
</td>
94
94
#include &lt;gtk/gtk.h&gt;
95
95
 
96
96
 
97
 
                    <a href="GtkCellRendererCombo.html#GtkCellRendererCombo-struct">GtkCellRendererCombo</a>;
98
 
<a href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>*    <a href="GtkCellRendererCombo.html#gtk-cell-renderer-combo-new">gtk_cell_renderer_combo_new</a>         (void);
 
97
                    <a class="link" href="GtkCellRendererCombo.html#GtkCellRendererCombo-struct">GtkCellRendererCombo</a>;
 
98
<a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>*    <a class="link" href="GtkCellRendererCombo.html#gtk-cell-renderer-combo-new">gtk_cell_renderer_combo_new</a>         (void);
99
99
 
100
100
 
101
101
</pre>
102
102
</div>
103
103
<div class="refsect1" lang="en">
104
 
<a name="id3669464"></a><h2>Object Hierarchy</h2>
 
104
<a name="id3421845"></a><h2>Object Hierarchy</h2>
105
105
<pre class="synopsis">
106
106
 
107
107
  <a
108
 
href="/home/mclasen/gnome-2.18/install/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
 
108
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
109
109
>GObject</a>
110
110
   +----<a
111
 
href="/home/mclasen/gnome-2.18/install/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
 
111
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
112
112
>GInitiallyUnowned</a>
113
 
         +----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
114
 
               +----<a href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>
115
 
                     +----<a href="GtkCellRendererText.html" title="GtkCellRendererText">GtkCellRendererText</a>
 
113
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
 
114
               +----<a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>
 
115
                     +----<a class="link" href="GtkCellRendererText.html" title="GtkCellRendererText">GtkCellRendererText</a>
116
116
                           +----GtkCellRendererCombo
117
117
</pre>
118
118
</div>
119
119
<div class="refsect1" lang="en">
120
 
<a name="id3669518"></a><h2>Properties</h2>
 
120
<a name="id3421900"></a><h2>Properties</h2>
121
121
<pre class="synopsis">
122
122
 
123
 
  <a href="GtkCellRendererCombo.html#GtkCellRendererCombo--has-entry">has-entry</a>                <a
124
 
href="/home/mclasen/gnome-2.18/install/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
123
  "<a class="link" href="GtkCellRendererCombo.html#GtkCellRendererCombo--has-entry">has-entry</a>"                <a
 
124
href="../glib/glib-Basic-Types.html#gboolean"
125
125
>gboolean</a>              : Read / Write
126
 
  <a href="GtkCellRendererCombo.html#GtkCellRendererCombo--model">model</a>                    <a href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a>          : Read / Write
127
 
  <a href="GtkCellRendererCombo.html#GtkCellRendererCombo--text-column">text-column</a>              <a
128
 
href="/home/mclasen/gnome-2.18/install/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
126
  "<a class="link" href="GtkCellRendererCombo.html#GtkCellRendererCombo--model">model</a>"                    <a class="link" href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a>          : Read / Write
 
127
  "<a class="link" href="GtkCellRendererCombo.html#GtkCellRendererCombo--text-column">text-column</a>"              <a
 
128
href="../glib/glib-Basic-Types.html#gint"
129
129
>gint</a>                  : Read / Write
130
130
</pre>
131
131
</div>
132
132
<div class="refsect1" lang="en">
133
 
<a name="id3669583"></a><h2>Description</h2>
 
133
<a name="id3421969"></a><h2>Description</h2>
134
134
<p>
135
 
<a href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a> renders text in a cell like <a href="GtkCellRendererText.html" title="GtkCellRendererText"><span class="type">GtkCellRendererText</span></a> from 
136
 
which it is derived. But while <a href="GtkCellRendererText.html" title="GtkCellRendererText"><span class="type">GtkCellRendererText</span></a> offers a simple entry to 
137
 
edit the text, <a href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a> offers a <a href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> or <a href="GtkComboBoxEntry.html" title="GtkComboBoxEntry"><span class="type">GtkComboBoxEntry</span></a>
 
135
<a class="link" href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a> renders text in a cell like <a class="link" href="GtkCellRendererText.html" title="GtkCellRendererText"><span class="type">GtkCellRendererText</span></a> from 
 
136
which it is derived. But while <a class="link" href="GtkCellRendererText.html" title="GtkCellRendererText"><span class="type">GtkCellRendererText</span></a> offers a simple entry to 
 
137
edit the text, <a class="link" href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a> offers a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> or <a class="link" href="GtkComboBoxEntry.html" title="GtkComboBoxEntry"><span class="type">GtkComboBoxEntry</span></a>
138
138
widget to edit the text. The values to display in the combo box are taken from 
139
139
the tree model specified in the 
140
 
<a href="GtkCellRendererCombo.html#GtkCellRendererCombo--model">model</a> property.
 
140
<a class="link" href="GtkCellRendererCombo.html#GtkCellRendererCombo--model">model</a> property.
141
141
</p>
142
142
<p>
143
143
The combo cell renderer takes care of adding a text cell renderer to the combo 
144
144
box and sets it to display the column specified by its 
145
 
<a href="GtkCellRendererCombo.html#GtkCellRendererCombo--text-column">text-column</a> 
 
145
<a class="link" href="GtkCellRendererCombo.html#GtkCellRendererCombo--text-column">text-column</a> 
146
146
property. Further properties of the comnbo box can be set in a handler for the 
147
147
editing-started signal.
148
148
</p>
149
149
<p>
150
 
The <a href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a> cell renderer was added in GTK+ 2.6.
 
150
The <a class="link" href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a> cell renderer was added in GTK+ 2.6.
151
151
</p>
152
152
</div>
153
153
<div class="refsect1" lang="en">
154
 
<a name="id3669688"></a><h2>Details</h2>
 
154
<a name="id3422073"></a><h2>Details</h2>
155
155
<div class="refsect2" lang="en">
156
 
<a name="id3669698"></a><h3>
 
156
<a name="id3422083"></a><h3>
157
157
<a name="GtkCellRendererCombo-struct"></a>GtkCellRendererCombo</h3>
158
 
<a class="indexterm" name="id3669711"></a><pre class="programlisting">typedef struct _GtkCellRendererCombo GtkCellRendererCombo;</pre>
 
158
<a class="indexterm" name="id3422097"></a><pre class="programlisting">typedef struct _GtkCellRendererCombo GtkCellRendererCombo;</pre>
159
159
<p>
160
160
 
161
161
</p>
162
162
</div>
163
163
<hr>
164
164
<div class="refsect2" lang="en">
165
 
<a name="id3669727"></a><h3>
 
165
<a name="id3422112"></a><h3>
166
166
<a name="gtk-cell-renderer-combo-new"></a>gtk_cell_renderer_combo_new ()</h3>
167
 
<a class="indexterm" name="id3669743"></a><pre class="programlisting"><a href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>*    gtk_cell_renderer_combo_new         (void);</pre>
 
167
<a class="indexterm" name="id3422128"></a><pre class="programlisting"><a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer">GtkCellRenderer</a>*    gtk_cell_renderer_combo_new         (void);</pre>
168
168
<p>
169
 
Creates a new <a href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a>. 
 
169
Creates a new <a class="link" href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a>. 
170
170
Adjust how text is drawn using object properties. 
171
171
Object properties can be set globally (with <a
172
 
href="/home/mclasen/gnome-2.18/install/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-set"
 
172
href="../gobject/gobject-The-Base-Object-Type.html#g-object-set"
173
173
><code class="function">g_object_set()</code></a>). 
174
 
Also, with <a href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a>, you can bind a property to a value 
175
 
in a <a href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>. For example, you can bind the "text" property 
 
174
Also, with <a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn"><span class="type">GtkTreeViewColumn</span></a>, you can bind a property to a value 
 
175
in a <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>. For example, you can bind the "text" property 
176
176
on the cell renderer to a string value in the model, thus rendering 
177
 
a different string in each row of the <a href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>.</p>
 
177
a different string in each row of the <a class="link" href="GtkTreeView.html" title="GtkTreeView"><span class="type">GtkTreeView</span></a>.</p>
178
178
<p>
179
179
 
180
180
</p>
181
181
<div class="variablelist"><table border="0">
182
182
<col align="left" valign="top">
183
183
<tbody><tr>
184
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
184
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
185
185
<td> the new cell renderer
186
186
 
187
187
</td>
192
192
</div>
193
193
</div>
194
194
<div class="refsect1" lang="en">
195
 
<a name="id3669839"></a><h2>Property Details</h2>
 
195
<a name="id3422224"></a><h2>Property Details</h2>
196
196
<div class="refsect2" lang="en">
197
 
<a name="id3669850"></a><h3>
198
 
<a name="GtkCellRendererCombo--has-entry"></a>The :<code class="literal">has-entry</code> property</h3>
199
 
<a class="indexterm" name="id3669866"></a><pre class="programlisting">  has-entry                <a
200
 
href="/home/mclasen/gnome-2.18/install/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
 
197
<a name="id3422235"></a><h3>
 
198
<a name="GtkCellRendererCombo--has-entry"></a>The <code class="literal">"has-entry"</code> property</h3>
 
199
<a class="indexterm" name="id3422252"></a><pre class="programlisting">  "has-entry"                <a
 
200
href="../glib/glib-Basic-Types.html#gboolean"
201
201
>gboolean</a>              : Read / Write</pre>
202
202
<p>
203
203
If <a
204
 
href="/home/mclasen/gnome-2.18/install/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
 
204
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
205
205
><code class="literal">TRUE</code></a>, the cell renderer will include an entry and allow to enter 
206
206
values other than the ones in the popup list.</p>
207
207
<p>
213
213
</div>
214
214
<hr>
215
215
<div class="refsect2" lang="en">
216
 
<a name="id3669913"></a><h3>
217
 
<a name="GtkCellRendererCombo--model"></a>The :<code class="literal">model</code> property</h3>
218
 
<a class="indexterm" name="id3669929"></a><pre class="programlisting">  model                    <a href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a>          : Read / Write</pre>
 
216
<a name="id3422299"></a><h3>
 
217
<a name="GtkCellRendererCombo--model"></a>The <code class="literal">"model"</code> property</h3>
 
218
<a class="indexterm" name="id3422315"></a><pre class="programlisting">  "model"                    <a class="link" href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a>          : Read / Write</pre>
219
219
<p>
220
220
Holds a tree model containing the possible values for the combo box. 
221
221
Use the text_column property to specify the column holding the values.</p>
227
227
</div>
228
228
<hr>
229
229
<div class="refsect2" lang="en">
230
 
<a name="id3669963"></a><h3>
231
 
<a name="GtkCellRendererCombo--text-column"></a>The :<code class="literal">text-column</code> property</h3>
232
 
<a class="indexterm" name="id3669979"></a><pre class="programlisting">  text-column              <a
233
 
href="/home/mclasen/gnome-2.18/install/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
 
230
<a name="id3422350"></a><h3>
 
231
<a name="GtkCellRendererCombo--text-column"></a>The <code class="literal">"text-column"</code> property</h3>
 
232
<a class="indexterm" name="id3422367"></a><pre class="programlisting">  "text-column"              <a
 
233
href="../glib/glib-Basic-Types.html#gint"
234
234
>gint</a>                  : Read / Write</pre>
235
235
<p>
236
236
Specifies the model column which holds the possible values for the 
242
242
this cell renderer is attached.
243
243
</p>
244
244
<p>
245
 
<a href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a> automatically adds a text cell renderer for 
 
245
<a class="link" href="GtkCellRendererCombo.html" title="GtkCellRendererCombo"><span class="type">GtkCellRendererCombo</span></a> automatically adds a text cell renderer for 
246
246
this column to its combo box.</p>
247
247
<p>
248
248
 
253
253
</p>
254
254
</div>
255
255
</div>
 
256
<div class="refsect1" lang="en">
 
257
<a name="id3422430"></a><div class="refsect2" lang="en"><a name="id3422431"></a></div>
 
258
<hr>
 
259
<div class="refsect2" lang="en"><a name="id3422432"></a></div>
 
260
</div>
256
261
</div>
257
262
</body>
258
263
</html>