GI.Gtk.Objects.AppChooserButton

The AppChooserButton is a widget that lets the user select an application. It implements the AppChooser interface.

Initially, a AppChooserButton selects the first application in its list, which will either be the most-recently used application or, if AppChooserButton:show-default-item is True, the default application.

The list of applications shown in a AppChooserButton includes the recommended applications for the given content type. When AppChooserButton:show-default-item is set, the default application is also included. To let the user chooser other applications, you can set the AppChooserButton:show-dialog-item property, which allows to open a full AppChooserDialog.

It is possible to add custom items to the list, using appChooserButtonAppendCustomItem. These items cause the AppChooserButton::custom-item-activated signal to be emitted when they are selected.

To track changes in the selected application, use the ComboBox::changed signal.

Exported types

newtype AppChooserButton

Constructors

AppChooserButton (ManagedPtr AppChooserButton)

Instances

GObject AppChooserButton

Methods

gobjectType :: AppChooserButton -> IO GType

IsImplementorIface AppChooserButton

IsObject AppChooserButton

IsWidget AppChooserButton

IsContainer AppChooserButton

IsComboBox AppChooserButton

IsBin AppChooserButton

IsCellLayout AppChooserButton

IsCellEditable AppChooserButton

IsBuildable AppChooserButton

IsAppChooser AppChooserButton

IsAppChooserButton AppChooserButton

((~) * info (ResolveAppChooserButtonMethod t AppChooserButton), MethodInfo * info AppChooserButton p) => IsLabel t (AppChooserButton -> p)

Methods

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

((~) * info (ResolveAppChooserButtonMethod t AppChooserButton), MethodInfo * info AppChooserButton p) => IsLabelProxy t (AppChooserButton -> p)

Methods

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

HasAttributeList * AppChooserButton

type AttributeList AppChooserButton

type AttributeList AppChooserButton

type SignalList AppChooserButton

type SignalList AppChooserButton

class GObject o => IsAppChooserButton o

Instances

(GObject a, UnknownAncestorError Constraint AppChooserButton a) => IsAppChooserButton a

IsAppChooserButton AppChooserButton

toAppChooserButton :: IsAppChooserButton o => o -> IO AppChooserButton

noAppChooserButton :: Maybe AppChooserButton

Methods

appendCustomItem

data AppChooserButtonAppendCustomItemMethodInfo

Instances

((~) * signature (Text -> Text -> b -> m ()), MonadIO m, IsAppChooserButton a, IsIcon b) => MethodInfo * AppChooserButtonAppendCustomItemMethodInfo a signature

Methods

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

appChooserButtonAppendCustomItem

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserButton a, IsIcon b)

=> a

self: a AppChooserButton

-> Text

name: the name of the custom item

-> Text

label: the label for the custom item

-> b

icon: the icon for the custom item

-> m ()

Appends a custom item to the list of applications that is shown in the popup; the item name must be unique per-widget. Clients can use the provided name as a detail for the AppChooserButton::custom-item-activated signal, to add a callback for the activation of a particular custom item in the list. See also appChooserButtonAppendSeparator.

Since: 3.0

appendSeparator

data AppChooserButtonAppendSeparatorMethodInfo

Instances

((~) * signature (m ()), MonadIO m, IsAppChooserButton a) => MethodInfo * AppChooserButtonAppendSeparatorMethodInfo a signature

Methods

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

appChooserButtonAppendSeparator

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserButton a)

=> a

self: a AppChooserButton

-> m ()

Appends a separator to the list of applications that is shown in the popup.

Since: 3.0

getHeading

data AppChooserButtonGetHeadingMethodInfo

Instances

((~) * signature (m (Maybe Text)), MonadIO m, IsAppChooserButton a) => MethodInfo * AppChooserButtonGetHeadingMethodInfo a signature

Methods

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

appChooserButtonGetHeading

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserButton a)

=> a

self: a AppChooserButton

-> m (Maybe Text)

