gi-gtk-3.0.43: Gtk bindings

Copyright | Will Thompson and Iñaki García Etxebarria
License | LGPL-2.1
Maintainer | Iñaki García Etxebarria
Safe Haskell | None
Language | Haskell2010

GI.Gtk.Objects.AppChooserDialog

Contents

- Exported types
- Methods
  - getHeading
  - getWidget
  - new
  - newForContentType
  - setHeading
- Properties
  - gfile
  - heading

Description

`AppChooserDialog` shows a `AppChooserWidget` inside a `Dialog`.

Note that `AppChooserDialog` does not have any interesting methods of its own. Instead, you should get the embedded `AppChooserWidget` using `appChooserDialogGetWidget` and call its methods if the generic `AppChooser` interface is not sufficient for your needs.

To set the heading that is shown above the `AppChooserWidget`, use `appChooserDialogSetHeading`.

Synopsis

- newtype AppChooserDialog = AppChooserDialog (ManagedPtr AppChooserDialog)
- class (GObject o, IsDescendantOf AppChooserDialog o) => IsAppChooserDialog o
- toAppChooserDialog :: (MonadIO m, IsAppChooserDialog o) => o -> m AppChooserDialog
- appChooserDialogGetHeading :: (HasCallStack, MonadIO m, IsAppChooserDialog a) => a -> m (Maybe Text)
- appChooserDialogGetWidget :: (HasCallStack, MonadIO m, IsAppChooserDialog a) => a -> m Widget
- appChooserDialogNew :: (HasCallStack, MonadIO m, IsWindow a, IsFile b) => Maybe a -> [DialogFlags] -> b -> m AppChooserDialog
- appChooserDialogNewForContentType :: (HasCallStack, MonadIO m, IsWindow a) => Maybe a -> [DialogFlags] -> Text -> m AppChooserDialog
- appChooserDialogSetHeading :: (HasCallStack, MonadIO m, IsAppChooserDialog a) => a -> Text -> m ()
- constructAppChooserDialogGfile :: (IsAppChooserDialog o, MonadIO m, IsFile a) => a -> m (GValueConstruct o)
- getAppChooserDialogGfile :: (MonadIO m, IsAppChooserDialog o) => o -> m (Maybe File)
- constructAppChooserDialogHeading :: (IsAppChooserDialog o, MonadIO m) => Text -> m (GValueConstruct o)
- getAppChooserDialogHeading :: (MonadIO m, IsAppChooserDialog o) => o -> m (Maybe Text)
- setAppChooserDialogHeading :: (MonadIO m, IsAppChooserDialog o) => o -> Text -> m ()

# Exported types

newtype AppChooserDialog Source #

Memory-managed wrapper type.

Constructors

AppChooserDialog (ManagedPtr AppChooserDialog) |

#### Instances

Instances details

Eq AppChooserDialog Source # |
Instance details Defined in GI.Gtk.Objects.AppChooserDialog Methods (==) :: AppChooserDialog -> AppChooserDialog -> Bool Source # (/=) :: AppChooserDialog -> AppChooserDialog -> Bool Source #
GObject AppChooserDialog Source # |
Instance details Defined in GI.Gtk.Objects.AppChooserDialog
ManagedPtrNewtype AppChooserDialog Source # |
Instance details Defined in GI.Gtk.Objects.AppChooserDialog Methods toManagedPtr :: AppChooserDialog -> ManagedPtr AppChooserDialog Source #
TypedObject AppChooserDialog Source # |
Instance details Defined in GI.Gtk.Objects.AppChooserDialog Methods glibType :: IO GType Source #
HasParentTypes AppChooserDialog Source # |
Instance details Defined in GI.Gtk.Objects.AppChooserDialog
IsGValue (Maybe AppChooserDialog) Source # | Convert `AppChooserDialog` to and from `GValue`. See `toGValue` and `fromGValue`.
Instance details Defined in GI.Gtk.Objects.AppChooserDialog Methods gvalueGType_ :: IO GType Source # gvalueSet_ :: Ptr GValue -> Maybe AppChooserDialog -> IO () Source # gvalueGet_ :: Ptr GValue -> IO (Maybe AppChooserDialog) Source #
type ParentTypes AppChooserDialog Source # |
Instance details Defined in GI.Gtk.Objects.AppChooserDialog type ParentTypes AppChooserDialog = '[Dialog, Window, Bin, Container, Widget, Object, ImplementorIface, AppChooser, Buildable]

