<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Filesystem utilities: GTK+ 3 Reference Manual</title> <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"> <link rel="home" href="index.html" title="GTK+ 3 Reference Manual"> <link rel="up" href="gtkbase.html" title="Part III. GTK+ Core Reference"> <link rel="prev" href="gtk3-Testing.html" title="Testing"> <link rel="next" href="theming.html" title="Part IV. Theming in GTK+"> <meta name="generator" content="GTK-Doc V1.25.1 (XML mode)"> <link rel="stylesheet" href="style.css" type="text/css"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> <td width="100%" align="left" class="shortcuts"> <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> <a href="#gtk3-Filesystem-utilities.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> <a href="#gtk3-Filesystem-utilities.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span> <a href="#gtk3-Filesystem-utilities.properties" class="shortcut">Properties</a></span> </td> <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> <td><a accesskey="u" href="gtkbase.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> <td><a accesskey="p" href="gtk3-Testing.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> <td><a accesskey="n" href="theming.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> </tr></table> <div class="refentry"> <a name="gtk3-Filesystem-utilities"></a><div class="titlepage"></div> <div class="refnamediv"><table width="100%"><tr> <td valign="top"> <h2><span class="refentrytitle"><a name="gtk3-Filesystem-utilities.top_of_page"></a>Filesystem utilities</span></h2> <p>Filesystem utilities — Functions for working with GIO</p> </td> <td class="gallery_image" valign="top" align="right"></td> </tr></table></div> <div class="refsect1"> <a name="gtk3-Filesystem-utilities.functions"></a><h2>Functions</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="functions_return"> <col class="functions_name"> </colgroup> <tbody> <tr> <td class="function_type"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GMountOperation.html#GMountOperation-struct"><span class="returnvalue">GMountOperation</span></a> * </td> <td class="function_name"> <a class="link" href="gtk3-Filesystem-utilities.html#gtk-mount-operation-new" title="gtk_mount_operation_new ()">gtk_mount_operation_new</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="gtk3-Filesystem-utilities.html#gtk-mount-operation-is-showing" title="gtk_mount_operation_is_showing ()">gtk_mount_operation_is_showing</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="gtk3-Filesystem-utilities.html#gtk-mount-operation-set-parent" title="gtk_mount_operation_set_parent ()">gtk_mount_operation_set_parent</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="returnvalue">GtkWindow</span></a> * </td> <td class="function_name"> <a class="link" href="gtk3-Filesystem-utilities.html#gtk-mount-operation-get-parent" title="gtk_mount_operation_get_parent ()">gtk_mount_operation_get_parent</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <span class="returnvalue">void</span> </td> <td class="function_name"> <a class="link" href="gtk3-Filesystem-utilities.html#gtk-mount-operation-set-screen" title="gtk_mount_operation_set_screen ()">gtk_mount_operation_set_screen</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> * </td> <td class="function_name"> <a class="link" href="gtk3-Filesystem-utilities.html#gtk-mount-operation-get-screen" title="gtk_mount_operation_get_screen ()">gtk_mount_operation_get_screen</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="gtk3-Filesystem-utilities.html#gtk-show-uri" title="gtk_show_uri ()">gtk_show_uri</a> <span class="c_punctuation">()</span> </td> </tr> <tr> <td class="function_type"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> </td> <td class="function_name"> <a class="link" href="gtk3-Filesystem-utilities.html#gtk-show-uri-on-window" title="gtk_show_uri_on_window ()">gtk_show_uri_on_window</a> <span class="c_punctuation">()</span> </td> </tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="gtk3-Filesystem-utilities.properties"></a><h2>Properties</h2> <div class="informaltable"><table class="informaltable" border="0"> <colgroup> <col width="150px" class="properties_type"> <col width="300px" class="properties_name"> <col width="200px" class="properties_flags"> </colgroup> <tbody> <tr> <td class="property_type"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> <td class="property_name"><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation--is-showing" title="The “is-showing” property">is-showing</a></td> <td class="property_flags">Read</td> </tr> <tr> <td class="property_type"> <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *</td> <td class="property_name"><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation--parent" title="The “parent” property">parent</a></td> <td class="property_flags">Read / Write</td> </tr> <tr> <td class="property_type"> <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</td> <td class="property_name"><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation--screen" title="The “screen” property">screen</a></td> <td class="property_flags">Read / Write</td> </tr> </tbody> </table></div> </div> <a name="GtkMountOperation"></a><div class="refsect1"> <a name="gtk3-Filesystem-utilities.other"></a><h2>Types and Values</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="name"> <col class="description"> </colgroup> <tbody> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation-struct" title="struct GtkMountOperation">GtkMountOperation</a></td> </tr> <tr> <td class="datatype_keyword">struct</td> <td class="function_name"><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperationClass" title="struct GtkMountOperationClass">GtkMountOperationClass</a></td> </tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="gtk3-Filesystem-utilities.object-hierarchy"></a><h2>Object Hierarchy</h2> <pre class="screen"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> <span class="lineart">╰──</span> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GMountOperation.html#GMountOperation-struct">GMountOperation</a> <span class="lineart">╰──</span> GtkMountOperation </pre> </div> <div class="refsect1"> <a name="gtk3-Filesystem-utilities.includes"></a><h2>Includes</h2> <pre class="synopsis">#include <gtk/gtk.h> </pre> </div> <div class="refsect1"> <a name="gtk3-Filesystem-utilities.description"></a><h2>Description</h2> <p>The functions and objects described here make working with GTK+ and GIO more convenient.</p> <p><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> is needed when mounting volumes: It is an implementation of <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GMountOperation.html#GMountOperation-struct"><span class="type">GMountOperation</span></a> that can be used with GIO functions for mounting volumes such as <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#g-file-mount-enclosing-volume"><code class="function">g_file_mount_enclosing_volume()</code></a>, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#g-file-mount-mountable"><code class="function">g_file_mount_mountable()</code></a>, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GVolume.html#g-volume-mount"><code class="function">g_volume_mount()</code></a>, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GMount.html#g-mount-unmount-with-operation"><code class="function">g_mount_unmount_with_operation()</code></a> and others.</p> <p>When necessary, <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> shows dialogs to ask for passwords, questions or show processes blocking unmount.</p> <p>gtk_show_uri_on_window() is a convenient way to launch applications for URIs.</p> <p>Another object that is worth mentioning in this context is <a href="../html/gdk3-Application-launching.html#GdkAppLaunchContext-struct"><span class="type">GdkAppLaunchContext</span></a>, which provides visual feedback when lauching applications.</p> </div> <div class="refsect1"> <a name="gtk3-Filesystem-utilities.functions_details"></a><h2>Functions</h2> <div class="refsect2"> <a name="gtk-mount-operation-new"></a><h3>gtk_mount_operation_new ()</h3> <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GMountOperation.html#GMountOperation-struct"><span class="returnvalue">GMountOperation</span></a> * gtk_mount_operation_new (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>);</pre> <p>Creates a new <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a></p> <div class="refsect3"> <a name="gtk-mount-operation-new.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>parent</p></td> <td class="parameter_description"><p> transient parent of the window, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-mount-operation-new.returns"></a><h4>Returns</h4> <p> a new <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a></p> </div> <p class="since">Since: 2.14</p> </div> <hr> <div class="refsect2"> <a name="gtk-mount-operation-is-showing"></a><h3>gtk_mount_operation_is_showing ()</h3> <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_mount_operation_is_showing (<em class="parameter"><code><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> *op</code></em>);</pre> <p>Returns whether the <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> is currently displaying a window.</p> <div class="refsect3"> <a name="gtk-mount-operation-is-showing.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>op</p></td> <td class="parameter_description"><p>a <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-mount-operation-is-showing.returns"></a><h4>Returns</h4> <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>op</code></em> is currently displaying a window</p> </div> <p class="since">Since: 2.14</p> </div> <hr> <div class="refsect2"> <a name="gtk-mount-operation-set-parent"></a><h3>gtk_mount_operation_set_parent ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> gtk_mount_operation_set_parent (<em class="parameter"><code><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> *op</code></em>, <em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>);</pre> <p>Sets the transient parent for windows shown by the <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a>.</p> <div class="refsect3"> <a name="gtk-mount-operation-set-parent.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>op</p></td> <td class="parameter_description"><p>a <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>parent</p></td> <td class="parameter_description"><p> transient parent of the window, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> </tr> </tbody> </table></div> </div> <p class="since">Since: 2.14</p> </div> <hr> <div class="refsect2"> <a name="gtk-mount-operation-get-parent"></a><h3>gtk_mount_operation_get_parent ()</h3> <pre class="programlisting"><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="returnvalue">GtkWindow</span></a> * gtk_mount_operation_get_parent (<em class="parameter"><code><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> *op</code></em>);</pre> <p>Gets the transient parent used by the <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a></p> <div class="refsect3"> <a name="gtk-mount-operation-get-parent.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>op</p></td> <td class="parameter_description"><p>a <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-mount-operation-get-parent.returns"></a><h4>Returns</h4> <p> the transient parent for windows shown by <em class="parameter"><code>op</code></em> . </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> <p class="since">Since: 2.14</p> </div> <hr> <div class="refsect2"> <a name="gtk-mount-operation-set-screen"></a><h3>gtk_mount_operation_set_screen ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> gtk_mount_operation_set_screen (<em class="parameter"><code><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> *op</code></em>, <em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre> <p>Sets the screen to show windows of the <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> on.</p> <div class="refsect3"> <a name="gtk-mount-operation-set-screen.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>op</p></td> <td class="parameter_description"><p>a <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a></p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>screen</p></td> <td class="parameter_description"><p>a <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a></p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <p class="since">Since: 2.14</p> </div> <hr> <div class="refsect2"> <a name="gtk-mount-operation-get-screen"></a><h3>gtk_mount_operation_get_screen ()</h3> <pre class="programlisting"><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="returnvalue">GdkScreen</span></a> * gtk_mount_operation_get_screen (<em class="parameter"><code><a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> *op</code></em>);</pre> <p>Gets the screen on which windows of the <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a> will be shown.</p> <div class="refsect3"> <a name="gtk-mount-operation-get-screen.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody><tr> <td class="parameter_name"><p>op</p></td> <td class="parameter_description"><p>a <a class="link" href="gtk3-Filesystem-utilities.html#GtkMountOperation"><span class="type">GtkMountOperation</span></a></p></td> <td class="parameter_annotations"> </td> </tr></tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-mount-operation-get-screen.returns"></a><h4>Returns</h4> <p> the screen on which windows of <em class="parameter"><code>op</code></em> are shown. </p> <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p> </div> <p class="since">Since: 2.14</p> </div> <hr> <div class="refsect2"> <a name="gtk-show-uri"></a><h3>gtk_show_uri ()</h3> <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_show_uri (<em class="parameter"><code><a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *screen</code></em>, <em class="parameter"><code>const <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>, <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>, <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> <div class="warning"><p><code class="literal">gtk_show_uri</code> is deprecated and should not be used in newly-written code.</p></div> <p>A convenience function for launching the default application to show the uri. Like <a class="link" href="gtk3-Filesystem-utilities.html#gtk-show-uri-on-window" title="gtk_show_uri_on_window ()"><code class="function">gtk_show_uri_on_window()</code></a>, but takes a screen as transient parent instead of a window.</p> <p>Note that this function is deprecated as it does not pass the necessary information for helpers to parent their dialog properly, when run from sandboxed applications for example.</p> <div class="refsect3"> <a name="gtk-show-uri.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>screen</p></td> <td class="parameter_description"><p> screen to show the uri on or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default screen. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> </tr> <tr> <td class="parameter_name"><p>uri</p></td> <td class="parameter_description"><p>the uri to show</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>timestamp</p></td> <td class="parameter_description"><p>a timestamp to prevent focus stealing</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>error</p></td> <td class="parameter_description"><p>a <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> that is returned in case of errors</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-show-uri.returns"></a><h4>Returns</h4> <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p> </div> <p class="since">Since: 2.14</p> </div> <hr> <div class="refsect2"> <a name="gtk-show-uri-on-window"></a><h3>gtk_show_uri_on_window ()</h3> <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_show_uri_on_window (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>, <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>, <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>, <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> <p>This is a convenience function for launching the default application to show the uri. The uri must be of a form understood by GIO (i.e. you need to install gvfs to get support for uri schemes such as http:// or ftp://, as only local files are handled by GIO itself). Typical examples are</p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"><p><code class="literal">file:///home/gnome/pict.jpg</code></p></li> <li class="listitem"><p><code class="literal">http://www.gnome.org</code></p></li> <li class="listitem"><p><code class="literal">mailto:me@gnome.org</code></p></li> </ul></div> <p>Ideally the timestamp is taken from the event triggering the <a class="link" href="gtk3-Filesystem-utilities.html#gtk-show-uri" title="gtk_show_uri ()"><code class="function">gtk_show_uri()</code></a> call. If timestamp is not known you can take <a href="../html/gdk3-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>.</p> <p>This is the recommended call to be used as it passes information necessary for sandbox helpers to parent their dialogs properly.</p> <div class="refsect3"> <a name="gtk-show-uri-on-window.parameters"></a><h4>Parameters</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> <col class="parameters_description"> <col width="200px" class="parameters_annotations"> </colgroup> <tbody> <tr> <td class="parameter_name"><p>parent</p></td> <td class="parameter_description"><p> parent window. </p></td> <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> </tr> <tr> <td class="parameter_name"><p>uri</p></td> <td class="parameter_description"><p>the uri to show</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>timestamp</p></td> <td class="parameter_description"><p>a timestamp to prevent focus stealing</p></td> <td class="parameter_annotations"> </td> </tr> <tr> <td class="parameter_name"><p>error</p></td> <td class="parameter_description"><p>a <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> that is returned in case of errors</p></td> <td class="parameter_annotations"> </td> </tr> </tbody> </table></div> </div> <div class="refsect3"> <a name="gtk-show-uri-on-window.returns"></a><h4>Returns</h4> <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error</p> </div> <p class="since">Since: <a class="link" href="api-index-3-22.html#api-index-3.22">3.22</a></p> </div> </div> <div class="refsect1"> <a name="gtk3-Filesystem-utilities.other_details"></a><h2>Types and Values</h2> <div class="refsect2"> <a name="GtkMountOperation-struct"></a><h3>struct GtkMountOperation</h3> <pre class="programlisting">struct GtkMountOperation;</pre> <p>This should not be accessed directly. Use the accessor functions below.</p> </div> <hr> <div class="refsect2"> <a name="GtkMountOperationClass"></a><h3>struct GtkMountOperationClass</h3> <pre class="programlisting">struct GtkMountOperationClass { GMountOperationClass parent_class; }; </pre> <div class="refsect3"> <a name="GtkMountOperationClass.members"></a><h4>Members</h4> <div class="informaltable"><table class="informaltable" width="100%" border="0"> <colgroup> <col width="300px" class="struct_members_name"> <col class="struct_members_description"> <col width="200px" class="struct_members_annotations"> </colgroup> <tbody></tbody> </table></div> </div> </div> </div> <div class="refsect1"> <a name="gtk3-Filesystem-utilities.property-details"></a><h2>Property Details</h2> <div class="refsect2"> <a name="GtkMountOperation--is-showing"></a><h3>The <code class="literal">“is-showing”</code> property</h3> <pre class="programlisting"> “is-showing” <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> <p>Are we showing a dialog.</p> <p>Flags: Read</p> <p>Default value: FALSE</p> </div> <hr> <div class="refsect2"> <a name="GtkMountOperation--parent"></a><h3>The <code class="literal">“parent”</code> property</h3> <pre class="programlisting"> “parent” <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *</pre> <p>The parent window.</p> <p>Flags: Read / Write</p> </div> <hr> <div class="refsect2"> <a name="GtkMountOperation--screen"></a><h3>The <code class="literal">“screen”</code> property</h3> <pre class="programlisting"> “screen” <a href="../html/GdkScreen.html#GdkScreen-struct"><span class="type">GdkScreen</span></a> *</pre> <p>The screen where this window will be displayed.</p> <p>Flags: Read / Write</p> </div> </div> </div> <div class="footer"> <hr>Generated by GTK-Doc V1.25.1</div> </body> </html>