gi-gtk-3.0.26: Gtk bindings

CopyrightWill Thompson Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria (garetxe@gmail.com)
Safe HaskellNone
LanguageHaskell2010

GI.Gtk.Objects.AppChooserDialog

Contents

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

Exported types

class GObject o => IsAppChooserDialog o Source #

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

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

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, IsFile a) => a -> IO (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 => Text -> IO (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 ]