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

((~) * info (ResolveAppLaunchContextMethod t AppLaunchContext), MethodInfo * info AppLaunchContext p) => IsLabel t (AppLaunchContext -> p)

Methods

fromLabel :: Proxy# Symbol t -> AppLaunchContext -> p

((~) * info (ResolveAppLaunchContextMethod t AppLaunchContext), MethodInfo * info AppLaunchContext p) => IsLabelProxy t (AppLaunchContext -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> AppLaunchContext -> p

HasAttributeList * AppLaunchContext

type AttributeList AppLaunchContext

type AttributeList AppLaunchContext

type SignalList AppLaunchContext

type SignalList AppLaunchContext

class GObject o => IsAppLaunchContext o

Instances

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

IsAppLaunchContext AppLaunchContext

toAppLaunchContext :: IsAppLaunchContext o => o -> IO AppLaunchContext

noAppLaunchContext :: Maybe AppLaunchContext

Methods

getDisplay

data AppLaunchContextGetDisplayMethodInfo

Instances

((~) * signature (b -> [c] -> m Text), MonadIO m, IsAppLaunchContext a, IsAppInfo b, IsFile c) => MethodInfo * AppLaunchContextGetDisplayMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AppLaunchContextGetDisplayMethodInfo a -> signature -> s

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

data AppLaunchContextGetEnvironmentMethodInfo

Instances

((~) * signature (m [Text]), MonadIO m, IsAppLaunchContext a) => MethodInfo * AppLaunchContextGetEnvironmentMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AppLaunchContextGetEnvironmentMethodInfo a -> signature -> s

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

data AppLaunchContextGetStartupNotifyIdMethodInfo

Instances

((~) * signature (b -> [c] -> m Text), MonadIO m, IsAppLaunchContext a, IsAppInfo b, IsFile c) => MethodInfo * AppLaunchContextGetStartupNotifyIdMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AppLaunchContextGetStartupNotifyIdMethodInfo a -> signature -> s

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

data AppLaunchContextLaunchFailedMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsAppLaunchContext a) => MethodInfo * AppLaunchContextLaunchFailedMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AppLaunchContextLaunchFailedMethodInfo a -> signature -> s

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

data AppLaunchContextSetenvMethodInfo

Instances

((~) * signature (Text -> Text -> m ()), MonadIO m, IsAppLaunchContext a) => MethodInfo * AppLaunchContextSetenvMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AppLaunchContextSetenvMethodInfo a -> signature -> s

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

data AppLaunchContextUnsetenvMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsAppLaunchContext a) => MethodInfo * AppLaunchContextUnsetenvMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AppLaunchContextUnsetenvMethodInfo a -> signature -> s

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 ()

data AppLaunchContextLaunchFailedSignalInfo

Instances

SignalInfo AppLaunchContextLaunchFailedSignalInfo

Associated Types

type HaskellCallbackType AppLaunchContextLaunchFailedSignalInfo :: *

Methods

connectSignal :: GObject o => SignalProxy o AppLaunchContextLaunchFailedSignalInfo -> o -> HaskellCallbackType AppLaunchContextLaunchFailedSignalInfo -> SignalConnectMode -> IO SignalHandlerId

type HaskellCallbackType AppLaunchContextLaunchFailedSignalInfo

type HaskellCallbackType AppLaunchContextLaunchFailedSignalInfo = AppLaunchContextLaunchFailedCallback

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

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

genClosure_AppLaunchContextLaunchFailed :: AppLaunchContextLaunchFailedCallback -> IO Closure

mk_AppLaunchContextLaunchFailedCallback :: C_AppLaunchContextLaunchFailedCallback -> IO (FunPtr C_AppLaunchContextLaunchFailedCallback)

noAppLaunchContextLaunchFailedCallback :: Maybe AppLaunchContextLaunchFailedCallback

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

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

launched

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

data AppLaunchContextLaunchedSignalInfo

Instances

SignalInfo AppLaunchContextLaunchedSignalInfo

Associated Types

type HaskellCallbackType AppLaunchContextLaunchedSignalInfo :: *

Methods

connectSignal :: GObject o => SignalProxy o AppLaunchContextLaunchedSignalInfo -> o -> HaskellCallbackType AppLaunchContextLaunchedSignalInfo -> SignalConnectMode -> IO SignalHandlerId

type HaskellCallbackType AppLaunchContextLaunchedSignalInfo

type HaskellCallbackType AppLaunchContextLaunchedSignalInfo = AppLaunchContextLaunchedCallback

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

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

genClosure_AppLaunchContextLaunched :: AppLaunchContextLaunchedCallback -> IO Closure

mk_AppLaunchContextLaunchedCallback :: C_AppLaunchContextLaunchedCallback -> IO (FunPtr C_AppLaunchContextLaunchedCallback)

noAppLaunchContextLaunchedCallback :: Maybe AppLaunchContextLaunchedCallback

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

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