7
8
<link rel="up" href="ch01.html" title="API Reference">
8
9
<link rel="prev" href="XfcePanelWindow.html" title="XfcePanelWindow">
9
10
<link rel="next" href="XfceHVBox.html" title="XfceHVBox">
10
<meta name="generator" content="GTK-Doc V1.4 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
11
12
<link rel="stylesheet" href="style.css" type="text/css">
12
13
<link rel="chapter" href="ch01.html" title="API Reference">
14
15
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
<table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
16
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
18
<td><a accesskey="p" href="XfcePanelWindow.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
17
19
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
18
20
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
19
21
<th width="100%" align="center">libxfce4panel Reference Manual</th>
20
22
<td><a accesskey="n" href="XfceHVBox.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
24
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2540294" class="shortcut">Top</a>
26
<a href="#id2573546" class="shortcut">Description</a>
28
<a href="#id2550226" class="shortcut">Object Hierarchy</a>
30
<a href="#id2550275" class="shortcut">Implemented Interfaces</a>
32
<a href="#id2550297" class="shortcut">Properties</a>
34
<a href="#id2550327" class="shortcut">Child Properties</a>
36
<a href="#id2550358" class="shortcut">Signals</a></nobr></td></tr>
22
38
<div class="refentry" lang="en">
23
39
<a name="XfceItembar"></a><div class="titlepage"></div>
24
40
<div class="refnamediv"><table width="100%"><tr>
26
<h2><span class="refentrytitle">XfceItembar</span></h2>
43
<a name="id2540294"></a><span class="refentrytitle">XfceItembar</span>
27
45
<p>XfceItembar — <p>
28
46
Container widget with configurable orientation.
39
57
<a href="XfceItembar.html#XfceItembar-struct">XfceItembar</a>;
40
GtkWidget* <a href="XfceItembar.html#xfce-itembar-new">xfce_itembar_new</a> (GtkOrientation orientation);
59
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
60
>GtkWidget</a>* <a href="XfceItembar.html#xfce-itembar-new">xfce_itembar_new</a> (<a
61
href="/usr/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html#GtkOrientation"
62
>GtkOrientation</a> orientation);
41
63
void <a href="XfceItembar.html#xfce-itembar-set-orientation">xfce_itembar_set_orientation</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
42
GtkOrientation orientation);
43
GtkOrientation <a href="XfceItembar.html#xfce-itembar-get-orientation">xfce_itembar_get_orientation</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar);
65
href="/usr/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html#GtkOrientation"
66
>GtkOrientation</a> orientation);
68
href="/usr/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html#GtkOrientation"
69
>GtkOrientation</a> <a href="XfceItembar.html#xfce-itembar-get-orientation">xfce_itembar_get_orientation</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar);
44
70
void <a href="XfceItembar.html#xfce-itembar-insert">xfce_itembar_insert</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
72
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
47
75
void <a href="XfceItembar.html#xfce-itembar-append">xfce_itembar_append</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
77
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
78
>GtkWidget</a> *item);
49
79
void <a href="XfceItembar.html#xfce-itembar-prepend">xfce_itembar_prepend</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
81
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
82
>GtkWidget</a> *item);
51
83
void <a href="XfceItembar.html#xfce-itembar-reorder-child">xfce_itembar_reorder_child</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
85
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
54
88
void <a href="XfceItembar.html#xfce-itembar-set-child-expand">xfce_itembar_set_child_expand</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
90
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
57
93
gboolean <a href="XfceItembar.html#xfce-itembar-get-child-expand">xfce_itembar_get_child_expand</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
95
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
96
>GtkWidget</a> *item);
59
97
int <a href="XfceItembar.html#xfce-itembar-get-n-items">xfce_itembar_get_n_items</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar);
60
98
int <a href="XfceItembar.html#xfce-itembar-get-item-index">xfce_itembar_get_item_index</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
62
GtkWidget* <a href="XfceItembar.html#xfce-itembar-get-nth-item">xfce_itembar_get_nth_item</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
100
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
101
>GtkWidget</a> *item);
103
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
104
>GtkWidget</a>* <a href="XfceItembar.html#xfce-itembar-get-nth-item">xfce_itembar_get_nth_item</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
64
106
void <a href="XfceItembar.html#xfce-itembar-raise-event-window">xfce_itembar_raise_event_window</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar);
65
107
void <a href="XfceItembar.html#xfce-itembar-lower-event-window">xfce_itembar_lower_event_window</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar);
66
108
gboolean <a href="XfceItembar.html#xfce-itembar-event-window-is-raised">xfce_itembar_event_window_is_raised</a>
67
109
(<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar);
68
GtkWidget* <a href="XfceItembar.html#xfce-itembar-get-item-at-point">xfce_itembar_get_item_at_point</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
111
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
112
>GtkWidget</a>* <a href="XfceItembar.html#xfce-itembar-get-item-at-point">xfce_itembar_get_item_at_point</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
71
115
int <a href="XfceItembar.html#xfce-itembar-get-drop-index">xfce_itembar_get_drop_index</a> (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
77
121
<div class="refsect1" lang="en">
78
<a name="id2604889"></a><h2>Object Hierarchy</h2>
122
<a name="id2550226"></a><h2>Object Hierarchy</h2>
79
123
<pre class="synopsis">
82
126
+----GInitiallyUnowned
128
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
131
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
134
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
89
139
<div class="refsect1" lang="en">
90
<a name="id2604929"></a><h2>Implemented Interfaces</h2>
140
<a name="id2550275"></a><h2>Implemented Interfaces</h2>
92
142
XfceItembar implements
93
143
AtkImplementorIface.</p>
95
145
<div class="refsect1" lang="en">
96
<a name="id2604944"></a><h2>Properties</h2>
146
<a name="id2550297"></a><h2>Properties</h2>
97
147
<pre class="synopsis">
99
"<a href="XfceItembar.html#XfceItembar--orientation">orientation</a>" GtkOrientation : Read / Write
149
"<a href="XfceItembar.html#XfceItembar--orientation">orientation</a>" <a
150
href="/usr/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html#GtkOrientation"
151
>GtkOrientation</a> : Read / Write
102
154
<div class="refsect1" lang="en">
103
<a name="id2604966"></a><h2>Child Properties</h2>
155
<a name="id2550327"></a><h2>Child Properties</h2>
104
156
<pre class="synopsis">
106
158
"<a href="XfceItembar.html#XfceItembar--expand">expand</a>" gboolean : Read / Write
109
161
<div class="refsect1" lang="en">
110
<a name="id2605125"></a><h2>Signal Prototypes</h2>
162
<a name="id2550358"></a><h2>Signals</h2>
111
163
<pre class="synopsis">
113
165
"<a href="XfceItembar.html#XfceItembar-contents-changed">contents-changed</a>"
114
166
void user_function (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
167
gpointer user_data) : Run first
116
168
"<a href="XfceItembar.html#XfceItembar-orientation-changed">orientation-changed</a>"
117
void user_function (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
118
GtkOrientation orientation,
169
void user_function (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
171
href="/usr/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html#GtkOrientation"
172
>GtkOrientation</a> *orientation,
173
gpointer user_data) : Run first
122
176
<div class="refsect1" lang="en">
123
<a name="id2605188"></a><h2>Description</h2>
177
<a name="id2573546"></a><h2>Description</h2>
125
179
<a href="XfceItembar.html" title="XfceItembar"><span class="type">XfceItembar</span></a> is a container widget that can hold multiple widgets. The
126
180
orientation of the bar is configurable and can be changed at any time.
129
183
<div class="refsect1" lang="en">
130
<a name="id2605204"></a><h2>Details</h2>
184
<a name="id2573571"></a><h2>Details</h2>
131
185
<div class="refsect2" lang="en">
132
<a name="id2605209"></a><h3>
186
<a name="id2573581"></a><h3>
133
187
<a name="XfceItembar-struct"></a>XfceItembar</h3>
134
<a class="indexterm" name="id2605218"></a><pre class="programlisting">typedef struct _XfceItembar XfceItembar;</pre>
188
<a class="indexterm" name="id2573594"></a><pre class="programlisting">typedef struct _XfceItembar XfceItembar;</pre>
136
The <a href="XfceItembar.html#XfceItembar-struct"><span class="type">XfceItembar-struct</span></a> struct contains private data only, and
190
The <a href="XfceItembar.html#XfceItembar-struct"><span class="type">XfceItembar</span></a> struct contains private data only, and
137
191
should be accessed using the functions below.
141
195
<div class="refsect2" lang="en">
142
<a name="id2605239"></a><h3>
196
<a name="id2573618"></a><h3>
143
197
<a name="xfce-itembar-new"></a>xfce_itembar_new ()</h3>
144
<a class="indexterm" name="id2605248"></a><pre class="programlisting">GtkWidget* xfce_itembar_new (GtkOrientation orientation);</pre>
198
<a class="indexterm" name="id2573630"></a><pre class="programlisting"><a
199
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
200
>GtkWidget</a>* xfce_itembar_new (<a
201
href="/usr/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html#GtkOrientation"
202
>GtkOrientation</a> orientation);</pre>
169
229
<div class="refsect2" lang="en">
170
<a name="id2605320"></a><h3>
230
<a name="id2573710"></a><h3>
171
231
<a name="xfce-itembar-set-orientation"></a>xfce_itembar_set_orientation ()</h3>
172
<a class="indexterm" name="id2630382"></a><pre class="programlisting">void xfce_itembar_set_orientation (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
173
GtkOrientation orientation);</pre>
232
<a class="indexterm" name="id2573724"></a><pre class="programlisting">void xfce_itembar_set_orientation (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
234
href="/usr/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html#GtkOrientation"
235
>GtkOrientation</a> orientation);</pre>
175
237
Set the orienation of <em class="parameter"><code>itembar</code></em>.</p>
226
292
<div class="refsect2" lang="en">
227
<a name="id2630545"></a><h3>
293
<a name="id2585358"></a><h3>
228
294
<a name="xfce-itembar-insert"></a>xfce_itembar_insert ()</h3>
229
<a class="indexterm" name="id2630553"></a><pre class="programlisting">void xfce_itembar_insert (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
295
<a class="indexterm" name="id2585371"></a><pre class="programlisting">void xfce_itembar_insert (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
297
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
298
>GtkWidget</a> *item,
231
299
int position);</pre>
233
301
Insert new item at <em class="parameter"><code>position</code></em> on <em class="parameter"><code>itembar</code></em>.</p>
262
332
<div class="refsect2" lang="en">
263
<a name="id2657426"></a><h3>
333
<a name="id2585494"></a><h3>
264
334
<a name="xfce-itembar-append"></a>xfce_itembar_append ()</h3>
265
<a class="indexterm" name="id2657434"></a><pre class="programlisting">void xfce_itembar_append (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
266
GtkWidget *item);</pre>
335
<a class="indexterm" name="id2585506"></a><pre class="programlisting">void xfce_itembar_append (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
337
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
338
>GtkWidget</a> *item);</pre>
268
340
Add a new item at the end of <em class="parameter"><code>itembar</code></em>.</p>
291
365
<div class="refsect2" lang="en">
292
<a name="id2657516"></a><h3>
366
<a name="id2585597"></a><h3>
293
367
<a name="xfce-itembar-prepend"></a>xfce_itembar_prepend ()</h3>
294
<a class="indexterm" name="id2657525"></a><pre class="programlisting">void xfce_itembar_prepend (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
295
GtkWidget *item);</pre>
368
<a class="indexterm" name="id2585608"></a><pre class="programlisting">void xfce_itembar_prepend (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
370
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
371
>GtkWidget</a> *item);</pre>
297
373
Add a new item at the start of <em class="parameter"><code>itembar</code></em>.</p>
320
398
<div class="refsect2" lang="en">
321
<a name="id2657608"></a><h3>
399
<a name="id2585699"></a><h3>
322
400
<a name="xfce-itembar-reorder-child"></a>xfce_itembar_reorder_child ()</h3>
323
<a class="indexterm" name="id2657617"></a><pre class="programlisting">void xfce_itembar_reorder_child (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
401
<a class="indexterm" name="id2585711"></a><pre class="programlisting">void xfce_itembar_reorder_child (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
403
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
404
>GtkWidget</a> *item,
325
405
int position);</pre>
327
407
Move <em class="parameter"><code>item</code></em> to a new position on <em class="parameter"><code>itembar</code></em>.</p>
356
438
<div class="refsect2" lang="en">
357
<a name="id2657734"></a><h3>
439
<a name="id2585840"></a><h3>
358
440
<a name="xfce-itembar-set-child-expand"></a>xfce_itembar_set_child_expand ()</h3>
359
<a class="indexterm" name="id2657744"></a><pre class="programlisting">void xfce_itembar_set_child_expand (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
441
<a class="indexterm" name="id2585854"></a><pre class="programlisting">void xfce_itembar_set_child_expand (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
443
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
444
>GtkWidget</a> *item,
361
445
gboolean expand);</pre>
363
447
Sets whether <em class="parameter"><code>item</code></em> should expand when the size of <em class="parameter"><code>itembar</code></em> increases.</p>
552
648
<div class="refsect2" lang="en">
553
<a name="id2658429"></a><h3>
649
<a name="id2586512"></a><h3>
554
650
<a name="xfce-itembar-lower-event-window"></a>xfce_itembar_lower_event_window ()</h3>
555
<a class="indexterm" name="id2658439"></a><pre class="programlisting">void xfce_itembar_lower_event_window (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar);</pre>
651
<a class="indexterm" name="id2586524"></a><pre class="programlisting">void xfce_itembar_lower_event_window (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar);</pre>
557
653
Lower the event window of <em class="parameter"><code>itembar</code></em>. This causes all events, like
558
654
mouse clicks or key presses to be send to the items, before reaching the
697
797
<div class="refsect1" lang="en">
698
<a name="id2658924"></a><h2>Properties</h2>
798
<a name="id2586953"></a><h2>Property Details</h2>
699
799
<div class="refsect2" lang="en">
700
<a name="id2658930"></a><h3>
800
<a name="id2586962"></a><h3>
701
801
<a name="XfceItembar--orientation"></a>The "<code class="literal">orientation</code>" property</h3>
702
<pre class="programlisting"> "orientation" GtkOrientation : Read / Write</pre>
802
<a class="indexterm" name="id2586975"></a><pre class="programlisting"> "orientation" <a
803
href="/usr/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html#GtkOrientation"
804
>GtkOrientation</a> : Read / Write</pre>
704
806
The orientation of the <a href="XfceItembar.html" title="XfceItembar"><span class="type">XfceItembar</span></a>.</p>
711
813
<div class="refsect1" lang="en">
712
<a name="id2658971"></a><h2>Child Properties</h2>
814
<a name="id2587008"></a><h2>Child Property Details</h2>
713
815
<div class="refsect2" lang="en">
714
<a name="id2658977"></a><h3>
816
<a name="id2587018"></a><h3>
715
817
<a name="XfceItembar--expand"></a>The "<code class="literal">expand</code>" child property</h3>
716
<pre class="programlisting"> "expand" gboolean : Read / Write</pre>
818
<a class="indexterm" name="id2587031"></a><pre class="programlisting"> "expand" gboolean : Read / Write</pre>
718
820
Whether the child of the <a href="XfceItembar.html" title="XfceItembar"><span class="type">XfceItembar</span></a> should fill available space.</p>
725
827
<div class="refsect1" lang="en">
726
<a name="id2659017"></a><h2>Signals</h2>
828
<a name="id2587064"></a><h2>Signal Details</h2>
727
829
<div class="refsect2" lang="en">
728
<a name="id2659022"></a><h3>
830
<a name="id2587074"></a><h3>
729
831
<a name="XfceItembar-contents-changed"></a>The "contents-changed" signal</h3>
730
<pre class="programlisting">void user_function (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
731
gpointer user_data);</pre>
832
<a class="indexterm" name="id2587083"></a><pre class="programlisting">void user_function (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
833
gpointer user_data) : Run first</pre>
733
835
Emitted when the contents of the itembar change, either by adding
734
836
a child, removing a child, or reordering a child.</p>
756
858
<div class="refsect2" lang="en">
757
<a name="id2659090"></a><h3>
859
<a name="id2587150"></a><h3>
758
860
<a name="XfceItembar-orientation-changed"></a>The "orientation-changed" signal</h3>
759
<pre class="programlisting">void user_function (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
760
GtkOrientation orientation,
761
gpointer user_data);</pre>
861
<a class="indexterm" name="id2587159"></a><pre class="programlisting">void user_function (<a href="XfceItembar.html" title="XfceItembar">XfceItembar</a> *itembar,
863
href="/usr/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html#GtkOrientation"
864
>GtkOrientation</a> *orientation,
865
gpointer user_data) : Run first</pre>
763
867
Emitted when the orientation of the itembar changes.</p>
791
897
<div class="refsect1" lang="en">
792
<a name="id2659187"></a><h2>See Also</h2>
898
<a name="id2587253"></a><h2>See Also</h2>
794
<span class="type">GtkHBox</span> and <span class="type">GtkVBox</span>.
901
href="/usr/share/gtk-doc/html/gtk/GtkHBox.html"
902
><span class="type">GtkHBox</span></a> and <a
903
href="/usr/share/gtk-doc/html/gtk/GtkVBox.html"
904
><span class="type">GtkVBox</span></a>.
798
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
799
<td align="left"><a accesskey="p" href="XfcePanelWindow.html"><b><< XfcePanelWindow</b></a></td>
800
<td align="right"><a accesskey="n" href="XfceHVBox.html"><b>XfceHVBox >></b></a></td>