Copyright	Will Thompson Iñaki García Etxebarria and Jonas Platte
License	LGPL-2.1
Maintainer	Iñaki García Etxebarria (inaki@blueleaf.cc)
Safe Haskell	None
Language	Haskell2010

GI.Gtk.Objects.FontButton

Contents

Exported types
Methods
Properties
Signals
- fontSet

Description

The FontButton is a button which displays the currently selected font an allows to open a font chooser dialog to change the font. It is suitable widget for selecting a font in a preference dialog.

CSS nodes

GtkFontButton has a single CSS node with name button and style class .font.

Synopsis

newtype FontButton = FontButton (ManagedPtr FontButton)
class (GObject o, IsDescendantOf FontButton o) => IsFontButton o
toFontButton :: (MonadIO m, IsFontButton o) => o -> m FontButton
noFontButton :: Maybe FontButton
fontButtonGetFontName :: (HasCallStack, MonadIO m, IsFontButton a) => a -> m Text
fontButtonGetShowSize :: (HasCallStack, MonadIO m, IsFontButton a) => a -> m Bool
fontButtonGetShowStyle :: (HasCallStack, MonadIO m, IsFontButton a) => a -> m Bool
fontButtonGetTitle :: (HasCallStack, MonadIO m, IsFontButton a) => a -> m Text
fontButtonGetUseFont :: (HasCallStack, MonadIO m, IsFontButton a) => a -> m Bool
fontButtonGetUseSize :: (HasCallStack, MonadIO m, IsFontButton a) => a -> m Bool
fontButtonNew :: (HasCallStack, MonadIO m) => m FontButton
fontButtonNewWithFont :: (HasCallStack, MonadIO m) => Text -> m FontButton
fontButtonSetFontName :: (HasCallStack, MonadIO m, IsFontButton a) => a -> Text -> m Bool
fontButtonSetShowSize :: (HasCallStack, MonadIO m, IsFontButton a) => a -> Bool -> m ()
fontButtonSetShowStyle :: (HasCallStack, MonadIO m, IsFontButton a) => a -> Bool -> m ()
fontButtonSetTitle :: (HasCallStack, MonadIO m, IsFontButton a) => a -> Text -> m ()
fontButtonSetUseFont :: (HasCallStack, MonadIO m, IsFontButton a) => a -> Bool -> m ()
fontButtonSetUseSize :: (HasCallStack, MonadIO m, IsFontButton a) => a -> Bool -> m ()
clearFontButtonFontName :: (MonadIO m, IsFontButton o) => o -> m ()
constructFontButtonFontName :: IsFontButton o => Text -> IO (GValueConstruct o)
getFontButtonFontName :: (MonadIO m, IsFontButton o) => o -> m Text
setFontButtonFontName :: (MonadIO m, IsFontButton o) => o -> Text -> m ()
constructFontButtonShowSize :: IsFontButton o => Bool -> IO (GValueConstruct o)
getFontButtonShowSize :: (MonadIO m, IsFontButton o) => o -> m Bool
setFontButtonShowSize :: (MonadIO m, IsFontButton o) => o -> Bool -> m ()
constructFontButtonShowStyle :: IsFontButton o => Bool -> IO (GValueConstruct o)
getFontButtonShowStyle :: (MonadIO m, IsFontButton o) => o -> m Bool
setFontButtonShowStyle :: (MonadIO m, IsFontButton o) => o -> Bool -> m ()
constructFontButtonTitle :: IsFontButton o => Text -> IO (GValueConstruct o)
getFontButtonTitle :: (MonadIO m, IsFontButton o) => o -> m Text
setFontButtonTitle :: (MonadIO m, IsFontButton o) => o -> Text -> m ()
constructFontButtonUseFont :: IsFontButton o => Bool -> IO (GValueConstruct o)
getFontButtonUseFont :: (MonadIO m, IsFontButton o) => o -> m Bool
setFontButtonUseFont :: (MonadIO m, IsFontButton o) => o -> Bool -> m ()
constructFontButtonUseSize :: IsFontButton o => Bool -> IO (GValueConstruct o)
getFontButtonUseSize :: (MonadIO m, IsFontButton o) => o -> m Bool
setFontButtonUseSize :: (MonadIO m, IsFontButton o) => o -> Bool -> m ()
type C_FontButtonFontSetCallback = Ptr () -> Ptr () -> IO ()
type FontButtonFontSetCallback = IO ()
afterFontButtonFontSet :: (IsFontButton a, MonadIO m) => a -> FontButtonFontSetCallback -> m SignalHandlerId
genClosure_FontButtonFontSet :: MonadIO m => FontButtonFontSetCallback -> m (GClosure C_FontButtonFontSetCallback)
mk_FontButtonFontSetCallback :: C_FontButtonFontSetCallback -> IO (FunPtr C_FontButtonFontSetCallback)
noFontButtonFontSetCallback :: Maybe FontButtonFontSetCallback
onFontButtonFontSet :: (IsFontButton a, MonadIO m) => a -> FontButtonFontSetCallback -> m SignalHandlerId
wrap_FontButtonFontSetCallback :: FontButtonFontSetCallback -> C_FontButtonFontSetCallback