Returns: the text to display at the top of the dialog, or Nothing, in which case a default text is displayed

Returns the text to display at the top of the dialog.

getShowDefaultItem

data AppChooserButtonGetShowDefaultItemMethodInfo

Instances

((~) * signature (m Bool), MonadIO m, IsAppChooserButton a) => MethodInfo * AppChooserButtonGetShowDefaultItemMethodInfo a signature

Methods

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

appChooserButtonGetShowDefaultItem

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserButton a)

=> a

self: a AppChooserButton

-> m Bool

Returns: the value of AppChooserButton:show-default-item

Returns the current value of the AppChooserButton:show-default-item property.

Since: 3.2

getShowDialogItem

data AppChooserButtonGetShowDialogItemMethodInfo

Instances

((~) * signature (m Bool), MonadIO m, IsAppChooserButton a) => MethodInfo * AppChooserButtonGetShowDialogItemMethodInfo a signature

Methods

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

appChooserButtonGetShowDialogItem

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserButton a)

=> a

self: a AppChooserButton

-> m Bool

Returns: the value of AppChooserButton:show-dialog-item

Returns the current value of the AppChooserButton:show-dialog-item property.

Since: 3.0

new

appChooserButtonNew

Arguments

:: (HasCallStack, MonadIO m)

=> Text

contentType: the content type to show applications for

-> m AppChooserButton

Returns: a newly created AppChooserButton

Creates a new AppChooserButton for applications that can handle content of the given type.

Since: 3.0

setActiveCustomItem

data AppChooserButtonSetActiveCustomItemMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsAppChooserButton a) => MethodInfo * AppChooserButtonSetActiveCustomItemMethodInfo a signature

Methods

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

appChooserButtonSetActiveCustomItem

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserButton a)

=> a

self: a AppChooserButton

-> Text

name: the name of the custom item

-> m ()

Selects a custom item previously added with appChooserButtonAppendCustomItem.

Use appChooserRefresh to bring the selection to its initial state.

Since: 3.0

setHeading

data AppChooserButtonSetHeadingMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsAppChooserButton a) => MethodInfo * AppChooserButtonSetHeadingMethodInfo a signature

Methods

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

appChooserButtonSetHeading

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserButton a)

=> a

self: a AppChooserButton

-> Text

heading: a string containing Pango markup

-> m ()

Sets the text to display at the top of the dialog. If the heading is not set, the dialog displays a default text.

setShowDefaultItem

data AppChooserButtonSetShowDefaultItemMethodInfo

Instances

((~) * signature (Bool -> m ()), MonadIO m, IsAppChooserButton a) => MethodInfo * AppChooserButtonSetShowDefaultItemMethodInfo a signature

Methods

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

appChooserButtonSetShowDefaultItem

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserButton a)

=> a

self: a AppChooserButton

-> Bool

setting: the new value for AppChooserButton:show-default-item

-> m ()

Sets whether the dropdown menu of this button should show the default application for the given content type at top.

Since: 3.2

setShowDialogItem

data AppChooserButtonSetShowDialogItemMethodInfo

Instances

((~) * signature (Bool -> m ()), MonadIO m, IsAppChooserButton a) => MethodInfo * AppChooserButtonSetShowDialogItemMethodInfo a signature

Methods

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

appChooserButtonSetShowDialogItem

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserButton a)

=> a

self: a AppChooserButton

-> Bool

setting: the new value for AppChooserButton:show-dialog-item

-> m ()

Sets whether the dropdown menu of this button should show an entry to trigger a AppChooserDialog.

Since: 3.0

Properties

heading

data AppChooserButtonHeadingPropertyInfo

Instances

AttrInfo AppChooserButtonHeadingPropertyInfo

Associated Types

type AttrAllowedOps AppChooserButtonHeadingPropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint AppChooserButtonHeadingPropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint AppChooserButtonHeadingPropertyInfo :: * -> Constraint

type AttrGetType AppChooserButtonHeadingPropertyInfo :: *

