Copyright | Will Thompson, Iñaki García Etxebarria and Jonas Platte |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria (garetxe@gmail.com) |
Safe Haskell | None |
Language | Haskell2010 |
GI.GstPbutils.Structs.InstallPluginsContext
Description
Opaque context structure for the plugin installation. Use the provided API to set details on it.
- newtype InstallPluginsContext = InstallPluginsContext (ManagedPtr InstallPluginsContext)
- noInstallPluginsContext :: Maybe InstallPluginsContext
- data InstallPluginsContextFreeMethodInfo
- installPluginsContextFree :: (HasCallStack, MonadIO m) => InstallPluginsContext -> m ()
- installPluginsContextNew :: (HasCallStack, MonadIO m) => m InstallPluginsContext
- data InstallPluginsContextSetConfirmSearchMethodInfo
- installPluginsContextSetConfirmSearch :: (HasCallStack, MonadIO m) => InstallPluginsContext -> Bool -> m ()
- data InstallPluginsContextSetDesktopIdMethodInfo
- installPluginsContextSetDesktopId :: (HasCallStack, MonadIO m) => InstallPluginsContext -> Text -> m ()
- data InstallPluginsContextSetStartupNotificationIdMethodInfo
- installPluginsContextSetStartupNotificationId :: (HasCallStack, MonadIO m) => InstallPluginsContext -> Text -> m ()
- data InstallPluginsContextSetXidMethodInfo
- installPluginsContextSetXid :: (HasCallStack, MonadIO m) => InstallPluginsContext -> Word32 -> m ()
Exported types
newtype InstallPluginsContext Source #
Constructors
InstallPluginsContext (ManagedPtr InstallPluginsContext) |
Instances
Methods
free
data InstallPluginsContextFreeMethodInfo Source #
Instances
((~) * signature (m ()), MonadIO m) => MethodInfo * InstallPluginsContextFreeMethodInfo InstallPluginsContext signature Source # | |
installPluginsContextFree Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> InstallPluginsContext |
|
-> m () |
Frees a InstallPluginsContext
.
new
installPluginsContextNew Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> m InstallPluginsContext | Returns: a new |
Creates a new InstallPluginsContext
.
setConfirmSearch
data InstallPluginsContextSetConfirmSearchMethodInfo Source #
Instances
((~) * signature (Bool -> m ()), MonadIO m) => MethodInfo * InstallPluginsContextSetConfirmSearchMethodInfo InstallPluginsContext signature Source # | |
installPluginsContextSetConfirmSearch Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> InstallPluginsContext |
|
-> Bool |
|
-> m () |
This function is used to tell the external installer process whether it should ask for confirmation or not before searching for missing plugins.
If set, this option will be passed to the installer via a --interaction=[show-confirm-search|hide-confirm-search] command line option.
Since: 1.6
setDesktopId
data InstallPluginsContextSetDesktopIdMethodInfo Source #
Instances
((~) * signature (Text -> m ()), MonadIO m) => MethodInfo * InstallPluginsContextSetDesktopIdMethodInfo InstallPluginsContext signature Source # | |
installPluginsContextSetDesktopId Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> InstallPluginsContext |
|
-> Text |
|
-> m () |
This function is used to pass the calling application's desktop file ID to the external installer process.
A desktop file ID is the basename of the desktop file, including the .desktop extension.
If set, the desktop file ID will be passed to the installer via a --desktop-id= command line option.
Since: 1.6
setStartupNotificationId
data InstallPluginsContextSetStartupNotificationIdMethodInfo Source #
Instances
((~) * signature (Text -> m ()), MonadIO m) => MethodInfo * InstallPluginsContextSetStartupNotificationIdMethodInfo InstallPluginsContext signature Source # | |
installPluginsContextSetStartupNotificationId Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> InstallPluginsContext |
|
-> Text |
|
-> m () |
Sets the startup notification ID for the launched process.
This is typically used to to pass the current X11 event timestamp to the external installer process.
Startup notification IDs are defined in the FreeDesktop.Org Startup Notifications standard.
If set, the ID will be passed to the installer via a --startup-notification-id= command line option.
GTK+/GNOME applications should be able to create a startup notification ID
like this:
<programlisting>
timestamp = gtk_get_current_event_time ();
startup_id = g_strdup_printf ("_TIMEu
", timestamp);
...
</programlisting>
Since: 1.6
setXid
data InstallPluginsContextSetXidMethodInfo Source #
Instances
((~) * signature (Word32 -> m ()), MonadIO m) => MethodInfo * InstallPluginsContextSetXidMethodInfo InstallPluginsContext signature Source # | |
installPluginsContextSetXid Source #
Arguments
:: (HasCallStack, MonadIO m) | |
=> InstallPluginsContext |
|
-> Word32 |
|
-> m () |
This function is for X11-based applications (such as most Gtk/Qt applications on linux/unix) only. You can use it to tell the external installer the XID of your main application window. That way the installer can make its own window transient to your application window during the installation.
If set, the XID will be passed to the installer via a --transient-for=XID command line option.
Gtk+/Gnome application should be able to obtain the XID of the top-level
window like this:
<programlisting>
#include
<gtk/gtk.h>
#ifdef
GDK_WINDOWING_X11
#include
<gdk/gdkx.h>
#endif
...
#ifdef
GDK_WINDOWING_X11
xid = GDK_WINDOW_XWINDOW (GTK_WIDGET (application_window)->window);
#endif
...
</programlisting>