Exported types

newtype FontButton Source #

Memory-managed wrapper type.

Constructors

FontButton (ManagedPtr FontButton)

Instances

GObject FontButton Source #
Instance details Defined in GI.Gtk.Objects.FontButton Methods gobjectType :: IO GType #
HasParentTypes FontButton Source #
Instance details Defined in GI.Gtk.Objects.FontButton
type ParentTypes FontButton Source #
Instance details Defined in GI.Gtk.Objects.FontButton type ParentTypes FontButton = Button ': (Bin ': (Container ': (Widget ': (Object ': (ImplementorIface ': (Actionable ': (Activatable ': (Buildable ': (FontChooser ': ([] :: [Type]))))))))))

class (GObject o, IsDescendantOf FontButton o) => IsFontButton o Source #

Type class for types which can be safely cast to FontButton, for instance with toFontButton.

Instances

(GObject o, IsDescendantOf FontButton o) => IsFontButton o Source #
Instance details Defined in GI.Gtk.Objects.FontButton

toFontButton :: (MonadIO m, IsFontButton o) => o -> m FontButton Source #

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

noFontButton :: Maybe FontButton Source #

A convenience alias for Nothing :: Maybe FontButton.

Methods

getFontName

fontButtonGetFontName Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> m Text	Returns: an internal copy of the font name which must not be freed.

Deprecated: (Since version 3.22)Use fontChooserGetFont instead

Retrieves the name of the currently selected font. This name includes style and size information as well. If you want to render something with the font, use this string with fontDescriptionFromString . If you’re interested in peeking certain values (family name, style, size, weight) just query these properties from the FontDescription object.

Since: 2.4

getShowSize

fontButtonGetShowSize Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> m Bool	Returns: whether the font size will be shown in the label.

Returns whether the font size will be shown in the label.

Since: 2.4

getShowStyle

fontButtonGetShowStyle Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> m Bool	Returns: whether the font style will be shown in the label.

Returns whether the name of the font style will be shown in the label.

Since: 2.4

getTitle

fontButtonGetTitle Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> m Text	Returns: an internal copy of the title string which must not be freed.

Retrieves the title of the font chooser dialog.

Since: 2.4

getUseFont

fontButtonGetUseFont Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> m Bool	Returns: whether the selected font is used in the label.

Returns whether the selected font is used in the label.

Since: 2.4

getUseSize

fontButtonGetUseSize Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> m Bool	Returns: whether the selected size is used in the label.

Returns whether the selected size is used in the label.

Since: 2.4

new

fontButtonNew Source #

Arguments

:: (HasCallStack, MonadIO m)
=> m FontButton	Returns: a new font picker widget.

Creates a new font picker widget.

Since: 2.4

newWithFont

fontButtonNewWithFont Source #

Arguments

:: (HasCallStack, MonadIO m)
=> Text	`fontname`: Name of font to display in font chooser dialog
-> m FontButton	Returns: a new font picker widget.

Creates a new font picker widget.

Since: 2.4

setFontName

fontButtonSetFontName Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> Text	`fontname`: Name of font to display in font chooser dialog
-> m Bool	Returns: `True`

Deprecated: (Since version 3.22)Use fontChooserSetFont instead

Sets or updates the currently-displayed font in font picker dialog.

Since: 2.4

setShowSize

fontButtonSetShowSize Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> Bool	`showSize`: `True` if font size should be displayed in dialog.
-> m ()

If showSize is True, the font size will be displayed along with the name of the selected font.

Since: 2.4

setShowStyle

fontButtonSetShowStyle Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> Bool	`showStyle`: `True` if font style should be displayed in label.
-> m ()

If showStyle is True, the font style will be displayed along with name of the selected font.

Since: 2.4

setTitle

fontButtonSetTitle Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> Text	`title`: a string containing the font chooser dialog title
-> m ()

Sets the title for the font chooser dialog.

Since: 2.4

setUseFont

fontButtonSetUseFont Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> Bool	`useFont`: If `True`, font name will be written using font chosen.
-> m ()

If useFont is True, the font name will be written using the selected font.

Since: 2.4

setUseSize

fontButtonSetUseSize Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontButton a)
=> a	`fontButton`: a `FontButton`
-> Bool	`useSize`: If `True`, font name will be written using the selected size.
-> m ()

If useSize is True, the font name will be written using the selected size.

Since: 2.4

Properties

fontName

The name of the currently selected font.

Since: 2.4

clearFontButtonFontName :: (MonadIO m, IsFontButton o) => o -> m () Source #

Set the value of the “font-name” property to Nothing. When overloading is enabled, this is equivalent to

clear #fontName

