| Top |
| GMountOperation * | gtk_mount_operation_new () |
| gboolean | gtk_mount_operation_is_showing () |
| void | gtk_mount_operation_set_parent () |
| GtkWindow * | gtk_mount_operation_get_parent () |
| void | gtk_mount_operation_set_screen () |
| GdkScreen * | gtk_mount_operation_get_screen () |
| gboolean | gtk_show_uri () |
| gboolean | gtk_show_uri_on_window () |
The functions and objects described here make working with GTK+ and GIO more convenient.
GtkMountOperation is needed when mounting volumes:
It is an implementation of GMountOperation that can be used with
GIO functions for mounting volumes such as
g_file_mount_enclosing_volume(), g_file_mount_mountable(),
g_volume_mount(), g_mount_unmount_with_operation() and others.
When necessary, GtkMountOperation shows dialogs to ask for passwords, questions or show processes blocking unmount.
gtk_show_uri_on_window() is a convenient way to launch applications for URIs.
Another object that is worth mentioning in this context is GdkAppLaunchContext, which provides visual feedback when lauching applications.
GMountOperation *
gtk_mount_operation_new (GtkWindow *parent);
Creates a new GtkMountOperation
Since: 2.14
gboolean
gtk_mount_operation_is_showing (GtkMountOperation *op);
Returns whether the GtkMountOperation is currently displaying a window.
Since: 2.14
void gtk_mount_operation_set_parent (GtkMountOperation *op,GtkWindow *parent);
Sets the transient parent for windows shown by the GtkMountOperation.
Since: 2.14
GtkWindow *
gtk_mount_operation_get_parent (GtkMountOperation *op);
Gets the transient parent used by the GtkMountOperation
Since: 2.14
void gtk_mount_operation_set_screen (GtkMountOperation *op,GdkScreen *screen);
Sets the screen to show windows of the GtkMountOperation on.
Since: 2.14
GdkScreen *
gtk_mount_operation_get_screen (GtkMountOperation *op);
Gets the screen on which windows of the GtkMountOperation will be shown.
Since: 2.14
gboolean gtk_show_uri (GdkScreen *screen,const gchar *uri,guint32 timestamp,GError **error);
gtk_show_uri has been deprecated since version 3.22 and should not be used in newly-written code.
Use gtk_show_uri_on_window() instead.
A convenience function for launching the default application
to show the uri. Like gtk_show_uri_on_window(), but takes a screen
as transient parent instead of a window.
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.
screen |
screen to show the uri on
or |
[allow-none] |
uri |
the uri to show |
|
timestamp |
a timestamp to prevent focus stealing |
|
error |
a GError that is returned in case of errors |
Since: 2.14
gboolean gtk_show_uri_on_window (GtkWindow *parent,const char *uri,guint32 timestamp,GError **error);
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
file:///home/gnome/pict.jpg
http://www.gnome.org
mailto:me@gnome.org
Ideally the timestamp is taken from the event triggering
the gtk_show_uri() call. If timestamp is not known you can take
GDK_CURRENT_TIME.
This is the recommended call to be used as it passes information necessary for sandbox helpers to parent their dialogs properly.
parent |
parent window. |
[allow-none] |
uri |
the uri to show |
|
timestamp |
a timestamp to prevent focus stealing |
|
error |
a GError that is returned in case of errors |
Since: 3.22
struct GtkMountOperation;
This should not be accessed directly. Use the accessor functions below.
“is-showing” property “is-showing” gboolean
Are we showing a dialog.
Owner: GtkMountOperation
Flags: Read
Default value: FALSE
“parent” property“parent” GtkWindow *
The parent window.
Owner: GtkMountOperation
Flags: Read / Write