class (GObject o, IsDescendantOf AppChooserDialog o) => IsAppChooserDialog o Source #

Type class for types which can be safely cast to `AppChooserDialog`, for instance with `toAppChooserDialog`.

#### Instances

Instances details

(GObject o, IsDescendantOf AppChooserDialog o) => IsAppChooserDialog o Source # |
Instance details Defined in GI.Gtk.Objects.AppChooserDialog

toAppChooserDialog :: (MonadIO m, IsAppChooserDialog o) => o -> m AppChooserDialog Source #

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

# Methods

### Click to display all available methods, including inherited ones

Expand

#### Methods

activate, activateDefault, activateFocus, activateKey, add, addAccelGroup, addAccelerator, addActionWidget, addButton, addChild, addDeviceEvents, addEvents, addMnemonic, addMnemonicLabel, addTickCallback, beginMoveDrag, beginResizeDrag, bindProperty, bindPropertyFull, canActivateAccel, checkResize, childFocus, childGetProperty, childNotify, childNotifyByPspec, childSetProperty, childType, classPath, close, computeExpand, constructChild, createPangoContext, createPangoLayout, customFinished, customTagEnd, customTagStart, deiconify, destroy, destroyed, deviceIsShadowed, dragBegin, dragBeginWithCoordinates, dragCheckThreshold, dragDestAddImageTargets, dragDestAddTextTargets, dragDestAddUriTargets, dragDestFindTarget, dragDestGetTargetList, dragDestGetTrackMotion, dragDestSet, dragDestSetProxy, dragDestSetTargetList, dragDestSetTrackMotion, dragDestUnset, dragGetData, dragHighlight, dragSourceAddImageTargets, dragSourceAddTextTargets, dragSourceAddUriTargets, dragSourceGetTargetList, dragSourceSet, dragSourceSetIconGicon, dragSourceSetIconName, dragSourceSetIconPixbuf, dragSourceSetIconStock, dragSourceSetTargetList, dragSourceUnset, dragUnhighlight, draw, ensureStyle, errorBell, event, forall, forceFloating, foreach, freezeChildNotify, freezeNotify, fullscreen, fullscreenOnMonitor, getv, grabAdd, grabDefault, grabFocus, grabRemove, hasDefault, hasFocus, hasGrab, hasGroup, hasRcStyle, hasScreen, hasToplevelFocus, hasVisibleFocus, hide, hideOnDelete, iconify, inDestruction, initTemplate, inputShapeCombineRegion, insertActionGroup, intersect, isActive, isAncestor, isComposited, isDrawable, isFloating, isFocus, isMaximized, isSensitive, isToplevel, isVisible, keynavFailed, listAccelClosures, listActionPrefixes, listMnemonicLabels, map, maximize, mnemonicActivate, modifyBase, modifyBg, modifyCursor, modifyFg, modifyFont, modifyStyle, modifyText, move, notify, notifyByPspec, overrideBackgroundColor, overrideColor, overrideCursor, overrideFont, overrideSymbolicColor, parseGeometry, parserFinished, path, present, presentWithTime, propagateDraw, propagateKeyEvent, queueAllocate, queueComputeExpand, queueDraw, queueDrawArea, queueDrawRegion, queueResize, queueResizeNoRedraw, realize, ref, refSink, refresh, regionIntersect, registerWindow, remove, removeAccelGroup, removeAccelerator, removeMnemonic, removeMnemonicLabel, removeTickCallback, renderIcon, renderIconPixbuf, reparent, resetRcStyles, resetStyle, reshowWithInitialSize, resize, resizeChildren, resizeGripIsVisible, resizeToGeometry, response, run, runDispose, sendExpose, sendFocusChange, shapeCombineRegion, show, showAll, showNow, sizeAllocate, sizeAllocateWithBaseline, sizeRequest, stealData, stealQdata, stick, styleAttach, styleGetProperty, thawChildNotify, thawNotify, translateCoordinates, triggerTooltipQuery, unfullscreen, unmap, unmaximize, unparent, unrealize, unref, unregisterWindow, unsetFocusChain, unsetStateFlags, unstick, watchClosure.

