gi-gtk-3.0.32: Gtk bindings
CopyrightWill Thompson Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellNone
LanguageHaskell2010

GI.Gtk.Interfaces.FontChooser

Description

FontChooser is an interface that can be implemented by widgets displaying the list of fonts. In GTK+, the main objects that implement this interface are FontChooserWidget, FontChooserDialog and FontButton. The GtkFontChooser interface has been introducted in GTK+ 3.2.

Synopsis

Exported types

newtype FontChooser Source #

Memory-managed wrapper type.

class (GObject o, IsDescendantOf FontChooser o) => IsFontChooser o Source #

Type class for types which can be safely cast to FontChooser, for instance with toFontChooser.

Instances

Instances details
(GObject o, IsDescendantOf FontChooser o) => IsFontChooser o Source # 
Instance details

Defined in GI.Gtk.Interfaces.FontChooser

toFontChooser :: (MonadIO m, IsFontChooser o) => o -> m FontChooser Source #

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

Methods

Overloaded methods

getFont

fontChooserGetFont Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m (Maybe Text)

Returns: A string with the name of the current font, or Nothing if no font is selected. You must free this string with free.

Gets the currently-selected font name.

Note that this can be a different string than what you set with fontChooserSetFont, as the font chooser widget may normalize font names and thus return a string with a different structure. For example, “Helvetica Italic Bold 12” could be normalized to “Helvetica Bold Italic 12”.

Use fontDescriptionEqual if you want to compare two font descriptions.

Since: 3.2

getFontDesc

fontChooserGetFontDesc Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m (Maybe FontDescription)

Returns: A FontDescription for the current font, or Nothing if no font is selected.

Gets the currently-selected font.

Note that this can be a different string than what you set with fontChooserSetFont, as the font chooser widget may normalize font names and thus return a string with a different structure. For example, “Helvetica Italic Bold 12” could be normalized to “Helvetica Bold Italic 12”.

Use fontDescriptionEqual if you want to compare two font descriptions.

Since: 3.2

getFontFace

fontChooserGetFontFace Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m (Maybe FontFace)

Returns: A FontFace representing the selected font group details, or Nothing. The returned object is owned by fontchooser and must not be modified or freed.

Gets the FontFace representing the selected font group details (i.e. family, slant, weight, width, etc).

If the selected font is not installed, returns Nothing.

Since: 3.2

getFontFamily

fontChooserGetFontFamily Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m (Maybe FontFamily)

Returns: A FontFamily representing the selected font family, or Nothing. The returned object is owned by fontchooser and must not be modified or freed.

Gets the FontFamily representing the selected font family. Font families are a collection of font faces.

If the selected font is not installed, returns Nothing.

Since: 3.2

getFontFeatures

fontChooserGetFontFeatures Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m Text

Returns: the currently selected font features

Gets the currently-selected font features.

Since: 3.24

getFontMap

fontChooserGetFontMap Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m (Maybe FontMap)

Returns: a FontMap, or Nothing

Gets the custom font map of this font chooser widget, or Nothing if it does not have one.

Since: 3.18

getFontSize

fontChooserGetFontSize Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m Int32

Returns: A n integer representing the selected font size, or -1 if no font size is selected.

The selected font size.

Since: 3.2

getLanguage

fontChooserGetLanguage Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m Text

Returns: the currently selected language

Gets the language that is used for font features.

Since: 3.24

getLevel

fontChooserGetLevel Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m [FontChooserLevel]

Returns: the current granularity level

Returns the current level of granularity for selecting fonts.

Since: 3.24

getPreviewText

fontChooserGetPreviewText Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m Text

Returns: the text displayed in the preview area

Gets the text displayed in the preview area.

Since: 3.2

getShowPreviewEntry

fontChooserGetShowPreviewEntry Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> m Bool

Returns: True if the preview entry is shown or False if it is hidden.

Returns whether the preview entry is shown or not.

Since: 3.2

setFilterFunc

fontChooserSetFilterFunc Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> Maybe FontFilterFunc

filter: a FontFilterFunc, or Nothing

-> m () 

Adds a filter function that decides which fonts to display in the font chooser.

Since: 3.2

setFont

fontChooserSetFont Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> Text

fontname: a font name like “Helvetica 12” or “Times Bold 18”

-> m () 

Sets the currently-selected font.

Since: 3.2

setFontDesc

fontChooserSetFontDesc Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> FontDescription

fontDesc: a FontDescription

-> m () 

Sets the currently-selected font from fontDesc.

Since: 3.2

setFontMap

fontChooserSetFontMap Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a, IsFontMap b) 
=> a

fontchooser: a FontChooser

-> Maybe b

fontmap: a FontMap

-> m () 

Sets a custom font map to use for this font chooser widget. A custom font map can be used to present application-specific fonts instead of or in addition to the normal system fonts.

C code

FcConfig *config;
PangoFontMap *fontmap;

config = FcInitLoadConfigAndFonts ();
FcConfigAppFontAddFile (config, my_app_font_file);

fontmap = pango_cairo_font_map_new_for_font_type (CAIRO_FONT_TYPE_FT);
pango_fc_font_map_set_config (PANGO_FC_FONT_MAP (fontmap), config);

gtk_font_chooser_set_font_map (font_chooser, fontmap);

