gi-gio-2.0.20: GI/Gio/Objects/DesktopAppInfo.hs
{- |
Copyright : Will Thompson, Iñaki García Etxebarria and Jonas Platte
License : LGPL-2.1
Maintainer : Iñaki García Etxebarria (inaki@blueleaf.cc)
'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' is an implementation of 'GI.Gio.Interfaces.AppInfo.AppInfo' based on
desktop files.
Note that @\<gio\/gdesktopappinfo.h>@ belongs to the UNIX-specific
GIO interfaces, thus you have to use the @gio-unix-2.0.pc@ pkg-config
file when using it.
-}
#define ENABLE_OVERLOADING (MIN_VERSION_haskell_gi_overloading(1,0,0) \
&& !defined(__HADDOCK_VERSION__))
module GI.Gio.Objects.DesktopAppInfo
(
#if ENABLE_OVERLOADING
DesktopAppInfoLaunchUrisAsManagerMethodInfo,
#endif
#if ENABLE_OVERLOADING
DesktopAppInfoLaunchUrisAsManagerWithFdsMethodInfo,
#endif
-- * Exported types
DesktopAppInfo(..) ,
IsDesktopAppInfo ,
toDesktopAppInfo ,
noDesktopAppInfo ,
-- * Methods
-- ** getActionName #method:getActionName#
#if ENABLE_OVERLOADING
DesktopAppInfoGetActionNameMethodInfo ,
#endif
desktopAppInfoGetActionName ,
-- ** getBoolean #method:getBoolean#
#if ENABLE_OVERLOADING
DesktopAppInfoGetBooleanMethodInfo ,
#endif
desktopAppInfoGetBoolean ,
-- ** getCategories #method:getCategories#
#if ENABLE_OVERLOADING
DesktopAppInfoGetCategoriesMethodInfo ,
#endif
desktopAppInfoGetCategories ,
-- ** getFilename #method:getFilename#
#if ENABLE_OVERLOADING
DesktopAppInfoGetFilenameMethodInfo ,
#endif
desktopAppInfoGetFilename ,
-- ** getGenericName #method:getGenericName#
#if ENABLE_OVERLOADING
DesktopAppInfoGetGenericNameMethodInfo ,
#endif
desktopAppInfoGetGenericName ,
-- ** getImplementations #method:getImplementations#
desktopAppInfoGetImplementations ,
-- ** getIsHidden #method:getIsHidden#
#if ENABLE_OVERLOADING
DesktopAppInfoGetIsHiddenMethodInfo ,
#endif
desktopAppInfoGetIsHidden ,
-- ** getKeywords #method:getKeywords#
#if ENABLE_OVERLOADING
DesktopAppInfoGetKeywordsMethodInfo ,
#endif
desktopAppInfoGetKeywords ,
-- ** getLocaleString #method:getLocaleString#
#if ENABLE_OVERLOADING
DesktopAppInfoGetLocaleStringMethodInfo ,
#endif
desktopAppInfoGetLocaleString ,
-- ** getNodisplay #method:getNodisplay#
#if ENABLE_OVERLOADING
DesktopAppInfoGetNodisplayMethodInfo ,
#endif
desktopAppInfoGetNodisplay ,
-- ** getShowIn #method:getShowIn#
#if ENABLE_OVERLOADING
DesktopAppInfoGetShowInMethodInfo ,
#endif
desktopAppInfoGetShowIn ,
-- ** getStartupWmClass #method:getStartupWmClass#
#if ENABLE_OVERLOADING
DesktopAppInfoGetStartupWmClassMethodInfo,
#endif
desktopAppInfoGetStartupWmClass ,
-- ** getString #method:getString#
#if ENABLE_OVERLOADING
DesktopAppInfoGetStringMethodInfo ,
#endif
desktopAppInfoGetString ,
-- ** getStringList #method:getStringList#
#if ENABLE_OVERLOADING
DesktopAppInfoGetStringListMethodInfo ,
#endif
desktopAppInfoGetStringList ,
-- ** hasKey #method:hasKey#
#if ENABLE_OVERLOADING
DesktopAppInfoHasKeyMethodInfo ,
#endif
desktopAppInfoHasKey ,
-- ** launchAction #method:launchAction#
#if ENABLE_OVERLOADING
DesktopAppInfoLaunchActionMethodInfo ,
#endif
desktopAppInfoLaunchAction ,
-- ** listActions #method:listActions#
#if ENABLE_OVERLOADING
DesktopAppInfoListActionsMethodInfo ,
#endif
desktopAppInfoListActions ,
-- ** new #method:new#
desktopAppInfoNew ,
-- ** newFromFilename #method:newFromFilename#
desktopAppInfoNewFromFilename ,
-- ** newFromKeyfile #method:newFromKeyfile#
desktopAppInfoNewFromKeyfile ,
-- ** search #method:search#
desktopAppInfoSearch ,
-- ** setDesktopEnv #method:setDesktopEnv#
desktopAppInfoSetDesktopEnv ,
-- * Properties
-- ** filename #attr:filename#
{- | The origin filename of this 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo'
-}
#if ENABLE_OVERLOADING
DesktopAppInfoFilenamePropertyInfo ,
#endif
constructDesktopAppInfoFilename ,
#if ENABLE_OVERLOADING
desktopAppInfoFilename ,
#endif
getDesktopAppInfoFilename ,
) where
import Data.GI.Base.ShortPrelude
import qualified Data.GI.Base.ShortPrelude as SP
import qualified Data.GI.Base.Overloading as O
import qualified Prelude as P
import qualified Data.GI.Base.Attributes as GI.Attributes
import qualified Data.GI.Base.ManagedPtr as B.ManagedPtr
import qualified Data.GI.Base.GClosure as B.GClosure
import qualified Data.GI.Base.GError as B.GError
import qualified Data.GI.Base.GVariant as B.GVariant
import qualified Data.GI.Base.GValue as B.GValue
import qualified Data.GI.Base.GParamSpec as B.GParamSpec
import qualified Data.GI.Base.CallStack as B.CallStack
import qualified Data.GI.Base.Properties as B.Properties
import qualified Data.Text as T
import qualified Data.ByteString.Char8 as B
import qualified Data.Map as Map
import qualified Foreign.Ptr as FP
import qualified GHC.OverloadedLabels as OL
import qualified GI.GLib.Structs.KeyFile as GLib.KeyFile
import qualified GI.GObject.Objects.Object as GObject.Object
import {-# SOURCE #-} qualified GI.Gio.Interfaces.AppInfo as Gio.AppInfo
import {-# SOURCE #-} qualified GI.Gio.Objects.AppLaunchContext as Gio.AppLaunchContext
-- | Memory-managed wrapper type.
newtype DesktopAppInfo = DesktopAppInfo (ManagedPtr DesktopAppInfo)
foreign import ccall "g_desktop_app_info_get_type"
c_g_desktop_app_info_get_type :: IO GType
instance GObject DesktopAppInfo where
gobjectType = c_g_desktop_app_info_get_type
-- | Type class for types which can be safely cast to `DesktopAppInfo`, for instance with `toDesktopAppInfo`.
class (GObject o, O.IsDescendantOf DesktopAppInfo o) => IsDesktopAppInfo o
instance (GObject o, O.IsDescendantOf DesktopAppInfo o) => IsDesktopAppInfo o
instance O.HasParentTypes DesktopAppInfo
type instance O.ParentTypes DesktopAppInfo = '[GObject.Object.Object, Gio.AppInfo.AppInfo]
-- | Cast to `DesktopAppInfo`, for types for which this is known to be safe. For general casts, use `Data.GI.Base.ManagedPtr.castTo`.
toDesktopAppInfo :: (MonadIO m, IsDesktopAppInfo o) => o -> m DesktopAppInfo
toDesktopAppInfo = liftIO . unsafeCastTo DesktopAppInfo
-- | A convenience alias for `Nothing` :: `Maybe` `DesktopAppInfo`.
noDesktopAppInfo :: Maybe DesktopAppInfo
noDesktopAppInfo = Nothing
#if ENABLE_OVERLOADING
type family ResolveDesktopAppInfoMethod (t :: Symbol) (o :: *) :: * where
ResolveDesktopAppInfoMethod "addSupportsType" o = Gio.AppInfo.AppInfoAddSupportsTypeMethodInfo
ResolveDesktopAppInfoMethod "bindProperty" o = GObject.Object.ObjectBindPropertyMethodInfo
ResolveDesktopAppInfoMethod "bindPropertyFull" o = GObject.Object.ObjectBindPropertyFullMethodInfo
ResolveDesktopAppInfoMethod "canDelete" o = Gio.AppInfo.AppInfoCanDeleteMethodInfo
ResolveDesktopAppInfoMethod "canRemoveSupportsType" o = Gio.AppInfo.AppInfoCanRemoveSupportsTypeMethodInfo
ResolveDesktopAppInfoMethod "delete" o = Gio.AppInfo.AppInfoDeleteMethodInfo
ResolveDesktopAppInfoMethod "dup" o = Gio.AppInfo.AppInfoDupMethodInfo
ResolveDesktopAppInfoMethod "equal" o = Gio.AppInfo.AppInfoEqualMethodInfo
ResolveDesktopAppInfoMethod "forceFloating" o = GObject.Object.ObjectForceFloatingMethodInfo
ResolveDesktopAppInfoMethod "freezeNotify" o = GObject.Object.ObjectFreezeNotifyMethodInfo
ResolveDesktopAppInfoMethod "getv" o = GObject.Object.ObjectGetvMethodInfo
ResolveDesktopAppInfoMethod "hasKey" o = DesktopAppInfoHasKeyMethodInfo
ResolveDesktopAppInfoMethod "isFloating" o = GObject.Object.ObjectIsFloatingMethodInfo
ResolveDesktopAppInfoMethod "launch" o = Gio.AppInfo.AppInfoLaunchMethodInfo
ResolveDesktopAppInfoMethod "launchAction" o = DesktopAppInfoLaunchActionMethodInfo
ResolveDesktopAppInfoMethod "launchUris" o = Gio.AppInfo.AppInfoLaunchUrisMethodInfo
ResolveDesktopAppInfoMethod "launchUrisAsManager" o = DesktopAppInfoLaunchUrisAsManagerMethodInfo
ResolveDesktopAppInfoMethod "launchUrisAsManagerWithFds" o = DesktopAppInfoLaunchUrisAsManagerWithFdsMethodInfo
ResolveDesktopAppInfoMethod "launchUrisAsync" o = Gio.AppInfo.AppInfoLaunchUrisAsyncMethodInfo
ResolveDesktopAppInfoMethod "launchUrisFinish" o = Gio.AppInfo.AppInfoLaunchUrisFinishMethodInfo
ResolveDesktopAppInfoMethod "listActions" o = DesktopAppInfoListActionsMethodInfo
ResolveDesktopAppInfoMethod "notify" o = GObject.Object.ObjectNotifyMethodInfo
ResolveDesktopAppInfoMethod "notifyByPspec" o = GObject.Object.ObjectNotifyByPspecMethodInfo
ResolveDesktopAppInfoMethod "ref" o = GObject.Object.ObjectRefMethodInfo
ResolveDesktopAppInfoMethod "refSink" o = GObject.Object.ObjectRefSinkMethodInfo
ResolveDesktopAppInfoMethod "removeSupportsType" o = Gio.AppInfo.AppInfoRemoveSupportsTypeMethodInfo
ResolveDesktopAppInfoMethod "runDispose" o = GObject.Object.ObjectRunDisposeMethodInfo
ResolveDesktopAppInfoMethod "shouldShow" o = Gio.AppInfo.AppInfoShouldShowMethodInfo
ResolveDesktopAppInfoMethod "stealData" o = GObject.Object.ObjectStealDataMethodInfo
ResolveDesktopAppInfoMethod "stealQdata" o = GObject.Object.ObjectStealQdataMethodInfo
ResolveDesktopAppInfoMethod "supportsFiles" o = Gio.AppInfo.AppInfoSupportsFilesMethodInfo
ResolveDesktopAppInfoMethod "supportsUris" o = Gio.AppInfo.AppInfoSupportsUrisMethodInfo
ResolveDesktopAppInfoMethod "thawNotify" o = GObject.Object.ObjectThawNotifyMethodInfo
ResolveDesktopAppInfoMethod "unref" o = GObject.Object.ObjectUnrefMethodInfo
ResolveDesktopAppInfoMethod "watchClosure" o = GObject.Object.ObjectWatchClosureMethodInfo
ResolveDesktopAppInfoMethod "getActionName" o = DesktopAppInfoGetActionNameMethodInfo
ResolveDesktopAppInfoMethod "getBoolean" o = DesktopAppInfoGetBooleanMethodInfo
ResolveDesktopAppInfoMethod "getCategories" o = DesktopAppInfoGetCategoriesMethodInfo
ResolveDesktopAppInfoMethod "getCommandline" o = Gio.AppInfo.AppInfoGetCommandlineMethodInfo
ResolveDesktopAppInfoMethod "getData" o = GObject.Object.ObjectGetDataMethodInfo
ResolveDesktopAppInfoMethod "getDescription" o = Gio.AppInfo.AppInfoGetDescriptionMethodInfo
ResolveDesktopAppInfoMethod "getDisplayName" o = Gio.AppInfo.AppInfoGetDisplayNameMethodInfo
ResolveDesktopAppInfoMethod "getExecutable" o = Gio.AppInfo.AppInfoGetExecutableMethodInfo
ResolveDesktopAppInfoMethod "getFilename" o = DesktopAppInfoGetFilenameMethodInfo
ResolveDesktopAppInfoMethod "getGenericName" o = DesktopAppInfoGetGenericNameMethodInfo
ResolveDesktopAppInfoMethod "getIcon" o = Gio.AppInfo.AppInfoGetIconMethodInfo
ResolveDesktopAppInfoMethod "getId" o = Gio.AppInfo.AppInfoGetIdMethodInfo
ResolveDesktopAppInfoMethod "getIsHidden" o = DesktopAppInfoGetIsHiddenMethodInfo
ResolveDesktopAppInfoMethod "getKeywords" o = DesktopAppInfoGetKeywordsMethodInfo
ResolveDesktopAppInfoMethod "getLocaleString" o = DesktopAppInfoGetLocaleStringMethodInfo
ResolveDesktopAppInfoMethod "getName" o = Gio.AppInfo.AppInfoGetNameMethodInfo
ResolveDesktopAppInfoMethod "getNodisplay" o = DesktopAppInfoGetNodisplayMethodInfo
ResolveDesktopAppInfoMethod "getProperty" o = GObject.Object.ObjectGetPropertyMethodInfo
ResolveDesktopAppInfoMethod "getQdata" o = GObject.Object.ObjectGetQdataMethodInfo
ResolveDesktopAppInfoMethod "getShowIn" o = DesktopAppInfoGetShowInMethodInfo
ResolveDesktopAppInfoMethod "getStartupWmClass" o = DesktopAppInfoGetStartupWmClassMethodInfo
ResolveDesktopAppInfoMethod "getString" o = DesktopAppInfoGetStringMethodInfo
ResolveDesktopAppInfoMethod "getStringList" o = DesktopAppInfoGetStringListMethodInfo
ResolveDesktopAppInfoMethod "getSupportedTypes" o = Gio.AppInfo.AppInfoGetSupportedTypesMethodInfo
ResolveDesktopAppInfoMethod "setAsDefaultForExtension" o = Gio.AppInfo.AppInfoSetAsDefaultForExtensionMethodInfo
ResolveDesktopAppInfoMethod "setAsDefaultForType" o = Gio.AppInfo.AppInfoSetAsDefaultForTypeMethodInfo
ResolveDesktopAppInfoMethod "setAsLastUsedForType" o = Gio.AppInfo.AppInfoSetAsLastUsedForTypeMethodInfo
ResolveDesktopAppInfoMethod "setData" o = GObject.Object.ObjectSetDataMethodInfo
ResolveDesktopAppInfoMethod "setProperty" o = GObject.Object.ObjectSetPropertyMethodInfo
ResolveDesktopAppInfoMethod l o = O.MethodResolutionFailed l o
instance (info ~ ResolveDesktopAppInfoMethod t DesktopAppInfo, O.MethodInfo info DesktopAppInfo p) => OL.IsLabel t (DesktopAppInfo -> p) where
#if MIN_VERSION_base(4,10,0)
fromLabel = O.overloadedMethod (O.MethodProxy :: O.MethodProxy info)
#else
fromLabel _ = O.overloadedMethod (O.MethodProxy :: O.MethodProxy info)
#endif
#endif
-- VVV Prop "filename"
-- Type: TBasicType TUTF8
-- Flags: [PropertyReadable,PropertyWritable,PropertyConstructOnly]
-- Nullable: (Nothing,Nothing)
{- |
Get the value of the “@filename@” property.
When <https://github.com/haskell-gi/haskell-gi/wiki/Overloading overloading> is enabled, this is equivalent to
@
'Data.GI.Base.Attributes.get' desktopAppInfo #filename
@
-}
getDesktopAppInfoFilename :: (MonadIO m, IsDesktopAppInfo o) => o -> m (Maybe T.Text)
getDesktopAppInfoFilename obj = liftIO $ B.Properties.getObjectPropertyString obj "filename"
{- |
Construct a `GValueConstruct` with valid value for the “@filename@” property. This is rarely needed directly, but it is used by `Data.GI.Base.Constructible.new`.
-}
constructDesktopAppInfoFilename :: (IsDesktopAppInfo o) => T.Text -> IO (GValueConstruct o)
constructDesktopAppInfoFilename val = B.Properties.constructObjectPropertyString "filename" (Just val)
#if ENABLE_OVERLOADING
data DesktopAppInfoFilenamePropertyInfo
instance AttrInfo DesktopAppInfoFilenamePropertyInfo where
type AttrAllowedOps DesktopAppInfoFilenamePropertyInfo = '[ 'AttrConstruct, 'AttrGet, 'AttrClear]
type AttrSetTypeConstraint DesktopAppInfoFilenamePropertyInfo = (~) T.Text
type AttrBaseTypeConstraint DesktopAppInfoFilenamePropertyInfo = IsDesktopAppInfo
type AttrGetType DesktopAppInfoFilenamePropertyInfo = (Maybe T.Text)
type AttrLabel DesktopAppInfoFilenamePropertyInfo = "filename"
type AttrOrigin DesktopAppInfoFilenamePropertyInfo = DesktopAppInfo
attrGet _ = getDesktopAppInfoFilename
attrSet _ = undefined
attrConstruct _ = constructDesktopAppInfoFilename
attrClear _ = undefined
#endif
#if ENABLE_OVERLOADING
instance O.HasAttributeList DesktopAppInfo
type instance O.AttributeList DesktopAppInfo = DesktopAppInfoAttributeList
type DesktopAppInfoAttributeList = ('[ '("filename", DesktopAppInfoFilenamePropertyInfo)] :: [(Symbol, *)])
#endif
#if ENABLE_OVERLOADING
desktopAppInfoFilename :: AttrLabelProxy "filename"
desktopAppInfoFilename = AttrLabelProxy
#endif
#if ENABLE_OVERLOADING
type instance O.SignalList DesktopAppInfo = DesktopAppInfoSignalList
type DesktopAppInfoSignalList = ('[ '("notify", GObject.Object.ObjectNotifySignalInfo)] :: [(Symbol, *)])
#endif
-- method DesktopAppInfo::new
-- method type : Constructor
-- Args : [Arg {argCName = "desktop_id", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the desktop file id", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}))
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_new" g_desktop_app_info_new ::
CString -> -- desktop_id : TBasicType TUTF8
IO (Ptr DesktopAppInfo)
{- |
Creates a new 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' based on a desktop file id.
A desktop file id is the basename of the desktop file, including the
.desktop extension. GIO is looking for a desktop file with this name
in the @applications@ subdirectories of the XDG
data directories (i.e. the directories specified in the @XDG_DATA_HOME@
and @XDG_DATA_DIRS@ environment variables). GIO also supports the
prefix-to-subdirectory mapping that is described in the
<http://standards.freedesktop.org/menu-spec/latest/ Menu Spec>
(i.e. a desktop id of kde-foo.desktop will match
@\/usr\/share\/applications\/kde\/foo.desktop@).
-}
desktopAppInfoNew ::
(B.CallStack.HasCallStack, MonadIO m) =>
T.Text
{- ^ /@desktopId@/: the desktop file id -}
-> m (Maybe DesktopAppInfo)
{- ^ __Returns:__ a new 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo', or 'Nothing' if no desktop
file with that id exists. -}
desktopAppInfoNew desktopId = liftIO $ do
desktopId' <- textToCString desktopId
result <- g_desktop_app_info_new desktopId'
maybeResult <- convertIfNonNull result $ \result' -> do
result'' <- (wrapObject DesktopAppInfo) result'
return result''
freeMem desktopId'
return maybeResult
#if ENABLE_OVERLOADING
#endif
-- method DesktopAppInfo::new_from_filename
-- method type : Constructor
-- Args : [Arg {argCName = "filename", argType = TBasicType TFileName, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the path of a desktop file, in the GLib\n filename encoding", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}))
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_new_from_filename" g_desktop_app_info_new_from_filename ::
CString -> -- filename : TBasicType TFileName
IO (Ptr DesktopAppInfo)
{- |
Creates a new 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo'.
-}
desktopAppInfoNewFromFilename ::
(B.CallStack.HasCallStack, MonadIO m) =>
[Char]
{- ^ /@filename@/: the path of a desktop file, in the GLib
filename encoding -}
-> m (Maybe DesktopAppInfo)
{- ^ __Returns:__ a new 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' or 'Nothing' on error. -}
desktopAppInfoNewFromFilename filename = liftIO $ do
filename' <- stringToCString filename
result <- g_desktop_app_info_new_from_filename filename'
maybeResult <- convertIfNonNull result $ \result' -> do
result'' <- (wrapObject DesktopAppInfo) result'
return result''
freeMem filename'
return maybeResult
#if ENABLE_OVERLOADING
#endif
-- method DesktopAppInfo::new_from_keyfile
-- method type : Constructor
-- Args : [Arg {argCName = "key_file", argType = TInterface (Name {namespace = "GLib", name = "KeyFile"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "an opened #GKeyFile", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}))
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_new_from_keyfile" g_desktop_app_info_new_from_keyfile ::
Ptr GLib.KeyFile.KeyFile -> -- key_file : TInterface (Name {namespace = "GLib", name = "KeyFile"})
IO (Ptr DesktopAppInfo)
{- |
Creates a new 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo'.
/Since: 2.18/
-}
desktopAppInfoNewFromKeyfile ::
(B.CallStack.HasCallStack, MonadIO m) =>
GLib.KeyFile.KeyFile
{- ^ /@keyFile@/: an opened 'GI.GLib.Structs.KeyFile.KeyFile' -}
-> m (Maybe DesktopAppInfo)
{- ^ __Returns:__ a new 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' or 'Nothing' on error. -}
desktopAppInfoNewFromKeyfile keyFile = liftIO $ do
keyFile' <- unsafeManagedPtrGetPtr keyFile
result <- g_desktop_app_info_new_from_keyfile keyFile'
maybeResult <- convertIfNonNull result $ \result' -> do
result'' <- (wrapObject DesktopAppInfo) result'
return result''
touchManagedPtr keyFile
return maybeResult
#if ENABLE_OVERLOADING
#endif
-- method DesktopAppInfo::get_action_name
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "action_name", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the name of the action as from\n g_desktop_app_info_list_actions()", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_action_name" g_desktop_app_info_get_action_name ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
CString -> -- action_name : TBasicType TUTF8
IO CString
{- |
Gets the user-visible display name of the \"additional application
action\" specified by /@actionName@/.
This corresponds to the \"Name\" key within the keyfile group for the
action.
/Since: 2.38/
-}
desktopAppInfoGetActionName ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> T.Text
{- ^ /@actionName@/: the name of the action as from
'GI.Gio.Objects.DesktopAppInfo.desktopAppInfoListActions' -}
-> m T.Text
{- ^ __Returns:__ the locale-specific action name -}
desktopAppInfoGetActionName info actionName = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
actionName' <- textToCString actionName
result <- g_desktop_app_info_get_action_name info' actionName'
checkUnexpectedReturnNULL "desktopAppInfoGetActionName" result
result' <- cstringToText result
freeMem result
touchManagedPtr info
freeMem actionName'
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetActionNameMethodInfo
instance (signature ~ (T.Text -> m T.Text), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetActionNameMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetActionName
#endif
-- method DesktopAppInfo::get_boolean
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "key", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the key to look up", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_boolean" g_desktop_app_info_get_boolean ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
CString -> -- key : TBasicType TUTF8
IO CInt
{- |
Looks up a boolean value in the keyfile backing /@info@/.
The /@key@/ is looked up in the \"Desktop Entry\" group.
/Since: 2.36/
-}
desktopAppInfoGetBoolean ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> T.Text
{- ^ /@key@/: the key to look up -}
-> m Bool
{- ^ __Returns:__ the boolean value, or 'False' if the key
is not found -}
desktopAppInfoGetBoolean info key = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
key' <- textToCString key
result <- g_desktop_app_info_get_boolean info' key'
let result' = (/= 0) result
touchManagedPtr info
freeMem key'
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetBooleanMethodInfo
instance (signature ~ (T.Text -> m Bool), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetBooleanMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetBoolean
#endif
-- method DesktopAppInfo::get_categories
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_categories" g_desktop_app_info_get_categories ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
IO CString
{- |
Gets the categories from the desktop file.
-}
desktopAppInfoGetCategories ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> m T.Text
{- ^ __Returns:__ The unparsed Categories key from the desktop file;
i.e. no attempt is made to split it by \';\' or validate it. -}
desktopAppInfoGetCategories info = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
result <- g_desktop_app_info_get_categories info'
checkUnexpectedReturnNULL "desktopAppInfoGetCategories" result
result' <- cstringToText result
touchManagedPtr info
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetCategoriesMethodInfo
instance (signature ~ (m T.Text), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetCategoriesMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetCategories
#endif
-- method DesktopAppInfo::get_filename
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TFileName)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_filename" g_desktop_app_info_get_filename ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
IO CString
{- |
When /@info@/ was created from a known filename, return it. In some
situations such as the 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' returned from
'GI.Gio.Objects.DesktopAppInfo.desktopAppInfoNewFromKeyfile', this function will return 'Nothing'.
/Since: 2.24/
-}
desktopAppInfoGetFilename ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> m [Char]
{- ^ __Returns:__ The full path to the file for /@info@/,
or 'Nothing' if not known. -}
desktopAppInfoGetFilename info = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
result <- g_desktop_app_info_get_filename info'
checkUnexpectedReturnNULL "desktopAppInfoGetFilename" result
result' <- cstringToString result
touchManagedPtr info
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetFilenameMethodInfo
instance (signature ~ (m [Char]), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetFilenameMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetFilename
#endif
-- method DesktopAppInfo::get_generic_name
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_generic_name" g_desktop_app_info_get_generic_name ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
IO CString
{- |
Gets the generic name from the destkop file.
-}
desktopAppInfoGetGenericName ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> m T.Text
{- ^ __Returns:__ The value of the GenericName key -}
desktopAppInfoGetGenericName info = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
result <- g_desktop_app_info_get_generic_name info'
checkUnexpectedReturnNULL "desktopAppInfoGetGenericName" result
result' <- cstringToText result
touchManagedPtr info
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetGenericNameMethodInfo
instance (signature ~ (m T.Text), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetGenericNameMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetGenericName
#endif
-- method DesktopAppInfo::get_is_hidden
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_is_hidden" g_desktop_app_info_get_is_hidden ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
IO CInt
{- |
A desktop file is hidden if the Hidden key in it is
set to True.
-}
desktopAppInfoGetIsHidden ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo'. -}
-> m Bool
{- ^ __Returns:__ 'True' if hidden, 'False' otherwise. -}
desktopAppInfoGetIsHidden info = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
result <- g_desktop_app_info_get_is_hidden info'
let result' = (/= 0) result
touchManagedPtr info
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetIsHiddenMethodInfo
instance (signature ~ (m Bool), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetIsHiddenMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetIsHidden
#endif
-- method DesktopAppInfo::get_keywords
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TCArray True (-1) (-1) (TBasicType TUTF8))
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_keywords" g_desktop_app_info_get_keywords ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
IO (Ptr CString)
{- |
Gets the keywords from the desktop file.
/Since: 2.32/
-}
desktopAppInfoGetKeywords ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> m [T.Text]
{- ^ __Returns:__ The value of the Keywords key -}
desktopAppInfoGetKeywords info = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
result <- g_desktop_app_info_get_keywords info'
checkUnexpectedReturnNULL "desktopAppInfoGetKeywords" result
result' <- unpackZeroTerminatedUTF8CArray result
touchManagedPtr info
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetKeywordsMethodInfo
instance (signature ~ (m [T.Text]), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetKeywordsMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetKeywords
#endif
-- method DesktopAppInfo::get_locale_string
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "key", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the key to look up", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_locale_string" g_desktop_app_info_get_locale_string ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
CString -> -- key : TBasicType TUTF8
IO CString
{- |
Looks up a localized string value in the keyfile backing /@info@/
translated to the current locale.
The /@key@/ is looked up in the \"Desktop Entry\" group.
/Since: 2.56/
-}
desktopAppInfoGetLocaleString ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> T.Text
{- ^ /@key@/: the key to look up -}
-> m (Maybe T.Text)
{- ^ __Returns:__ a newly allocated string, or 'Nothing' if the key
is not found -}
desktopAppInfoGetLocaleString info key = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
key' <- textToCString key
result <- g_desktop_app_info_get_locale_string info' key'
maybeResult <- convertIfNonNull result $ \result' -> do
result'' <- cstringToText result'
freeMem result'
return result''
touchManagedPtr info
freeMem key'
return maybeResult
#if ENABLE_OVERLOADING
data DesktopAppInfoGetLocaleStringMethodInfo
instance (signature ~ (T.Text -> m (Maybe T.Text)), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetLocaleStringMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetLocaleString
#endif
-- method DesktopAppInfo::get_nodisplay
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_nodisplay" g_desktop_app_info_get_nodisplay ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
IO CInt
{- |
Gets the value of the NoDisplay key, which helps determine if the
application info should be shown in menus. See
'GI.GLib.Constants.KEY_FILE_DESKTOP_KEY_NO_DISPLAY' and 'GI.Gio.Interfaces.AppInfo.appInfoShouldShow'.
/Since: 2.30/
-}
desktopAppInfoGetNodisplay ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> m Bool
{- ^ __Returns:__ The value of the NoDisplay key -}
desktopAppInfoGetNodisplay info = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
result <- g_desktop_app_info_get_nodisplay info'
let result' = (/= 0) result
touchManagedPtr info
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetNodisplayMethodInfo
instance (signature ~ (m Bool), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetNodisplayMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetNodisplay
#endif
-- method DesktopAppInfo::get_show_in
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "desktop_env", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a string specifying a desktop name", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_show_in" g_desktop_app_info_get_show_in ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
CString -> -- desktop_env : TBasicType TUTF8
IO CInt
{- |
Checks if the application info should be shown in menus that list available
applications for a specific name of the desktop, based on the
@OnlyShowIn@ and @NotShowIn@ keys.
/@desktopEnv@/ should typically be given as 'Nothing', in which case the
@XDG_CURRENT_DESKTOP@ environment variable is consulted. If you want
to override the default mechanism then you may specify /@desktopEnv@/,
but this is not recommended.
Note that 'GI.Gio.Interfaces.AppInfo.appInfoShouldShow' for /@info@/ will include this check (with
'Nothing' for /@desktopEnv@/) as well as additional checks.
/Since: 2.30/
-}
desktopAppInfoGetShowIn ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> Maybe (T.Text)
{- ^ /@desktopEnv@/: a string specifying a desktop name -}
-> m Bool
{- ^ __Returns:__ 'True' if the /@info@/ should be shown in /@desktopEnv@/ according to the
@OnlyShowIn@ and @NotShowIn@ keys, 'False'
otherwise. -}
desktopAppInfoGetShowIn info desktopEnv = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
maybeDesktopEnv <- case desktopEnv of
Nothing -> return nullPtr
Just jDesktopEnv -> do
jDesktopEnv' <- textToCString jDesktopEnv
return jDesktopEnv'
result <- g_desktop_app_info_get_show_in info' maybeDesktopEnv
let result' = (/= 0) result
touchManagedPtr info
freeMem maybeDesktopEnv
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetShowInMethodInfo
instance (signature ~ (Maybe (T.Text) -> m Bool), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetShowInMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetShowIn
#endif
-- method DesktopAppInfo::get_startup_wm_class
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo that supports startup notify", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_startup_wm_class" g_desktop_app_info_get_startup_wm_class ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
IO CString
{- |
Retrieves the StartupWMClass field from /@info@/. This represents the
WM_CLASS property of the main window of the application, if launched
through /@info@/.
/Since: 2.34/
-}
desktopAppInfoGetStartupWmClass ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' that supports startup notify -}
-> m T.Text
{- ^ __Returns:__ the startup WM class, or 'Nothing' if none is set
in the desktop file. -}
desktopAppInfoGetStartupWmClass info = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
result <- g_desktop_app_info_get_startup_wm_class info'
checkUnexpectedReturnNULL "desktopAppInfoGetStartupWmClass" result
result' <- cstringToText result
touchManagedPtr info
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetStartupWmClassMethodInfo
instance (signature ~ (m T.Text), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetStartupWmClassMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetStartupWmClass
#endif
-- method DesktopAppInfo::get_string
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "key", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the key to look up", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_string" g_desktop_app_info_get_string ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
CString -> -- key : TBasicType TUTF8
IO CString
{- |
Looks up a string value in the keyfile backing /@info@/.
The /@key@/ is looked up in the \"Desktop Entry\" group.
/Since: 2.36/
-}
desktopAppInfoGetString ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> T.Text
{- ^ /@key@/: the key to look up -}
-> m T.Text
{- ^ __Returns:__ a newly allocated string, or 'Nothing' if the key
is not found -}
desktopAppInfoGetString info key = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
key' <- textToCString key
result <- g_desktop_app_info_get_string info' key'
checkUnexpectedReturnNULL "desktopAppInfoGetString" result
result' <- cstringToText result
freeMem result
touchManagedPtr info
freeMem key'
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoGetStringMethodInfo
instance (signature ~ (T.Text -> m T.Text), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetStringMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetString
#endif
-- method DesktopAppInfo::get_string_list
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "key", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the key to look up", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "length", argType = TBasicType TUInt64, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "return location for the number of returned strings, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- Lengths : []
-- returnType : Just (TCArray True (-1) 2 (TBasicType TUTF8))
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_string_list" g_desktop_app_info_get_string_list ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
CString -> -- key : TBasicType TUTF8
Ptr Word64 -> -- length : TBasicType TUInt64
IO (Ptr CString)
{- |
Looks up a string list value in the keyfile backing /@info@/.
The /@key@/ is looked up in the \"Desktop Entry\" group.
/Since: 2.60.0/
-}
desktopAppInfoGetStringList ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> T.Text
{- ^ /@key@/: the key to look up -}
-> m (([T.Text], Word64))
{- ^ __Returns:__
a 'Nothing'-terminated string array or 'Nothing' if the specified
key cannot be found. The array should be freed with 'GI.GLib.Functions.strfreev'. -}
desktopAppInfoGetStringList info key = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
key' <- textToCString key
length_ <- allocMem :: IO (Ptr Word64)
result <- g_desktop_app_info_get_string_list info' key' length_
checkUnexpectedReturnNULL "desktopAppInfoGetStringList" result
result' <- unpackZeroTerminatedUTF8CArray result
mapZeroTerminatedCArray freeMem result
freeMem result
length_' <- peek length_
touchManagedPtr info
freeMem key'
freeMem length_
return (result', length_')
#if ENABLE_OVERLOADING
data DesktopAppInfoGetStringListMethodInfo
instance (signature ~ (T.Text -> m (([T.Text], Word64))), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoGetStringListMethodInfo a signature where
overloadedMethod _ = desktopAppInfoGetStringList
#endif
-- method DesktopAppInfo::has_key
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "key", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the key to look up", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_has_key" g_desktop_app_info_has_key ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
CString -> -- key : TBasicType TUTF8
IO CInt
{- |
Returns whether /@key@/ exists in the \"Desktop Entry\" group
of the keyfile backing /@info@/.
/Since: 2.36/
-}
desktopAppInfoHasKey ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> T.Text
{- ^ /@key@/: the key to look up -}
-> m Bool
{- ^ __Returns:__ 'True' if the /@key@/ exists -}
desktopAppInfoHasKey info key = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
key' <- textToCString key
result <- g_desktop_app_info_has_key info' key'
let result' = (/= 0) result
touchManagedPtr info
freeMem key'
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoHasKeyMethodInfo
instance (signature ~ (T.Text -> m Bool), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoHasKeyMethodInfo a signature where
overloadedMethod _ = desktopAppInfoHasKey
#endif
-- method DesktopAppInfo::launch_action
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "action_name", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the name of the action as from\n g_desktop_app_info_list_actions()", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "launch_context", argType = TInterface (Name {namespace = "Gio", name = "AppLaunchContext"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a #GAppLaunchContext", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_launch_action" g_desktop_app_info_launch_action ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
CString -> -- action_name : TBasicType TUTF8
Ptr Gio.AppLaunchContext.AppLaunchContext -> -- launch_context : TInterface (Name {namespace = "Gio", name = "AppLaunchContext"})
IO ()
{- |
Activates the named application action.
You may only call this function on action names that were
returned from 'GI.Gio.Objects.DesktopAppInfo.desktopAppInfoListActions'.
Note that if the main entry of the desktop file indicates that the
application supports startup notification, and /@launchContext@/ is
non-'Nothing', then startup notification will be used when activating the
action (and as such, invocation of the action on the receiving side
must signal the end of startup notification when it is completed).
This is the expected behaviour of applications declaring additional
actions, as per the desktop file specification.
As with 'GI.Gio.Interfaces.AppInfo.appInfoLaunch' there is no way to detect failures that
occur while using this function.
/Since: 2.38/
-}
desktopAppInfoLaunchAction ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a, Gio.AppLaunchContext.IsAppLaunchContext b) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> T.Text
{- ^ /@actionName@/: the name of the action as from
'GI.Gio.Objects.DesktopAppInfo.desktopAppInfoListActions' -}
-> Maybe (b)
{- ^ /@launchContext@/: a 'GI.Gio.Objects.AppLaunchContext.AppLaunchContext' -}
-> m ()
desktopAppInfoLaunchAction info actionName launchContext = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
actionName' <- textToCString actionName
maybeLaunchContext <- case launchContext of
Nothing -> return nullPtr
Just jLaunchContext -> do
jLaunchContext' <- unsafeManagedPtrCastPtr jLaunchContext
return jLaunchContext'
g_desktop_app_info_launch_action info' actionName' maybeLaunchContext
touchManagedPtr info
whenJust launchContext touchManagedPtr
freeMem actionName'
return ()
#if ENABLE_OVERLOADING
data DesktopAppInfoLaunchActionMethodInfo
instance (signature ~ (T.Text -> Maybe (b) -> m ()), MonadIO m, IsDesktopAppInfo a, Gio.AppLaunchContext.IsAppLaunchContext b) => O.MethodInfo DesktopAppInfoLaunchActionMethodInfo a signature where
overloadedMethod _ = desktopAppInfoLaunchAction
#endif
-- XXX Could not generate method DesktopAppInfo::launch_uris_as_manager
-- Error was : Bad introspection data: "Closure not found! Callable\n { returnType = Just (TBasicType TBoolean)\n , returnMayBeNull = False\n , returnTransfer = TransferNothing\n , returnDocumentation =\n Documentation\n { rawDocText = Just \"%TRUE on successful launch, %FALSE otherwise.\"\n , sinceVersion = Nothing\n }\n , args =\n [ Arg\n { argCName = \"appinfo\"\n , argType =\n TInterface Name { namespace = \"Gio\" , name = \"DesktopAppInfo\" }\n , direction = DirectionIn\n , mayBeNull = False\n , argDoc =\n Documentation\n { rawDocText = Just \"a #GDesktopAppInfo\" , sinceVersion = Nothing }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"uris\"\n , argType = TGList (TBasicType TUTF8)\n , direction = DirectionIn\n , mayBeNull = False\n , argDoc =\n Documentation\n { rawDocText = Just \"List of URIs\" , sinceVersion = Nothing }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"launch_context\"\n , argType =\n TInterface Name { namespace = \"Gio\" , name = \"AppLaunchContext\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"a #GAppLaunchContext\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"spawn_flags\"\n , argType =\n TInterface Name { namespace = \"GLib\" , name = \"SpawnFlags\" }\n , direction = DirectionIn\n , mayBeNull = False\n , argDoc =\n Documentation\n { rawDocText = Just \"#GSpawnFlags, used for each process\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"user_setup\"\n , argType =\n TInterface\n Name { namespace = \"GLib\" , name = \"SpawnChildSetupFunc\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText =\n Just \"a #GSpawnChildSetupFunc, used once\\n for each process.\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeAsync\n , argClosure = 5\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"user_setup_data\"\n , argType = TBasicType TPtr\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"User data for @user_setup\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = 4\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"pid_callback\"\n , argType =\n TInterface\n Name { namespace = \"Gio\" , name = \"DesktopAppLaunchCallback\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"Callback for child processes\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeCall\n , argClosure = 7\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"pid_callback_data\"\n , argType = TBasicType TPtr\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"User data for @callback\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = 6\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n ]\n , skipReturn = False\n , callableThrows = True\n , callableDeprecated = Nothing\n , callableDocumentation =\n Documentation\n { rawDocText =\n Just\n \"This function performs the equivalent of g_app_info_launch_uris(),\\nbut is intended primarily for operating system components that\\nlaunch applications. Ordinary applications should use\\ng_app_info_launch_uris().\\n\\nIf the application is launched via GSpawn, then @spawn_flags, @user_setup\\nand @user_setup_data are used for the call to g_spawn_async().\\nAdditionally, @pid_callback (with @pid_callback_data) will be called to\\ninform about the PID of the created process. See g_spawn_async_with_pipes()\\nfor information on certain parameter conditions that can enable an\\noptimized posix_spawn() codepath to be used.\\n\\nIf application launching occurs via some other mechanism (eg: D-Bus\\nactivation) then @spawn_flags, @user_setup, @user_setup_data,\\n@pid_callback and @pid_callback_data are ignored.\"\n , sinceVersion = Nothing\n }\n }\nfromList\n [ ( 5\n , Arg\n { argCName = \"user_setup\"\n , argType =\n TInterface\n Name { namespace = \"GLib\" , name = \"SpawnChildSetupFunc\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText =\n Just \"a #GSpawnChildSetupFunc, used once\\n for each process.\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeAsync\n , argClosure = 5\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n )\n , ( 7\n , Arg\n { argCName = \"pid_callback\"\n , argType =\n TInterface\n Name { namespace = \"Gio\" , name = \"DesktopAppLaunchCallback\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"Callback for child processes\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeCall\n , argClosure = 7\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n )\n ]\n4"
#if ENABLE_OVERLOADING
-- XXX: Dummy instance, since code generation failed.
-- Please file a bug at http://github.com/haskell-gi/haskell-gi.
data DesktopAppInfoLaunchUrisAsManagerMethodInfo
instance (p ~ (), o ~ O.MethodResolutionFailed "launchUrisAsManager" DesktopAppInfo) => O.MethodInfo DesktopAppInfoLaunchUrisAsManagerMethodInfo o p where
overloadedMethod _ = undefined
#endif
-- XXX Could not generate method DesktopAppInfo::launch_uris_as_manager_with_fds
-- Error was : Bad introspection data: "Closure not found! Callable\n { returnType = Just (TBasicType TBoolean)\n , returnMayBeNull = False\n , returnTransfer = TransferNothing\n , returnDocumentation =\n Documentation\n { rawDocText = Just \"%TRUE on successful launch, %FALSE otherwise.\"\n , sinceVersion = Nothing\n }\n , args =\n [ Arg\n { argCName = \"appinfo\"\n , argType =\n TInterface Name { namespace = \"Gio\" , name = \"DesktopAppInfo\" }\n , direction = DirectionIn\n , mayBeNull = False\n , argDoc =\n Documentation\n { rawDocText = Just \"a #GDesktopAppInfo\" , sinceVersion = Nothing }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"uris\"\n , argType = TGList (TBasicType TUTF8)\n , direction = DirectionIn\n , mayBeNull = False\n , argDoc =\n Documentation\n { rawDocText = Just \"List of URIs\" , sinceVersion = Nothing }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"launch_context\"\n , argType =\n TInterface Name { namespace = \"Gio\" , name = \"AppLaunchContext\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"a #GAppLaunchContext\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"spawn_flags\"\n , argType =\n TInterface Name { namespace = \"GLib\" , name = \"SpawnFlags\" }\n , direction = DirectionIn\n , mayBeNull = False\n , argDoc =\n Documentation\n { rawDocText = Just \"#GSpawnFlags, used for each process\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"user_setup\"\n , argType =\n TInterface\n Name { namespace = \"GLib\" , name = \"SpawnChildSetupFunc\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText =\n Just \"a #GSpawnChildSetupFunc, used once\\n for each process.\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeAsync\n , argClosure = 5\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"user_setup_data\"\n , argType = TBasicType TPtr\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"User data for @user_setup\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = 4\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"pid_callback\"\n , argType =\n TInterface\n Name { namespace = \"Gio\" , name = \"DesktopAppLaunchCallback\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"Callback for child processes\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeCall\n , argClosure = 7\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"pid_callback_data\"\n , argType = TBasicType TPtr\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"User data for @callback\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = 6\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"stdin_fd\"\n , argType = TBasicType TInt\n , direction = DirectionIn\n , mayBeNull = False\n , argDoc =\n Documentation\n { rawDocText =\n Just \"file descriptor to use for child's stdin, or -1\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"stdout_fd\"\n , argType = TBasicType TInt\n , direction = DirectionIn\n , mayBeNull = False\n , argDoc =\n Documentation\n { rawDocText =\n Just \"file descriptor to use for child's stdout, or -1\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n , Arg\n { argCName = \"stderr_fd\"\n , argType = TBasicType TInt\n , direction = DirectionIn\n , mayBeNull = False\n , argDoc =\n Documentation\n { rawDocText =\n Just \"file descriptor to use for child's stderr, or -1\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeInvalid\n , argClosure = -1\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n ]\n , skipReturn = False\n , callableThrows = True\n , callableDeprecated = Nothing\n , callableDocumentation =\n Documentation\n { rawDocText =\n Just\n \"Equivalent to g_desktop_app_info_launch_uris_as_manager() but allows\\nyou to pass in file descriptors for the stdin, stdout and stderr streams\\nof the launched process.\\n\\nIf application launching occurs via some non-spawn mechanism (e.g. D-Bus\\nactivation) then @stdin_fd, @stdout_fd and @stderr_fd are ignored.\"\n , sinceVersion = Just \"2.58\"\n }\n }\nfromList\n [ ( 5\n , Arg\n { argCName = \"user_setup\"\n , argType =\n TInterface\n Name { namespace = \"GLib\" , name = \"SpawnChildSetupFunc\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText =\n Just \"a #GSpawnChildSetupFunc, used once\\n for each process.\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeAsync\n , argClosure = 5\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n )\n , ( 7\n , Arg\n { argCName = \"pid_callback\"\n , argType =\n TInterface\n Name { namespace = \"Gio\" , name = \"DesktopAppLaunchCallback\" }\n , direction = DirectionIn\n , mayBeNull = True\n , argDoc =\n Documentation\n { rawDocText = Just \"Callback for child processes\"\n , sinceVersion = Nothing\n }\n , argScope = ScopeTypeCall\n , argClosure = 7\n , argDestroy = -1\n , argCallerAllocates = False\n , transfer = TransferNothing\n }\n )\n ]\n4"
#if ENABLE_OVERLOADING
-- XXX: Dummy instance, since code generation failed.
-- Please file a bug at http://github.com/haskell-gi/haskell-gi.
data DesktopAppInfoLaunchUrisAsManagerWithFdsMethodInfo
instance (p ~ (), o ~ O.MethodResolutionFailed "launchUrisAsManagerWithFds" DesktopAppInfo) => O.MethodInfo DesktopAppInfoLaunchUrisAsManagerWithFdsMethodInfo o p where
overloadedMethod _ = undefined
#endif
-- method DesktopAppInfo::list_actions
-- method type : OrdinaryMethod
-- Args : [Arg {argCName = "info", argType = TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDesktopAppInfo", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TCArray True (-1) (-1) (TBasicType TUTF8))
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_list_actions" g_desktop_app_info_list_actions ::
Ptr DesktopAppInfo -> -- info : TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})
IO (Ptr CString)
{- |
Returns the list of \"additional application actions\" supported on the
desktop file, as per the desktop file specification.
As per the specification, this is the list of actions that are
explicitly listed in the \"Actions\" key of the [Desktop Entry] group.
/Since: 2.38/
-}
desktopAppInfoListActions ::
(B.CallStack.HasCallStack, MonadIO m, IsDesktopAppInfo a) =>
a
{- ^ /@info@/: a 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo' -}
-> m [T.Text]
{- ^ __Returns:__ a list of strings, always non-'Nothing' -}
desktopAppInfoListActions info = liftIO $ do
info' <- unsafeManagedPtrCastPtr info
result <- g_desktop_app_info_list_actions info'
checkUnexpectedReturnNULL "desktopAppInfoListActions" result
result' <- unpackZeroTerminatedUTF8CArray result
touchManagedPtr info
return result'
#if ENABLE_OVERLOADING
data DesktopAppInfoListActionsMethodInfo
instance (signature ~ (m [T.Text]), MonadIO m, IsDesktopAppInfo a) => O.MethodInfo DesktopAppInfoListActionsMethodInfo a signature where
overloadedMethod _ = desktopAppInfoListActions
#endif
-- method DesktopAppInfo::get_implementations
-- method type : MemberFunction
-- Args : [Arg {argCName = "interface", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the name of the interface", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TGList (TInterface (Name {namespace = "Gio", name = "DesktopAppInfo"})))
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_get_implementations" g_desktop_app_info_get_implementations ::
CString -> -- interface : TBasicType TUTF8
IO (Ptr (GList (Ptr DesktopAppInfo)))
{- |
Gets all applications that implement /@interface@/.
An application implements an interface if that interface is listed in
the Implements= line of the desktop file of the application.
/Since: 2.42/
-}
desktopAppInfoGetImplementations ::
(B.CallStack.HasCallStack, MonadIO m) =>
T.Text
{- ^ /@interface@/: the name of the interface -}
-> m [DesktopAppInfo]
{- ^ __Returns:__ a list of 'GI.Gio.Objects.DesktopAppInfo.DesktopAppInfo'
objects. -}
desktopAppInfoGetImplementations interface = liftIO $ do
interface' <- textToCString interface
result <- g_desktop_app_info_get_implementations interface'
result' <- unpackGList result
result'' <- mapM (wrapObject DesktopAppInfo) result'
g_list_free result
freeMem interface'
return result''
#if ENABLE_OVERLOADING
#endif
-- method DesktopAppInfo::search
-- method type : MemberFunction
-- Args : [Arg {argCName = "search_string", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the search string to use", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TCArray True (-1) (-1) (TCArray True (-1) (-1) (TBasicType TUTF8)))
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_search" g_desktop_app_info_search ::
CString -> -- search_string : TBasicType TUTF8
IO (Ptr (Ptr CString))
{- |
Searches desktop files for ones that match /@searchString@/.
The return value is an array of strvs. Each strv contains a list of
applications that matched /@searchString@/ with an equal score. The
outer list is sorted by score so that the first strv contains the
best-matching applications, and so on.
The algorithm for determining matches is undefined and may change at
any time.
-}
desktopAppInfoSearch ::
(B.CallStack.HasCallStack, MonadIO m) =>
T.Text
{- ^ /@searchString@/: the search string to use -}
-> m [[T.Text]]
{- ^ __Returns:__ a
list of strvs. Free each item with 'GI.GLib.Functions.strfreev' and free the outer
list with 'GI.GLib.Functions.free'. -}
desktopAppInfoSearch searchString = liftIO $ do
searchString' <- textToCString searchString
result <- g_desktop_app_info_search searchString'
checkUnexpectedReturnNULL "desktopAppInfoSearch" result
result' <- unpackZeroTerminatedPtrArray result
result'' <- mapM unpackZeroTerminatedUTF8CArray result'
let freeElemOfResult e = mapZeroTerminatedCArray freeMem e >> freeMem e
mapZeroTerminatedCArray freeElemOfResult result
freeMem result
freeMem searchString'
return result''
#if ENABLE_OVERLOADING
#endif
-- method DesktopAppInfo::set_desktop_env
-- method type : MemberFunction
-- Args : [Arg {argCName = "desktop_env", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a string specifying what desktop this is", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False
foreign import ccall "g_desktop_app_info_set_desktop_env" g_desktop_app_info_set_desktop_env ::
CString -> -- desktop_env : TBasicType TUTF8
IO ()
{-# DEPRECATED desktopAppInfoSetDesktopEnv ["(Since version 2.42)","do not use this API. Since 2.42 the value of the","@XDG_CURRENT_DESKTOP@ environment variable will be used."] #-}
{- |
Sets the name of the desktop that the application is running in.
This is used by 'GI.Gio.Interfaces.AppInfo.appInfoShouldShow' and
'GI.Gio.Objects.DesktopAppInfo.desktopAppInfoGetShowIn' to evaluate the
@OnlyShowIn@ and @NotShowIn@
desktop entry fields.
Should be called only once; subsequent calls are ignored.
-}
desktopAppInfoSetDesktopEnv ::
(B.CallStack.HasCallStack, MonadIO m) =>
T.Text
{- ^ /@desktopEnv@/: a string specifying what desktop this is -}
-> m ()
desktopAppInfoSetDesktopEnv desktopEnv = liftIO $ do
desktopEnv' <- textToCString desktopEnv
g_desktop_app_info_set_desktop_env desktopEnv'
freeMem desktopEnv'
return ()
#if ENABLE_OVERLOADING
#endif