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

Memory-managed wrapper type.

Constructors

AppChooser (ManagedPtr AppChooser)

Instances

Eq AppChooser

Defined in GI.Gtk.Interfaces.AppChooser

Methods

(==) :: AppChooser -> AppChooser -> Bool

(/=) :: AppChooser -> AppChooser -> Bool

IsGValue AppChooser

Convert AppChooser to and from GValue with toGValue and fromGValue.

Defined in GI.Gtk.Interfaces.AppChooser

Methods

toGValue :: AppChooser -> IO GValue

fromGValue :: GValue -> IO AppChooser

GObject AppChooser

Defined in GI.Gtk.Interfaces.AppChooser

Methods

gobjectType :: IO GType

HasParentTypes AppChooser

Defined in GI.Gtk.Interfaces.AppChooser

type ParentTypes AppChooser

Defined in GI.Gtk.Interfaces.AppChooser

type ParentTypes AppChooser = '[Object, Widget]

noAppChooser :: Maybe AppChooser

A convenience alias for Nothing :: Maybe AppChooser.

class (GObject o, IsDescendantOf AppChooser o) => IsAppChooser o

Type class for types which can be safely cast to AppChooser, for instance with toAppChooser.

Instances

(GObject o, IsDescendantOf AppChooser o) => IsAppChooser o

Defined in GI.Gtk.Interfaces.AppChooser

toAppChooser :: (MonadIO m, IsAppChooser o) => o -> m AppChooser

Cast to AppChooser, for types for which this is known to be safe. For general casts, use castTo.

Methods

Overloaded methods

getAppInfo

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

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

appChooserRefresh

Arguments

:: (HasCallStack, MonadIO m, IsAppChooser a)

=> a

self: a AppChooser

-> m ()

Reloads the list of applications.

Since: 3.0

Properties

contentType

The content type of the AppChooser object.

See [GContentType][gio-GContentType] for more information about content types.

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

Construct a GValueConstruct with valid value for the “content-type” property. This is rarely needed directly, but it is used by new.

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

Get the value of the “content-type” property. When overloading is enabled, this is equivalent to

get appChooser #contentType