type AttrLabel AppChooserButtonHeadingPropertyInfo :: Symbol

type AttrOrigin AppChooserButtonHeadingPropertyInfo :: *

Methods

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

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

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

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

type AttrOrigin AppChooserButtonHeadingPropertyInfo

type AttrOrigin AppChooserButtonHeadingPropertyInfo = AppChooserButton

type AttrLabel AppChooserButtonHeadingPropertyInfo

type AttrLabel AppChooserButtonHeadingPropertyInfo = "heading"

type AttrGetType AppChooserButtonHeadingPropertyInfo

type AttrGetType AppChooserButtonHeadingPropertyInfo = Maybe Text

type AttrBaseTypeConstraint AppChooserButtonHeadingPropertyInfo

type AttrBaseTypeConstraint AppChooserButtonHeadingPropertyInfo = IsAppChooserButton

type AttrSetTypeConstraint AppChooserButtonHeadingPropertyInfo

type AttrSetTypeConstraint AppChooserButtonHeadingPropertyInfo = * ~ Text

type AttrAllowedOps AppChooserButtonHeadingPropertyInfo

type AttrAllowedOps AppChooserButtonHeadingPropertyInfo = (:) AttrOpTag AttrSet ((:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ([] AttrOpTag)))

appChooserButtonHeading :: AttrLabelProxy "heading"

constructAppChooserButtonHeading :: IsAppChooserButton o => Text -> IO (GValueConstruct o)

getAppChooserButtonHeading :: (MonadIO m, IsAppChooserButton o) => o -> m (Maybe Text)

setAppChooserButtonHeading :: (MonadIO m, IsAppChooserButton o) => o -> Text -> m ()

showDefaultItem

data AppChooserButtonShowDefaultItemPropertyInfo

Instances

AttrInfo AppChooserButtonShowDefaultItemPropertyInfo

Associated Types

type AttrAllowedOps AppChooserButtonShowDefaultItemPropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint AppChooserButtonShowDefaultItemPropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint AppChooserButtonShowDefaultItemPropertyInfo :: * -> Constraint

type AttrGetType AppChooserButtonShowDefaultItemPropertyInfo :: *

type AttrLabel AppChooserButtonShowDefaultItemPropertyInfo :: Symbol

type AttrOrigin AppChooserButtonShowDefaultItemPropertyInfo :: *

Methods

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

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

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

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

type AttrOrigin AppChooserButtonShowDefaultItemPropertyInfo

type AttrOrigin AppChooserButtonShowDefaultItemPropertyInfo = AppChooserButton

type AttrLabel AppChooserButtonShowDefaultItemPropertyInfo

type AttrLabel AppChooserButtonShowDefaultItemPropertyInfo = "show-default-item"

type AttrGetType AppChooserButtonShowDefaultItemPropertyInfo

type AttrGetType AppChooserButtonShowDefaultItemPropertyInfo = Bool

type AttrBaseTypeConstraint AppChooserButtonShowDefaultItemPropertyInfo

type AttrBaseTypeConstraint AppChooserButtonShowDefaultItemPropertyInfo = IsAppChooserButton

type AttrSetTypeConstraint AppChooserButtonShowDefaultItemPropertyInfo

type AttrSetTypeConstraint AppChooserButtonShowDefaultItemPropertyInfo = * ~ Bool

type AttrAllowedOps AppChooserButtonShowDefaultItemPropertyInfo

type AttrAllowedOps AppChooserButtonShowDefaultItemPropertyInfo = (:) AttrOpTag AttrSet ((:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ([] AttrOpTag)))

appChooserButtonShowDefaultItem :: AttrLabelProxy "showDefaultItem"

constructAppChooserButtonShowDefaultItem :: IsAppChooserButton o => Bool -> IO (GValueConstruct o)

getAppChooserButtonShowDefaultItem :: (MonadIO m, IsAppChooserButton o) => o -> m Bool

