543 lines
26 KiB
HTML
543 lines
26 KiB
HTML
<!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.33.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_proto_type">
|
||
<col class="functions_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">GMountOperation</span> *
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">GdkScreen</span> *
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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">
|
||
<span class="returnvalue">gboolean</span>
|
||
</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"><span class="type">gboolean</span></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">
|
||
<span class="type">GdkScreen</span> *</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="other_proto_type">
|
||
<col class="other_proto_name">
|
||
</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"> GObject
|
||
<span class="lineart">╰──</span> GMountOperation
|
||
<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 <span class="type">GMountOperation</span> that can be used with
|
||
GIO functions for mounting volumes such as
|
||
<code class="function">g_file_mount_enclosing_volume()</code>, <code class="function">g_file_mount_mountable()</code>,
|
||
<code class="function">g_volume_mount()</code>, <code class="function">g_mount_unmount_with_operation()</code> 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
|
||
<span class="type">GdkAppLaunchContext</span>, 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"><span class="returnvalue">GMountOperation</span> *
|
||
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 <code class="literal">NULL</code>. </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"><span class="returnvalue">gboolean</span>
|
||
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> <code class="literal">TRUE</code> 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 <code class="literal">NULL</code>. </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="The data is owned by the callee, which is responsible of freeing it."><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><span class="type">GdkScreen</span> *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 <span class="type">GdkScreen</span></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"><span class="returnvalue">GdkScreen</span> *
|
||
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="The data is owned by the callee, which is responsible of freeing it."><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"><span class="returnvalue">gboolean</span>
|
||
gtk_show_uri (<em class="parameter"><code><span class="type">GdkScreen</span> *screen</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
|
||
<em class="parameter"><code><span class="type">guint32</span> timestamp</code></em>,
|
||
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_show_uri</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
|
||
<p>Use <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> instead.</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 <code class="literal">NULL</code> 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 <span class="type">GError</span> 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> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> 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"><span class="returnvalue">gboolean</span>
|
||
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><span class="type">guint32</span> timestamp</code></em>,
|
||
<em class="parameter"><code><span class="type">GError</span> **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
|
||
<code class="literal">GDK_CURRENT_TIME</code>.</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 <span class="type">GError</span> 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> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> 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” <span class="type">gboolean</span></pre>
|
||
<p>Are we showing a dialog.</p>
|
||
<p>Owner: GtkMountOperation</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>Owner: GtkMountOperation</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” <span class="type">GdkScreen</span> *</pre>
|
||
<p>The screen where this window will be displayed.</p>
|
||
<p>Owner: GtkMountOperation</p>
|
||
<p>Flags: Read / Write</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.33.1</div>
|
||
</body>
|
||
</html> |