GI.Gio.Objects.AppLaunchContext

Integrating the launch with the launching application. This is used to handle for instance startup notification and launching the new application on the same screen as the launching window.

Exported types

newtype AppLaunchContext

Constructors

AppLaunchContext (ManagedPtr AppLaunchContext)

Instances

GObject AppLaunchContext

Methods

gobjectType :: AppLaunchContext -> IO GType

IsObject AppLaunchContext

IsAppLaunchContext AppLaunchContext

class GObject o => IsAppLaunchContext o

Instances

(GObject a, UnknownAncestorError Constraint AppLaunchContext a) => IsAppLaunchContext a

IsAppLaunchContext AppLaunchContext

toAppLaunchContext :: (MonadIO m, IsAppLaunchContext o) => o -> m AppLaunchContext

noAppLaunchContext :: Maybe AppLaunchContext

Methods

getDisplay

appLaunchContextGetDisplay

Arguments

:: (HasCallStack, MonadIO m, IsAppLaunchContext a, IsAppInfo b, IsFile c)

=> a

context: a AppLaunchContext

-> b

info: a AppInfo

-> [c]

files: a List of File objects

-> m Text

Returns: a display string for the display.

Gets the display string for the context. This is used to ensure new applications are started on the same display as the launching application, by setting the DISPLAY environment variable.

getEnvironment

appLaunchContextGetEnvironment

Arguments

:: (HasCallStack, MonadIO m, IsAppLaunchContext a)

=> a

context: a AppLaunchContext

-> m [Text]

Returns: the child's environment

Gets the complete environment variable list to be passed to the child process when context is used to launch an application. This is a Nothing-terminated array of strings, where each string has the form KEY=VALUE.

Since: 2.32

getStartupNotifyId

appLaunchContextGetStartupNotifyId

Arguments

:: (HasCallStack, MonadIO m, IsAppLaunchContext a, IsAppInfo b, IsFile c)

=> a

context: a AppLaunchContext

-> b

info: a AppInfo

-> [c]

files: a List of of File objects

-> m Text

Returns: a startup notification ID for the application, or Nothing if not supported.

Initiates startup notification for the application and returns the DESKTOP_STARTUP_ID for the launched operation, if supported.

Startup notification IDs are defined in the FreeDesktop.Org Startup Notifications standard.

launchFailed

appLaunchContextLaunchFailed

Arguments

:: (HasCallStack, MonadIO m, IsAppLaunchContext a)

=> a

context: a AppLaunchContext.

-> Text

startupNotifyId: the startup notification id that was returned by appLaunchContextGetStartupNotifyId.

-> m ()

Called when an application has failed to launch, so that it can cancel the application startup notification started in appLaunchContextGetStartupNotifyId.

new

appLaunchContextNew

Arguments

:: (HasCallStack, MonadIO m)

=> m AppLaunchContext

Returns: a AppLaunchContext.

Creates a new application launch context. This is not normally used, instead you instantiate a subclass of this, such as GdkAppLaunchContext.

setenv

appLaunchContextSetenv

Arguments

:: (HasCallStack, MonadIO m, IsAppLaunchContext a)

=> a

context: a AppLaunchContext

-> Text

variable: the environment variable to set

-> Text

value: the value for to set the variable to.

-> m ()

Arranges for variable to be set to value in the child's environment when context is used to launch an application.

Since: 2.32

unsetenv

appLaunchContextUnsetenv

Arguments

:: (HasCallStack, MonadIO m, IsAppLaunchContext a)

=> a

context: a AppLaunchContext

-> Text

variable: the environment variable to remove

-> m ()

Arranges for variable to be unset in the child's environment when context is used to launch an application.

Since: 2.32

Signals

launchFailed

type AppLaunchContextLaunchFailedCallback = Text -> IO ()

type C_AppLaunchContextLaunchFailedCallback = Ptr () -> CString -> Ptr () -> IO ()

afterAppLaunchContextLaunchFailed :: (IsAppLaunchContext a, MonadIO m) => a -> AppLaunchContextLaunchFailedCallback -> m SignalHandlerId

genClosure_AppLaunchContextLaunchFailed :: AppLaunchContextLaunchFailedCallback -> IO Closure

mk_AppLaunchContextLaunchFailedCallback :: C_AppLaunchContextLaunchFailedCallback -> IO (FunPtr C_AppLaunchContextLaunchFailedCallback)

noAppLaunchContextLaunchFailedCallback :: Maybe AppLaunchContextLaunchFailedCallback

onAppLaunchContextLaunchFailed :: (IsAppLaunchContext a, MonadIO m) => a -> AppLaunchContextLaunchFailedCallback -> m SignalHandlerId

wrap_AppLaunchContextLaunchFailedCallback :: AppLaunchContextLaunchFailedCallback -> Ptr () -> CString -> Ptr () -> IO ()

launched

type AppLaunchContextLaunchedCallback = AppInfo -> GVariant -> IO ()

type C_AppLaunchContextLaunchedCallback = Ptr () -> Ptr AppInfo -> Ptr GVariant -> Ptr () -> IO ()

afterAppLaunchContextLaunched :: (IsAppLaunchContext a, MonadIO m) => a -> AppLaunchContextLaunchedCallback -> m SignalHandlerId

genClosure_AppLaunchContextLaunched :: AppLaunchContextLaunchedCallback -> IO Closure

mk_AppLaunchContextLaunchedCallback :: C_AppLaunchContextLaunchedCallback -> IO (FunPtr C_AppLaunchContextLaunchedCallback)

noAppLaunchContextLaunchedCallback :: Maybe AppLaunchContextLaunchedCallback

onAppLaunchContextLaunched :: (IsAppLaunchContext a, MonadIO m) => a -> AppLaunchContextLaunchedCallback -> m SignalHandlerId

wrap_AppLaunchContextLaunchedCallback :: AppLaunchContextLaunchedCallback -> Ptr () -> Ptr AppInfo -> Ptr GVariant -> Ptr () -> IO ()