2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
5
<!ENTITY version SYSTEM "version.xml">
6
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
9
<refentry id="BraseroMediumSelection">
11
<refentrytitle role="top_of_page" id="BraseroMediumSelection.top_of_page">BraseroMediumSelection</refentrytitle>
12
<manvolnum>3</manvolnum>
13
<refmiscinfo>BRASERO Library</refmiscinfo>
17
<refname>BraseroMediumSelection</refname>
18
<refpurpose></refpurpose>
21
<refsynopsisdiv id="BraseroMediumSelection.synopsis" role="synopsis">
22
<title role="synopsis.title">Synopsis</title>
25
<link linkend="BraseroMediumSelection-struct">BraseroMediumSelection</link>;
26
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="brasero-medium-selection-new">brasero_medium_selection_new</link> (void);
27
<link linkend="BraseroMedium">BraseroMedium</link> * <link linkend="brasero-medium-selection-get-active">brasero_medium_selection_get_active</link> (<link linkend="BraseroMediumSelection">BraseroMediumSelection</link> *selector);
28
<link linkend="gboolean">gboolean</link> <link linkend="brasero-medium-selection-set-active">brasero_medium_selection_set_active</link> (<link linkend="BraseroMediumSelection">BraseroMediumSelection</link> *selector,
29
<link linkend="BraseroMedium">BraseroMedium</link> *medium);
30
<link linkend="void">void</link> <link linkend="brasero-medium-selection-show-media-type">brasero_medium_selection_show_media_type</link>
31
(<link linkend="BraseroMediumSelection">BraseroMediumSelection</link> *selector,
32
<link linkend="BraseroMediaType">BraseroMediaType</link> type);
36
<refsect1 id="BraseroMediumSelection.object-hierarchy" role="object_hierarchy">
37
<title role="object_hierarchy.title">Object Hierarchy</title>
39
<link linkend="GObject">GObject</link>
40
+----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
41
+----<link linkend="GtkObject">GtkObject</link>
42
+----<link linkend="GtkWidget">GtkWidget</link>
43
+----<link linkend="GtkContainer">GtkContainer</link>
44
+----<link linkend="GtkBin">GtkBin</link>
45
+----<link linkend="GtkComboBox">GtkComboBox</link>
46
+----BraseroMediumSelection
52
<refsect1 id="BraseroMediumSelection.implemented-interfaces" role="impl_interfaces">
53
<title role="impl_interfaces.title">Implemented Interfaces</title>
55
BraseroMediumSelection implements
56
<link linkend="AtkImplementorIface">AtkImplementorIface</link>, <link linkend="GtkBuildable">GtkBuildable</link>, <link linkend="GtkCellLayout">GtkCellLayout</link> and <link linkend="GtkCellEditable">GtkCellEditable</link>.</para>
60
<refsect1 id="BraseroMediumSelection.properties" role="properties">
61
<title role="properties.title">Properties</title>
63
"<link linkend="BraseroMediumSelection--media-type">media-type</link>" <link linkend="guint">guint</link> : Read / Write
64
"<link linkend="BraseroMediumSelection--medium">medium</link>" <link linkend="BraseroMedium">BraseroMedium</link>* : Read / Write
68
<refsect1 id="BraseroMediumSelection.signals" role="signal_proto">
69
<title role="signal_proto.title">Signals</title>
71
"<link linkend="BraseroMediumSelection-medium-changed">medium-changed</link>" : Run First / No Recursion / Action
76
<refsect1 id="BraseroMediumSelection.description" role="desc">
77
<title role="desc.title">Description</title>
82
<refsect1 id="BraseroMediumSelection.details" role="details">
83
<title role="details.title">Details</title>
84
<refsect2 id="BraseroMediumSelection-struct" role="struct">
85
<title>BraseroMediumSelection</title>
86
<indexterm zone="BraseroMediumSelection-struct"><primary sortas="BraseroMediumSelection">BraseroMediumSelection</primary></indexterm><programlisting>typedef struct _BraseroMediumSelection BraseroMediumSelection;</programlisting>
89
<refsect2 id="brasero-medium-selection-new" role="function">
90
<title>brasero_medium_selection_new ()</title>
91
<indexterm zone="brasero-medium-selection-new"><primary sortas="brasero_medium_selection_new">brasero_medium_selection_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* brasero_medium_selection_new (void);</programlisting>
93
Creates a new <link linkend="BraseroMediumSelection"><type>BraseroMediumSelection</type></link> object</para>
95
</para><variablelist role="params">
96
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a <link linkend="GtkWidget"><type>GtkWidget</type></link>. Unref when it is not needed anymore.
97
</simpara></listitem></varlistentry>
98
</variablelist></refsect2>
99
<refsect2 id="brasero-medium-selection-get-active" role="function">
100
<title>brasero_medium_selection_get_active ()</title>
101
<indexterm zone="brasero-medium-selection-get-active"><primary sortas="brasero_medium_selection_get_active">brasero_medium_selection_get_active</primary></indexterm><programlisting><link linkend="BraseroMedium">BraseroMedium</link> * brasero_medium_selection_get_active (<link linkend="BraseroMediumSelection">BraseroMediumSelection</link> *selector);</programlisting>
103
Gets the active medium.</para>
105
</para><variablelist role="params">
106
<varlistentry><term><parameter>selector</parameter> :</term>
107
<listitem><simpara> a <link linkend="BraseroMediumSelection"><type>BraseroMediumSelection</type></link>
108
</simpara></listitem></varlistentry>
109
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a <link linkend="BraseroMedium"><type>BraseroMedium</type></link> or NULL. Unref when it is not needed anymore.
110
</simpara></listitem></varlistentry>
111
</variablelist></refsect2>
112
<refsect2 id="brasero-medium-selection-set-active" role="function">
113
<title>brasero_medium_selection_set_active ()</title>
114
<indexterm zone="brasero-medium-selection-set-active"><primary sortas="brasero_medium_selection_set_active">brasero_medium_selection_set_active</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> brasero_medium_selection_set_active (<link linkend="BraseroMediumSelection">BraseroMediumSelection</link> *selector,
115
<link linkend="BraseroMedium">BraseroMedium</link> *medium);</programlisting>
117
Sets the active medium. Emits the ::medium-changed signal.</para>
119
</para><variablelist role="params">
120
<varlistentry><term><parameter>selector</parameter> :</term>
121
<listitem><simpara> a <link linkend="BraseroMediumSelection"><type>BraseroMediumSelection</type></link>
122
</simpara></listitem></varlistentry>
123
<varlistentry><term><parameter>medium</parameter> :</term>
124
<listitem><simpara> a <link linkend="BraseroMedium"><type>BraseroMedium</type></link> to set as the active one in the selector
125
</simpara></listitem></varlistentry>
126
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a <link linkend="gboolean"><type>gboolean</type></link>. TRUE if it succeeded, FALSE otherwise.
127
</simpara></listitem></varlistentry>
128
</variablelist></refsect2>
129
<refsect2 id="brasero-medium-selection-show-media-type" role="function">
130
<title>brasero_medium_selection_show_media_type ()</title>
131
<indexterm zone="brasero-medium-selection-show-media-type"><primary sortas="brasero_medium_selection_show_media_type">brasero_medium_selection_show_media_type</primary></indexterm><programlisting><link linkend="void">void</link> brasero_medium_selection_show_media_type
132
(<link linkend="BraseroMediumSelection">BraseroMediumSelection</link> *selector,
133
<link linkend="BraseroMediaType">BraseroMediaType</link> type);</programlisting>
135
Filters and displays media corresponding to <parameter>type</parameter>.</para>
137
</para><variablelist role="params">
138
<varlistentry><term><parameter>selector</parameter> :</term>
139
<listitem><simpara> a <link linkend="BraseroMediumSelection"><type>BraseroMediumSelection</type></link>
140
</simpara></listitem></varlistentry>
141
<varlistentry><term><parameter>type</parameter> :</term>
142
<listitem><simpara> a <link linkend="BraseroMediaType"><type>BraseroMediaType</type></link>
143
</simpara></listitem></varlistentry>
144
</variablelist></refsect2>
147
<refsect1 id="BraseroMediumSelection.property-details" role="property_details">
148
<title role="property_details.title">Property Details</title>
149
<refsect2 id="BraseroMediumSelection--media-type" role="property"><title>The <literal>"media-type"</literal> property</title>
150
<indexterm zone="BraseroMediumSelection--media-type"><primary sortas="BraseroMediumSelection:media-type">BraseroMediumSelection:media-type</primary></indexterm><programlisting> "media-type" <link linkend="guint">guint</link> : Read / Write</programlisting>
151
<para>The type of media displayed.</para><para>Allowed values: <= 255</para>
152
<para>Default value: 0</para>
154
<refsect2 id="BraseroMediumSelection--medium" role="property"><title>The <literal>"medium"</literal> property</title>
155
<indexterm zone="BraseroMediumSelection--medium"><primary sortas="BraseroMediumSelection:medium">BraseroMediumSelection:medium</primary></indexterm><programlisting> "medium" <link linkend="BraseroMedium">BraseroMedium</link>* : Read / Write</programlisting>
156
<para>The currently selected medium.</para></refsect2>
159
<refsect1 id="BraseroMediumSelection.signal-details" role="signals">
160
<title role="signals.title">Signal Details</title>
161
<refsect2 id="BraseroMediumSelection-medium-changed" role="signal"><title>The <literal>"medium-changed"</literal> signal</title>
162
<indexterm zone="BraseroMediumSelection-medium-changed"><primary sortas="BraseroMediumSelection::medium-changed">BraseroMediumSelection::medium-changed</primary></indexterm><programlisting><link linkend="void">void</link> user_function (<link linkend="BraseroMediumSelection">BraseroMediumSelection</link> *monitor,
163
<link linkend="BraseroMedium">BraseroMedium</link> *medium,
164
<link linkend="gpointer">gpointer</link> user_data) : Run First / No Recursion / Action</programlisting>
166
This signal gets emitted when the selected medium has changed.</para>
168
</para><variablelist role="params">
169
<varlistentry><term><parameter>monitor</parameter> :</term>
170
<listitem><simpara> the object which received the signal
171
</simpara></listitem></varlistentry>
172
<varlistentry><term><parameter>medium</parameter> :</term>
173
<listitem><simpara> the new selected medium
174
</simpara></listitem></varlistentry>
175
<varlistentry><term><parameter>user_data</parameter> :</term>
176
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
177
</variablelist></refsect2>