gvolumemonitor.html

来自「最新gtk中文资料集」· HTML 代码 · 共 781 行 · 第 1/3 页

>GList</a>*              g_volume_monitor_get_mounts         (<a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor">GVolumeMonitor</a> *volume_monitor);</pre>
<p>
Gets a list of the mounts on the system.
</p>
<p>
The returned list should be freed with <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#g-list-free"
><code class="function">g_list_free()</code></a>, after
its elements have been unreffed with <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"
><code class="function">g_object_unref()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"
><span class="type">GList</span></a> of <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>s
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3218453"></a><h3>
<a name="g-volume-monitor-adopt-orphan-mount"></a>g_volume_monitor_adopt_orphan_mount ()</h3>
<a class="indexterm" name="id3218466"></a><pre class="programlisting"><a class="link" href="GVolume.html" title="GVolume">GVolume</a>*            g_volume_monitor_adopt_orphan_mount (<a class="link" href="GMount.html" title="GMount">GMount</a> *mount);</pre>
<p>
This function should be called by any <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a>
implementation when a new <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> object is created that is not
associated with a <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> object. It must be called just before
emitting the <em class="parameter"><code>mount_added</code></em> signal.
</p>
<p>
If the return value is not <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>, the caller must associate the
returned <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> object with the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>. This involves returning
it in it's <a class="link" href="GMount.html#g-mount-get-volume"><code class="function">g_mount_get_volume()</code></a> implementation. The caller must
also listen for the "removed" signal on the returned object
and give up it's reference when handling that signal
</p>
<p>
Similary, if implementing <a class="link" href="GVolumeMonitor.html#g-volume-monitor-adopt-orphan-mount"><code class="function">g_volume_monitor_adopt_orphan_mount()</code></a>,
the implementor must take a reference to <em class="parameter"><code>mount</code></em> and return it in
it's <a class="link" href="GVolume.html#g-volume-get-mount"><code class="function">g_volume_get_mount()</code></a> implemented. Also, the implementor must
listen for the "unmounted" signal on <em class="parameter"><code>mount</code></em> and give up it's
reference upon handling that signal.
</p>
<p>
There are two main use cases for this function.
</p>
<p>
One is when implementing a user space file system driver that reads
blocks of a block device that is already represented by the native
volume monitor (for example a CD Audio file system driver). Such
a driver will generate it's own <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> object that needs to be
assoicated with the <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> object that represents the volume.
</p>
<p>
The other is for implementing a <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a> whose sole purpose
is to return <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> objects representing entries in the users
"favorite servers" list or similar.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>mount</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> object to find a parent for
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> object that is the parent for <em class="parameter"><code>mount</code></em> or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
if no wants to adopt the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3218696"></a><h3>
<a name="g-volume-monitor-get-mount-for-uuid"></a>g_volume_monitor_get_mount_for_uuid ()</h3>
<a class="indexterm" name="id3218709"></a><pre class="programlisting"><a class="link" href="GMount.html" title="GMount">GMount</a>*             g_volume_monitor_get_mount_for_uuid (<a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor">GVolumeMonitor</a> *volume_monitor,
                                                         const char *uuid);</pre>
<p>
Finds a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> object by it's UUID (see <a class="link" href="GMount.html#g-mount-get-uuid"><code class="function">g_mount_get_uuid()</code></a>)</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uuid</code></em>&#160;:</span></p></td>
<td> the UUID to look for
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if no such mount is available.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3218818"></a><h3>
<a name="g-volume-monitor-get-volume-for-uuid"></a>g_volume_monitor_get_volume_for_uuid ()</h3>
<a class="indexterm" name="id3218831"></a><pre class="programlisting"><a class="link" href="GVolume.html" title="GVolume">GVolume</a>*            g_volume_monitor_get_volume_for_uuid
                                                        (<a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor">GVolumeMonitor</a> *volume_monitor,
                                                         const char *uuid);</pre>
<p>
Finds a <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> object by it's UUID (see <a class="link" href="GVolume.html#g-volume-get-uuid"><code class="function">g_volume_get_uuid()</code></a>)</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uuid</code></em>&#160;:</span></p></td>
<td> the UUID to look for
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> a <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if no such volume is available.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3218942"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3218952"></a><h3>
<a name="GVolumeMonitor-drive-changed"></a>The <code class="literal">"drive-changed"</code> signal</h3>
<a class="indexterm" name="id3218966"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor">GVolumeMonitor</a> *volume_monitor,
                                                        <a class="link" href="GDrive.html" title="GDrive">GDrive</a>         *drive,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)           : Run Last</pre>
<p>
Emitted when a drive changes.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em>&#160;:</span></p></td>
<td> The volume monitor emitting the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>drive</code></em>&#160;:</span></p></td>
<td> the drive that changed
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3219051"></a><h3>
<a name="GVolumeMonitor-drive-connected"></a>The <code class="literal">"drive-connected"</code> signal</h3>
<a class="indexterm" name="id3219066"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor">GVolumeMonitor</a> *volume_monitor,
                                                        <a class="link" href="GDrive.html" title="GDrive">GDrive</a>         *drive,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)           : Run Last</pre>
<p>
Emitted when a drive is connected to the system.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em>&#160;:</span></p></td>
<td> The volume monitor emitting the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>drive</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> that was connected.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3219157"></a><h3>
<a name="GVolumeMonitor-drive-disconnected"></a>The <code class="literal">"drive-disconnected"</code> signal</h3>
<a class="indexterm" name="id3219171"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor">GVolumeMonitor</a> *volume_monitor,
                                                        <a class="link" href="GDrive.html" title="GDrive">GDrive</a>         *drive,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>        user_data)           : Run Last</pre>
<p>
Emitted when a drive is disconnected from the system.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em>&#160;:</span></p></td>
<td> The volume monitor emitting the signal.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>drive</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> that was disconnected.
</td>
</tr>