#### Getters

getAcceptFocus, getAccessible, getActionArea, getActionGroup, getAllocatedBaseline, getAllocatedHeight, getAllocatedSize, getAllocatedWidth, getAllocation, getAncestor, getAppInfo, getAppPaintable, getApplication, getAttachedTo, getBorderWidth, getCanDefault, getCanFocus, getChild, getChildRequisition, getChildVisible, getChildren, getClip, getClipboard, getCompositeName, getContentArea, getContentType, getData, getDecorated, getDefaultSize, getDefaultWidget, getDeletable, getDestroyWithParent, getDeviceEnabled, getDeviceEvents, getDirection, getDisplay, getDoubleBuffered, getEvents, getFocus, getFocusChain, getFocusChild, getFocusHadjustment, getFocusOnClick, getFocusOnMap, getFocusVadjustment, getFocusVisible, getFontMap, getFontOptions, getFrameClock, getGravity, getGroup, getHalign, getHasResizeGrip, getHasTooltip, getHasWindow, getHeaderBar, getHeading, getHexpand, getHexpandSet, getHideTitlebarWhenMaximized, getIcon, getIconList, getIconName, getInternalChild, getMapped, getMarginBottom, getMarginEnd, getMarginLeft, getMarginRight, getMarginStart, getMarginTop, getMnemonicModifier, getMnemonicsVisible, getModal, getModifierMask, getModifierStyle, getName, getNoShowAll, getOpacity, getPangoContext, getParent, getParentWindow, getPath, getPathForChild, getPointer, getPosition, getPreferredHeight, getPreferredHeightAndBaselineForWidth, getPreferredHeightForWidth, getPreferredSize, getPreferredWidth, getPreferredWidthForHeight, getProperty, getQdata, getRealized, getReceivesDefault, getRequestMode, getRequisition, getResizable, getResizeGripArea, getResizeMode, getResponseForWidget, getRole, getRootWindow, getScaleFactor, getScreen, getSensitive, getSettings, getSize, getSizeRequest, getSkipPagerHint, getSkipTaskbarHint, getState, getStateFlags, getStyle, getStyleContext, getSupportMultidevice, getTemplateChild, getTitle, getTitlebar, getTooltipMarkup, getTooltipText, getTooltipWindow, getToplevel, getTransientFor, getTypeHint, getUrgencyHint, getValign, getValignWithBaseline, getVexpand, getVexpandSet, getVisible, getVisual, getWidget, getWidgetForResponse, getWindow, getWindowType.

#### Setters