Note that other GTK+ widgets will only be able to use the application-specific font if it is present in the font map they use:

context = gtk_widget_get_pango_context (label);
pango_context_set_font_map (context, fontmap);

Since: 3.18

setLanguage

fontChooserSetLanguage Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> Text

language: a language

-> m () 

Sets the language to use for font features.

Since: 3.24

setLevel

fontChooserSetLevel Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> [FontChooserLevel]

level: the desired level of granularity

-> m () 

Sets the desired level of granularity for selecting fonts.

Since: 3.24

setPreviewText

fontChooserSetPreviewText Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> Text

text: the text to display in the preview area

-> m () 

Sets the text displayed in the preview area. The text is used to show how the selected font looks.

Since: 3.2

setShowPreviewEntry

fontChooserSetShowPreviewEntry Source #

Arguments

:: (HasCallStack, MonadIO m, IsFontChooser a) 
=> a

fontchooser: a FontChooser

-> Bool

showPreviewEntry: whether to show the editable preview entry or not

-> m () 

Shows or hides the editable preview entry.

Since: 3.2

Properties

font

The font description as a string, e.g. "Sans Italic 12".

constructFontChooserFont :: IsFontChooser o => Text -> IO (GValueConstruct o) Source #

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

getFontChooserFont :: (MonadIO m, IsFontChooser o) => o -> m (Maybe Text) Source #

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

get fontChooser #font

setFontChooserFont :: (MonadIO m, IsFontChooser o) => o -> Text -> m () Source #

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

set fontChooser [ #font := value ]

fontDesc

The font description as a FontDescription.

constructFontChooserFontDesc :: IsFontChooser o => FontDescription -> IO (GValueConstruct o) Source #

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

getFontChooserFontDesc :: (MonadIO m, IsFontChooser o) => o -> m (Maybe FontDescription) Source #

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

get fontChooser #fontDesc

setFontChooserFontDesc :: (MonadIO m, IsFontChooser o) => o -> FontDescription -> m () Source #

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

set fontChooser [ #fontDesc := value ]

fontFeatures

The selected font features, in a format that is compatible with CSS and with Pango attributes.

Since: 3.22.30

getFontChooserFontFeatures :: (MonadIO m, IsFontChooser o) => o -> m (Maybe Text) Source #

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

get fontChooser #fontFeatures

language

The language for which the FontChooser:font-features were selected, in a format that is compatible with CSS and with Pango attributes.

Since: 3.22.30

constructFontChooserLanguage :: IsFontChooser o => Text -> IO (GValueConstruct o) Source #

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

getFontChooserLanguage :: (MonadIO m, IsFontChooser o) => o -> m (Maybe Text) Source #

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

get fontChooser #language

setFontChooserLanguage :: (MonadIO m, IsFontChooser o) => o -> Text -> m () Source #

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

set fontChooser [ #language := value ]

level

The level of granularity to offer for selecting fonts.

Since: 3.22.30

constructFontChooserLevel :: IsFontChooser o => [FontChooserLevel] -> IO (GValueConstruct o) Source #

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

getFontChooserLevel :: (MonadIO m, IsFontChooser o) => o -> m [FontChooserLevel] Source #

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

get fontChooser #level

setFontChooserLevel :: (MonadIO m, IsFontChooser o) => o -> [FontChooserLevel] -> m () Source #

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

set fontChooser [ #level := value ]

previewText

The string with which to preview the font.

constructFontChooserPreviewText :: IsFontChooser o => Text -> IO (GValueConstruct o) Source #

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

getFontChooserPreviewText :: (MonadIO m, IsFontChooser o) => o -> m (Maybe Text) Source #

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

get fontChooser #previewText

setFontChooserPreviewText :: (MonadIO m, IsFontChooser o) => o -> Text -> m () Source #

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

set fontChooser [ #previewText := value ]

showPreviewEntry

Whether to show an entry to change the preview text.

constructFontChooserShowPreviewEntry :: IsFontChooser o => Bool -> IO (GValueConstruct o) Source #

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

getFontChooserShowPreviewEntry :: (MonadIO m, IsFontChooser o) => o -> m Bool Source #

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

get fontChooser #showPreviewEntry

setFontChooserShowPreviewEntry :: (MonadIO m, IsFontChooser o) => o -> Bool -> m () Source #

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

set fontChooser [ #showPreviewEntry := value ]

Signals

fontActivated

type C_FontChooserFontActivatedCallback = Ptr () -> CString -> Ptr () -> IO () Source #

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

type FontChooserFontActivatedCallback Source #

Arguments

 = Text

fontname: the font name

-> IO () 

Emitted when a font is activated. This usually happens when the user double clicks an item, or an item is selected and the user presses one of the keys Space, Shift+Space, Return or Enter.

afterFontChooserFontActivated :: (IsFontChooser a, MonadIO m) => a -> FontChooserFontActivatedCallback -> m SignalHandlerId Source #

Connect a signal handler for the fontActivated signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after fontChooser #fontActivated callback

onFontChooserFontActivated :: (IsFontChooser a, MonadIO m) => a -> FontChooserFontActivatedCallback -> m SignalHandlerId Source #

Connect a signal handler for the fontActivated signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on fontChooser #fontActivated callback