|  |  |  | GTK+ 3 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
#include <gtk/gtk.h> struct GtkMountOperation; GMountOperation * gtk_mount_operation_new (GtkWindow *parent); gboolean gtk_mount_operation_is_showing (GtkMountOperation *op); void gtk_mount_operation_set_parent (GtkMountOperation *op,GtkWindow *parent); GtkWindow * gtk_mount_operation_get_parent (GtkMountOperation *op); void gtk_mount_operation_set_screen (GtkMountOperation *op,GdkScreen *screen); GdkScreen * gtk_mount_operation_get_screen (GtkMountOperation *op); gboolean gtk_show_uri (GdkScreen *screen,const gchar *uri,guint32 timestamp,GError **error);
"is-showing" gboolean : Read "parent" GtkWindow* : Read / Write "screen" GdkScreen* : Read / Write
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() 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.
struct GtkMountOperation;
This should not be accessed directly. Use the accessor functions below.
GMountOperation *   gtk_mount_operation_new             (GtkWindow *parent);
Creates a new GtkMountOperation
| 
 | transient parent of the window, or NULL. [allow-none] | 
| Returns : | a new GtkMountOperation | 
Since 2.14
gboolean            gtk_mount_operation_is_showing      (GtkMountOperation *op);
Returns whether the GtkMountOperation is currently displaying a window.
| 
 | a GtkMountOperation | 
| Returns : | TRUEifopis 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.
| 
 | a GtkMountOperation | 
| 
 | transient parent of the window, or NULL. [allow-none] | 
Since 2.14
GtkWindow *         gtk_mount_operation_get_parent      (GtkMountOperation *op);
Gets the transient parent used by the GtkMountOperation
| 
 | a GtkMountOperation | 
| Returns : | the transient parent for windows shown by op. [transfer none] | 
Since 2.14
void gtk_mount_operation_set_screen (GtkMountOperation *op,GdkScreen *screen);
Sets the screen to show windows of the GtkMountOperation on.
| 
 | a GtkMountOperation | 
| 
 | a GdkScreen | 
Since 2.14
GdkScreen *         gtk_mount_operation_get_screen      (GtkMountOperation *op);
Gets the screen on which windows of the GtkMountOperation will be shown.
| 
 | a GtkMountOperation | 
| Returns : | the screen on which windows of opare shown. [transfer none] | 
Since 2.14
gboolean gtk_show_uri (GdkScreen *screen,const gchar *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 function can be used as a replacement for gnome_vfs_url_show()
and gnome_url_show().
| 
 | screen to show the uri on
or NULLfor the default screen. [allow-none] | 
| 
 | the uri to show | 
| 
 | a timestamp to prevent focus stealing | 
| 
 | a GError that is returned in case of errors | 
| Returns : | TRUEon success,FALSEon error | 
Since 2.14