setAccelPath, setAcceptFocus, setAllocation, setAlternativeButtonOrderFromArray, setAppPaintable, setApplication, setAttachedTo, setBorderWidth, setBuildableProperty, setCanDefault, setCanFocus, setChildVisible, setClip, setCompositeName, setData, setDataFull, setDecorated, setDefault, setDefaultGeometry, setDefaultResponse, setDefaultSize, setDeletable, setDestroyWithParent, setDeviceEnabled, setDeviceEvents, setDirection, setDoubleBuffered, setEvents, setFocus, setFocusChain, setFocusChild, setFocusHadjustment, setFocusOnClick, setFocusOnMap, setFocusVadjustment, setFocusVisible, setFontMap, setFontOptions, setGeometryHints, setGravity, setHalign, setHasResizeGrip, setHasTooltip, setHasUserRefCount, setHasWindow, setHeading, setHexpand, setHexpandSet, setHideTitlebarWhenMaximized, setIcon, setIconFromFile, setIconList, setIconName, setKeepAbove, setKeepBelow, setMapped, setMarginBottom, setMarginEnd, setMarginLeft, setMarginRight, setMarginStart, setMarginTop, setMnemonicModifier, setMnemonicsVisible, setModal, setName, setNoShowAll, setOpacity, setParent, setParentWindow, setPosition, setProperty, setRealized, setReallocateRedraws, setReceivesDefault, setRedrawOnAllocate, setResizable, setResizeMode, setResponseSensitive, setRole, setScreen, setSensitive, setSizeRequest, setSkipPagerHint, setSkipTaskbarHint, setStartupId, setState, setStateFlags, setStyle, setSupportMultidevice, setTitle, setTitlebar, setTooltipMarkup, setTooltipText, setTooltipWindow, setTransientFor, setTypeHint, setUrgencyHint, setValign, setVexpand, setVexpandSet, setVisible, setVisual, setWindow, setWmclass.

## getHeading

appChooserDialogGetHeading Source #

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserDialog a) |
=> a | `self`: a `AppChooserDialog`
-> 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.

## getWidget

appChooserDialogGetWidget Source #

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserDialog a) |
=> a | `self`: a `AppChooserDialog`
-> m Widget | Returns: the `AppChooserWidget` of `self`

Returns the `AppChooserWidget` of this dialog.

Since: 3.0

## new

appChooserDialogNew Source #

Arguments

:: (HasCallStack, MonadIO m, IsWindow a, IsFile b) |
=> Maybe a | `parent`: a `Window`, or `Nothing`
-> [DialogFlags] | `flags`: flags for this dialog
-> b | `file`: a `File`
-> m AppChooserDialog | Returns: a newly created `AppChooserDialog`

Creates a new `AppChooserDialog` for the provided `File`, to allow the user to select an application for it.

Since: 3.0

## newForContentType

appChooserDialogNewForContentType Source #

Arguments

:: (HasCallStack, MonadIO m, IsWindow a) |
=> Maybe a | `parent`: a `Window`, or `Nothing`
-> [DialogFlags] | `flags`: flags for this dialog
-> Text | `contentType`: a content type string
-> m AppChooserDialog | Returns: a newly created `AppChooserDialog`

Creates a new `AppChooserDialog` for the provided content type, to allow the user to select an application for it.

Since: 3.0

## setHeading

appChooserDialogSetHeading Source #

Arguments

:: (HasCallStack, MonadIO m, IsAppChooserDialog a) |
=> a | `self`: a `AppChooserDialog`
-> 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.

# Properties

## gfile

The GFile used by the `AppChooserDialog`. The dialog's `AppChooserWidget` content type will be guessed from the file, if present.

constructAppChooserDialogGfile :: (IsAppChooserDialog o, MonadIO m, IsFile a) => a -> m (GValueConstruct o) Source #

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

getAppChooserDialogGfile :: (MonadIO m, IsAppChooserDialog o) => o -> m (Maybe File) Source #

Get the value of the “`gfile`” property. When overloading is enabled, this is equivalent to

    get appChooserDialog #gfile

## heading

The text to show at the top of the dialog. The string may contain Pango markup.

constructAppChooserDialogHeading :: (IsAppChooserDialog o, MonadIO m) => Text -> m (GValueConstruct o) Source #

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

getAppChooserDialogHeading :: (MonadIO m, IsAppChooserDialog o) => o -> m (Maybe Text) Source #

Get the value of the “`heading`” property. When overloading is enabled, this is equivalent to

    get appChooserDialog #heading

setAppChooserDialogHeading :: (MonadIO m, IsAppChooserDialog o) => o -> Text -> m () Source #

Set the value of the “`heading`” property. When overloading is enabled, this is equivalent to

    set appChooserDialog [ #heading := value ]