constructFontButtonFontName :: IsFontButton o => Text -> IO (GValueConstruct o) Source #

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

getFontButtonFontName :: (MonadIO m, IsFontButton o) => o -> m Text Source #

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

get fontButton #fontName

setFontButtonFontName :: (MonadIO m, IsFontButton o) => o -> Text -> m () Source #

Set the value of the “font-name” property. When overloading is enabled, this is equivalent to

set fontButton [ #fontName := value ]

showSize

If this property is set to True, the selected font size will be shown in the label. For a more WYSIWYG way to show the selected size, see the ::use-size property.

Since: 2.4

constructFontButtonShowSize :: IsFontButton o => Bool -> IO (GValueConstruct o) Source #

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

getFontButtonShowSize :: (MonadIO m, IsFontButton o) => o -> m Bool Source #

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

get fontButton #showSize

setFontButtonShowSize :: (MonadIO m, IsFontButton o) => o -> Bool -> m () Source #

Set the value of the “show-size” property. When overloading is enabled, this is equivalent to

set fontButton [ #showSize := value ]

showStyle

If this property is set to True, the name of the selected font style will be shown in the label. For a more WYSIWYG way to show the selected style, see the ::use-font property.

Since: 2.4

constructFontButtonShowStyle :: IsFontButton o => Bool -> IO (GValueConstruct o) Source #

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

getFontButtonShowStyle :: (MonadIO m, IsFontButton o) => o -> m Bool Source #

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

get fontButton #showStyle

setFontButtonShowStyle :: (MonadIO m, IsFontButton o) => o -> Bool -> m () Source #

Set the value of the “show-style” property. When overloading is enabled, this is equivalent to

set fontButton [ #showStyle := value ]

title

The title of the font chooser dialog.

Since: 2.4

constructFontButtonTitle :: IsFontButton o => Text -> IO (GValueConstruct o) Source #

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

getFontButtonTitle :: (MonadIO m, IsFontButton o) => o -> m Text Source #

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

get fontButton #title

setFontButtonTitle :: (MonadIO m, IsFontButton o) => o -> Text -> m () Source #

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

set fontButton [ #title := value ]

useFont

If this property is set to True, the label will be drawn in the selected font.

Since: 2.4

constructFontButtonUseFont :: IsFontButton o => Bool -> IO (GValueConstruct o) Source #

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

getFontButtonUseFont :: (MonadIO m, IsFontButton o) => o -> m Bool Source #

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

get fontButton #useFont

setFontButtonUseFont :: (MonadIO m, IsFontButton o) => o -> Bool -> m () Source #

Set the value of the “use-font” property. When overloading is enabled, this is equivalent to

set fontButton [ #useFont := value ]

useSize

If this property is set to True, the label will be drawn with the selected font size.

Since: 2.4

constructFontButtonUseSize :: IsFontButton o => Bool -> IO (GValueConstruct o) Source #

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

getFontButtonUseSize :: (MonadIO m, IsFontButton o) => o -> m Bool Source #

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

get fontButton #useSize

setFontButtonUseSize :: (MonadIO m, IsFontButton o) => o -> Bool -> m () Source #

Set the value of the “use-size” property. When overloading is enabled, this is equivalent to

set fontButton [ #useSize := value ]

Signals

fontSet

type C_FontButtonFontSetCallback = Ptr () -> Ptr () -> IO () Source #

Type for the callback on the (unwrapped) C side.

type FontButtonFontSetCallback = IO () Source #

The ::font-set signal is emitted when the user selects a font. When handling this signal, use fontChooserGetFont to find out which font was just selected.

Note that this signal is only emitted when the user changes the font. If you need to react to programmatic font changes as well, use the notify::font signal.

Since: 2.4

afterFontButtonFontSet :: (IsFontButton a, MonadIO m) => a -> FontButtonFontSetCallback -> m SignalHandlerId Source #

Connect a signal handler for the “font-set” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after fontButton #fontSet callback

genClosure_FontButtonFontSet :: MonadIO m => FontButtonFontSetCallback -> m (GClosure C_FontButtonFontSetCallback) Source #

Wrap the callback into a GClosure.

mk_FontButtonFontSetCallback :: C_FontButtonFontSetCallback -> IO (FunPtr C_FontButtonFontSetCallback) Source #

Generate a function pointer callable from C code, from a C_FontButtonFontSetCallback.

noFontButtonFontSetCallback :: Maybe FontButtonFontSetCallback Source #

A convenience synonym for Nothing :: Maybe FontButtonFontSetCallback.

onFontButtonFontSet :: (IsFontButton a, MonadIO m) => a -> FontButtonFontSetCallback -> m SignalHandlerId Source #

Connect a signal handler for the “font-set” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on fontButton #fontSet callback

wrap_FontButtonFontSetCallback :: FontButtonFontSetCallback -> C_FontButtonFontSetCallback Source #

Wrap a FontButtonFontSetCallback into a C_FontButtonFontSetCallback.