setAppChooserButtonShowDefaultItem :: (MonadIO m, IsAppChooserButton o) => o -> Bool -> m ()

showDialogItem

data AppChooserButtonShowDialogItemPropertyInfo

Instances

AttrInfo AppChooserButtonShowDialogItemPropertyInfo

Associated Types

type AttrAllowedOps AppChooserButtonShowDialogItemPropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint AppChooserButtonShowDialogItemPropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint AppChooserButtonShowDialogItemPropertyInfo :: * -> Constraint

type AttrGetType AppChooserButtonShowDialogItemPropertyInfo :: *

type AttrLabel AppChooserButtonShowDialogItemPropertyInfo :: Symbol

type AttrOrigin AppChooserButtonShowDialogItemPropertyInfo :: *

Methods

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

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

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

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

type AttrOrigin AppChooserButtonShowDialogItemPropertyInfo

type AttrOrigin AppChooserButtonShowDialogItemPropertyInfo = AppChooserButton

type AttrLabel AppChooserButtonShowDialogItemPropertyInfo

type AttrLabel AppChooserButtonShowDialogItemPropertyInfo = "show-dialog-item"

type AttrGetType AppChooserButtonShowDialogItemPropertyInfo

type AttrGetType AppChooserButtonShowDialogItemPropertyInfo = Bool

type AttrBaseTypeConstraint AppChooserButtonShowDialogItemPropertyInfo

type AttrBaseTypeConstraint AppChooserButtonShowDialogItemPropertyInfo = IsAppChooserButton

type AttrSetTypeConstraint AppChooserButtonShowDialogItemPropertyInfo

type AttrSetTypeConstraint AppChooserButtonShowDialogItemPropertyInfo = * ~ Bool

type AttrAllowedOps AppChooserButtonShowDialogItemPropertyInfo

type AttrAllowedOps AppChooserButtonShowDialogItemPropertyInfo = (:) AttrOpTag AttrSet ((:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ([] AttrOpTag)))

appChooserButtonShowDialogItem :: AttrLabelProxy "showDialogItem"

constructAppChooserButtonShowDialogItem :: IsAppChooserButton o => Bool -> IO (GValueConstruct o)

getAppChooserButtonShowDialogItem :: (MonadIO m, IsAppChooserButton o) => o -> m Bool

setAppChooserButtonShowDialogItem :: (MonadIO m, IsAppChooserButton o) => o -> Bool -> m ()

Signals

customItemActivated

type AppChooserButtonCustomItemActivatedCallback = Text -> IO ()

data AppChooserButtonCustomItemActivatedSignalInfo

Instances

SignalInfo AppChooserButtonCustomItemActivatedSignalInfo

Associated Types

type HaskellCallbackType AppChooserButtonCustomItemActivatedSignalInfo :: *

Methods

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

type HaskellCallbackType AppChooserButtonCustomItemActivatedSignalInfo

type HaskellCallbackType AppChooserButtonCustomItemActivatedSignalInfo = AppChooserButtonCustomItemActivatedCallback

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

afterAppChooserButtonCustomItemActivated :: (GObject a, MonadIO m) => a -> AppChooserButtonCustomItemActivatedCallback -> m SignalHandlerId

genClosure_AppChooserButtonCustomItemActivated :: AppChooserButtonCustomItemActivatedCallback -> IO Closure

mk_AppChooserButtonCustomItemActivatedCallback :: C_AppChooserButtonCustomItemActivatedCallback -> IO (FunPtr C_AppChooserButtonCustomItemActivatedCallback)

noAppChooserButtonCustomItemActivatedCallback :: Maybe AppChooserButtonCustomItemActivatedCallback

onAppChooserButtonCustomItemActivated :: (GObject a, MonadIO m) => a -> AppChooserButtonCustomItemActivatedCallback -> m SignalHandlerId

wrap_AppChooserButtonCustomItemActivatedCallback :: AppChooserButtonCustomItemActivatedCallback -> Ptr () -> CString -> Ptr () -> IO ()