callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 3.24.0

Browse Source
This commit is contained in:
Iain Lane
2018-09-04 17:26:14 +01:00
parent 52f6c5e304 ef1a1b5cb1
commit 115bc01cec
538 changed files with 55578 additions and 33249 deletions
Download Patch File Download Diff File Expand all files Collapse all files

74
docs/reference/gtk/html/gtk3-Filesystem-utilities.html
View File

@ -43,7 +43,7 @@
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">GMountOperation</span> *
<a href="https://developer.gnome.org/gio/unstable/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>
@ -51,7 +51,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/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>
@ -83,7 +83,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GdkScreen</span> *
<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>
@ -91,7 +91,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/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>
@ -99,7 +99,7 @@
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
<a href="https://developer.gnome.org/glib/unstable/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>
@ -118,7 +118,7 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/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>
@ -130,7 +130,7 @@
</tr>
<tr>
<td class="property_type">
<span class="type">GdkScreen</span> *</td>
<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>
@ -158,8 +158,8 @@
</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
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="https://developer.gnome.org/gio/unstable/GMountOperation.html#GMountOperation-struct">GMountOperation</a>
<span class="lineart">╰──</span> GtkMountOperation
</pre>
</div>
@ -173,22 +173,22 @@
<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
It is an implementation of <a href="https://developer.gnome.org/gio/unstable/GMountOperation.html#GMountOperation-struct"><span class="type">GMountOperation</span></a> 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>
<a href="https://developer.gnome.org/gio/unstable/GFile.html#g-file-mount-enclosing-volume"><code class="function">g_file_mount_enclosing_volume()</code></a>, <a href="https://developer.gnome.org/gio/unstable/GFile.html#g-file-mount-mountable"><code class="function">g_file_mount_mountable()</code></a>,
<a href="https://developer.gnome.org/gio/unstable/GVolume.html#g-volume-mount"><code class="function">g_volume_mount()</code></a>, <a href="https://developer.gnome.org/gio/unstable/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
<span class="type">GdkAppLaunchContext</span>, which provides visual feedback when lauching
<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"><span class="returnvalue">GMountOperation</span> *
<pre class="programlisting"><a href="https://developer.gnome.org/gio/unstable/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">
@ -201,7 +201,7 @@ gtk_mount_operation_new (<em class="parameter"><code><a class="link" href="GtkWi
</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_description"><p>transient parent of the window, or <a href="https://developer.gnome.org/glib/unstable/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>
@ -215,7 +215,7 @@ gtk_mount_operation_new (<em class="parameter"><code><a class="link" href="GtkWi
<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>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/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>
@ -236,7 +236,7 @@ a window.</p>
</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>
<p> <a href="https://developer.gnome.org/glib/unstable/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>
@ -265,7 +265,7 @@ gtk_mount_operation_set_parent (<em class="parameter"><code><a class="link" href
</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_description"><p>transient parent of the window, or <a href="https://developer.gnome.org/glib/unstable/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>
@ -307,7 +307,7 @@ gtk_mount_operation_get_parent (<em class="parameter"><code><a class="link" href
<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>
<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>
@ -325,7 +325,7 @@ gtk_mount_operation_set_screen (<em class="parameter"><code><a class="link" href
</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_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>
@ -336,7 +336,7 @@ gtk_mount_operation_set_screen (<em class="parameter"><code><a class="link" href
<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> *
<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>
@ -366,11 +366,11 @@ are shown. </p>
<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>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/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="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/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
@ -390,7 +390,7 @@ sandboxed applications for example.</p>
<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>
or <a href="https://developer.gnome.org/glib/unstable/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>
@ -405,7 +405,7 @@ or <code class="literal">NULL</code> for the default screen. </p></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_description"><p>a <a href="https://developer.gnome.org/glib/unstable/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>
@ -413,18 +413,18 @@ or <code class="literal">NULL</code> for the default screen. </p></td>
</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>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="https://developer.gnome.org/glib/unstable/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"><span class="returnvalue">gboolean</span>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/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><span class="type">guint32</span> timestamp</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> timestamp</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/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://
@ -437,7 +437,7 @@ Typical examples are</p>
</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>
<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">
@ -466,7 +466,7 @@ necessary for sandbox helpers to parent their dialogs properly.</p>
</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_description"><p>a <a href="https://developer.gnome.org/glib/unstable/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>
@ -474,7 +474,7 @@ necessary for sandbox helpers to parent their dialogs properly.</p>
</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>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="https://developer.gnome.org/glib/unstable/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>
@ -510,7 +510,7 @@ necessary for sandbox helpers to parent their dialogs properly.</p>
<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>
<pre class="programlisting"> “is-showing” <a href="https://developer.gnome.org/glib/unstable/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>
@ -525,7 +525,7 @@ necessary for sandbox helpers to parent their dialogs properly.</p>
<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>
<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>