GI.Gtk.Interfaces.AppChooser

AppChooser is an interface that can be implemented by widgets which allow the user to choose an application (typically for the purpose of opening a file). The main objects that implement this interface are AppChooserWidget, AppChooserDialog and AppChooserButton.

Applications are represented by GIO AppInfo objects here. GIO has a concept of recommended and fallback applications for a given content type. Recommended applications are those that claim to handle the content type itself, while fallback also includes applications that handle a more generic content type. GIO also knows the default and last-used application for a given content type. The AppChooserWidget provides detailed control over whether the shown list of applications should include default, recommended or fallback applications.

To obtain the application that has been selected in a AppChooser, use appChooserGetAppInfo.

Exported types

newtype AppChooser

Constructors

AppChooser (ManagedPtr AppChooser)

Instances

GObject AppChooser

Methods

gobjectType :: AppChooser -> IO GType

IsObject AppChooser

IsWidget AppChooser

IsAppChooser AppChooser

((~) * info (ResolveAppChooserMethod t AppChooser), MethodInfo * info AppChooser p) => IsLabel t (AppChooser -> p)

Methods

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

((~) * info (ResolveAppChooserMethod t AppChooser), MethodInfo * info AppChooser p) => IsLabelProxy t (AppChooser -> p)

Methods

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

HasAttributeList * AppChooser

type AttributeList AppChooser

type AttributeList AppChooser

type SignalList AppChooser

type SignalList AppChooser

noAppChooser :: Maybe AppChooser

class GObject o => IsAppChooser o

Instances

(GObject a, UnknownAncestorError Constraint AppChooser a) => IsAppChooser a

IsAppChooser AppChooser

IsAppChooser AppChooserButton

IsAppChooser AppChooserWidget

IsAppChooser AppChooserDialog

toAppChooser :: IsAppChooser o => o -> IO AppChooser

Methods

getAppInfo

data AppChooserGetAppInfoMethodInfo

Instances

((~) * signature (m (Maybe AppInfo)), MonadIO m, IsAppChooser a) => MethodInfo * AppChooserGetAppInfoMethodInfo a signature

Methods

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

appChooserGetAppInfo

Arguments

:: (HasCallStack, MonadIO m, IsAppChooser a)

=> a

self: a AppChooser

-> m (Maybe AppInfo)

Returns: a AppInfo for the currently selected application, or Nothing if none is selected. Free with objectUnref

Returns the currently selected application.

Since: 3.0

getContentType

data AppChooserGetContentTypeMethodInfo

Instances

((~) * signature (m Text), MonadIO m, IsAppChooser a) => MethodInfo * AppChooserGetContentTypeMethodInfo a signature

Methods

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

appChooserGetContentType

Arguments

:: (HasCallStack, MonadIO m, IsAppChooser a)

=> a

self: a AppChooser

-> m Text

Returns: the content type of self. Free with free

Returns the current value of the AppChooser:content-type property.

Since: 3.0

refresh

data AppChooserRefreshMethodInfo

Instances

((~) * signature (m ()), MonadIO m, IsAppChooser a) => MethodInfo * AppChooserRefreshMethodInfo a signature

Methods

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

appChooserRefresh

Arguments

:: (HasCallStack, MonadIO m, IsAppChooser a)

=> a

self: a AppChooser

-> m ()

Reloads the list of applications.

Since: 3.0

Properties

contentType

data AppChooserContentTypePropertyInfo

Instances

AttrInfo AppChooserContentTypePropertyInfo

Associated Types

type AttrAllowedOps AppChooserContentTypePropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint AppChooserContentTypePropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint AppChooserContentTypePropertyInfo :: * -> Constraint

type AttrGetType AppChooserContentTypePropertyInfo :: *

type AttrLabel AppChooserContentTypePropertyInfo :: Symbol

type AttrOrigin AppChooserContentTypePropertyInfo :: *

Methods

attrGet :: AttrBaseTypeConstraint AppChooserContentTypePropertyInfo o => Proxy * AppChooserContentTypePropertyInfo -> o -> IO (AttrGetType AppChooserContentTypePropertyInfo)

attrSet :: (AttrBaseTypeConstraint AppChooserContentTypePropertyInfo o, AttrSetTypeConstraint AppChooserContentTypePropertyInfo b) => Proxy * AppChooserContentTypePropertyInfo -> o -> b -> IO ()

attrClear :: AttrBaseTypeConstraint AppChooserContentTypePropertyInfo o => Proxy * AppChooserContentTypePropertyInfo -> o -> IO ()

attrConstruct :: (AttrBaseTypeConstraint AppChooserContentTypePropertyInfo o, AttrSetTypeConstraint AppChooserContentTypePropertyInfo b) => Proxy * AppChooserContentTypePropertyInfo -> b -> IO (GValueConstruct o)

type AttrOrigin AppChooserContentTypePropertyInfo

type AttrOrigin AppChooserContentTypePropertyInfo = AppChooser

type AttrLabel AppChooserContentTypePropertyInfo

type AttrLabel AppChooserContentTypePropertyInfo = "content-type"

type AttrGetType AppChooserContentTypePropertyInfo

type AttrGetType AppChooserContentTypePropertyInfo = Maybe Text

type AttrBaseTypeConstraint AppChooserContentTypePropertyInfo

type AttrBaseTypeConstraint AppChooserContentTypePropertyInfo = IsAppChooser

type AttrSetTypeConstraint AppChooserContentTypePropertyInfo

type AttrSetTypeConstraint AppChooserContentTypePropertyInfo = * ~ Text

type AttrAllowedOps AppChooserContentTypePropertyInfo

type AttrAllowedOps AppChooserContentTypePropertyInfo = (:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ((:) AttrOpTag AttrClear ([] AttrOpTag)))

appChooserContentType :: AttrLabelProxy "contentType"

constructAppChooserContentType :: IsAppChooser o => Text -> IO (GValueConstruct o)

getAppChooserContentType :: (MonadIO m, IsAppChooser o) => o -> m (Maybe Text)