Copyright | Will Thompson and Iñaki García Etxebarria |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
The GtkFontButton
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
fontbutton ╰── button.font ╰── [content]
GtkFontButton
has a single CSS node with name fontbutton which
contains a button node with the .font style class.
Synopsis
- newtype FontButton = FontButton (ManagedPtr FontButton)
- class (GObject o, IsDescendantOf FontButton o) => IsFontButton o
- toFontButton :: (MonadIO m, IsFontButton o) => o -> m FontButton
- fontButtonGetModal :: (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
- fontButtonSetModal :: (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 ()
- constructFontButtonModal :: (IsFontButton o, MonadIO m) => Bool -> m (GValueConstruct o)
- getFontButtonModal :: (MonadIO m, IsFontButton o) => o -> m Bool
- setFontButtonModal :: (MonadIO m, IsFontButton o) => o -> Bool -> m ()
- constructFontButtonTitle :: (IsFontButton o, MonadIO m) => Text -> m (GValueConstruct o)
- getFontButtonTitle :: (MonadIO m, IsFontButton o) => o -> m Text
- setFontButtonTitle :: (MonadIO m, IsFontButton o) => o -> Text -> m ()
- constructFontButtonUseFont :: (IsFontButton o, MonadIO m) => Bool -> m (GValueConstruct o)
- getFontButtonUseFont :: (MonadIO m, IsFontButton o) => o -> m Bool
- setFontButtonUseFont :: (MonadIO m, IsFontButton o) => o -> Bool -> m ()
- constructFontButtonUseSize :: (IsFontButton o, MonadIO m) => Bool -> m (GValueConstruct o)
- getFontButtonUseSize :: (MonadIO m, IsFontButton o) => o -> m Bool
- setFontButtonUseSize :: (MonadIO m, IsFontButton o) => o -> Bool -> m ()
- type FontButtonActivateCallback = IO ()
- afterFontButtonActivate :: (IsFontButton a, MonadIO m) => a -> ((?self :: a) => FontButtonActivateCallback) -> m SignalHandlerId
- onFontButtonActivate :: (IsFontButton a, MonadIO m) => a -> ((?self :: a) => FontButtonActivateCallback) -> m SignalHandlerId
- type FontButtonFontSetCallback = IO ()
- afterFontButtonFontSet :: (IsFontButton a, MonadIO m) => a -> ((?self :: a) => FontButtonFontSetCallback) -> m SignalHandlerId
- onFontButtonFontSet :: (IsFontButton a, MonadIO m) => a -> ((?self :: a) => FontButtonFontSetCallback) -> m SignalHandlerId
Exported types
newtype FontButton Source #
Memory-managed wrapper type.
FontButton (ManagedPtr FontButton) |
Instances
Eq FontButton Source # | |
Defined in GI.Gtk.Objects.FontButton (==) :: FontButton -> FontButton -> Bool # (/=) :: FontButton -> FontButton -> Bool # | |
GObject FontButton Source # | |
Defined in GI.Gtk.Objects.FontButton | |
ManagedPtrNewtype FontButton Source # | |
Defined in GI.Gtk.Objects.FontButton toManagedPtr :: FontButton -> ManagedPtr FontButton | |
TypedObject FontButton Source # | |
Defined in GI.Gtk.Objects.FontButton | |
HasParentTypes FontButton Source # | |
Defined in GI.Gtk.Objects.FontButton | |
IsGValue (Maybe FontButton) Source # | Convert |
Defined in GI.Gtk.Objects.FontButton gvalueGType_ :: IO GType gvalueSet_ :: Ptr GValue -> Maybe FontButton -> IO () gvalueGet_ :: Ptr GValue -> IO (Maybe FontButton) | |
type ParentTypes FontButton Source # | |
Defined in GI.Gtk.Objects.FontButton type ParentTypes FontButton = '[Widget, Object, Accessible, Buildable, ConstraintTarget, FontChooser] |
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 # | |
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
.
Methods
Click to display all available methods, including inherited ones
Methods
actionSetEnabled, activate, activateAction, activateDefault, addController, addCssClass, addMnemonicLabel, addTickCallback, allocate, bindProperty, bindPropertyFull, childFocus, computeBounds, computeExpand, computePoint, computeTransform, contains, createPangoContext, createPangoLayout, disposeTemplate, dragCheckThreshold, errorBell, forceFloating, freezeNotify, getv, grabFocus, hasCssClass, hasDefault, hasFocus, hasVisibleFocus, hide, inDestruction, initTemplate, insertActionGroup, insertAfter, insertBefore, isAncestor, isDrawable, isFloating, isFocus, isSensitive, isVisible, keynavFailed, listMnemonicLabels, map, measure, mnemonicActivate, notify, notifyByPspec, observeChildren, observeControllers, pick, queueAllocate, queueDraw, queueResize, realize, ref, refSink, removeController, removeCssClass, removeMnemonicLabel, removeTickCallback, resetProperty, resetRelation, resetState, runDispose, shouldLayout, show, sizeAllocate, snapshotChild, stealData, stealQdata, thawNotify, translateCoordinates, triggerTooltipQuery, unmap, unparent, unrealize, unref, unsetStateFlags, updateProperty, updateRelation, updateState, watchClosure.
Getters
getAccessibleRole, getAllocatedBaseline, getAllocatedHeight, getAllocatedWidth, getAllocation, getAncestor, getBuildableId, getCanFocus, getCanTarget, getChildVisible, getClipboard, getCssClasses, getCssName, getCursor, getData, getDirection, getDisplay, getFirstChild, getFocusChild, getFocusOnClick, getFocusable, getFont, getFontDesc, getFontFace, getFontFamily, getFontFeatures, getFontMap, getFontOptions, getFontSize, getFrameClock, getHalign, getHasTooltip, getHeight, getHexpand, getHexpandSet, getLanguage, getLastChild, getLayoutManager, getLevel, getMapped, getMarginBottom, getMarginEnd, getMarginStart, getMarginTop, getModal, getName, getNative, getNextSibling, getOpacity, getOverflow, getPangoContext, getParent, getPreferredSize, getPrevSibling, getPreviewText, getPrimaryClipboard, getProperty, getQdata, getRealized, getReceivesDefault, getRequestMode, getRoot, getScaleFactor, getSensitive, getSettings, getShowPreviewEntry, getSize, getSizeRequest, getStateFlags, getStyleContext, getTemplateChild, getTitle, getTooltipMarkup, getTooltipText, getUseFont, getUseSize, getValign, getVexpand, getVexpandSet, getVisible, getWidth.
Setters
setCanFocus, setCanTarget, setChildVisible, setCssClasses, setCursor, setCursorFromName, setData, setDataFull, setDirection, setFilterFunc, setFocusChild, setFocusOnClick, setFocusable, setFont, setFontDesc, setFontMap, setFontOptions, setHalign, setHasTooltip, setHexpand, setHexpandSet, setLanguage, setLayoutManager, setLevel, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setModal, setName, setOpacity, setOverflow, setParent, setPreviewText, setProperty, setReceivesDefault, setSensitive, setShowPreviewEntry, setSizeRequest, setStateFlags, setTitle, setTooltipMarkup, setTooltipText, setUseFont, setUseSize, setValign, setVexpand, setVexpandSet, setVisible.
getModal
:: (HasCallStack, MonadIO m, IsFontButton a) | |
=> a |
|
-> m Bool | Returns: |
Gets whether the dialog is modal.
getTitle
:: (HasCallStack, MonadIO m, IsFontButton a) | |
=> a |
|
-> m Text | Returns: an internal copy of the title string which must not be freed. |
Retrieves the title of the font chooser dialog.
getUseFont
:: (HasCallStack, MonadIO m, IsFontButton a) | |
=> a |
|
-> m Bool | Returns: whether the selected font is used in the label. |
Returns whether the selected font is used in the label.
getUseSize
:: (HasCallStack, MonadIO m, IsFontButton a) | |
=> a |
|
-> m Bool | Returns: whether the selected size is used in the label. |
Returns whether the selected size is used in the label.
new
:: (HasCallStack, MonadIO m) | |
=> m FontButton | Returns: a new font picker widget. |
Creates a new font picker widget.
newWithFont
fontButtonNewWithFont Source #
:: (HasCallStack, MonadIO m) | |
=> Text |
|
-> m FontButton | Returns: a new font picker widget. |
Creates a new font picker widget showing the given font.
setModal
:: (HasCallStack, MonadIO m, IsFontButton a) | |
=> a |
|
-> Bool |
|
-> m () |
Sets whether the dialog should be modal.
setTitle
:: (HasCallStack, MonadIO m, IsFontButton a) | |
=> a |
|
-> Text |
|
-> m () |
Sets the title for the font chooser dialog.
setUseFont
:: (HasCallStack, MonadIO m, IsFontButton a) | |
=> a |
|
-> Bool |
|
-> m () |
If useFont
is True
, the font name will be written
using the selected font.
setUseSize
:: (HasCallStack, MonadIO m, IsFontButton a) | |
=> a |
|
-> Bool |
|
-> m () |
If useSize
is True
, the font name will be written using
the selected size.
Properties
modal
Whether the font chooser dialog should be modal.
constructFontButtonModal :: (IsFontButton o, MonadIO m) => Bool -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “modal
” property. This is rarely needed directly, but it is used by new
.
getFontButtonModal :: (MonadIO m, IsFontButton o) => o -> m Bool Source #
Get the value of the “modal
” property.
When overloading is enabled, this is equivalent to
get
fontButton #modal
setFontButtonModal :: (MonadIO m, IsFontButton o) => o -> Bool -> m () Source #
Set the value of the “modal
” property.
When overloading is enabled, this is equivalent to
set
fontButton [ #modal:=
value ]
title
The title of the font chooser dialog.
constructFontButtonTitle :: (IsFontButton o, MonadIO m) => Text -> m (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
Whether the buttons label will be drawn in the selected font.
constructFontButtonUseFont :: (IsFontButton o, MonadIO m) => Bool -> m (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
Whether the buttons label will use the selected font size.
constructFontButtonUseSize :: (IsFontButton o, MonadIO m) => Bool -> m (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
activate
type FontButtonActivateCallback = IO () Source #
Emitted to when the font button is activated.
The ::activate
signal on GtkFontButton
is an action signal and
emitting it causes the button to present its dialog.
Since: 4.4
afterFontButtonActivate :: (IsFontButton a, MonadIO m) => a -> ((?self :: a) => FontButtonActivateCallback) -> m SignalHandlerId Source #
Connect a signal handler for the activate signal, to be run after the default handler. When overloading is enabled, this is equivalent to
after
fontButton #activate callback
By default the object invoking the signal is not passed to the callback.
If you need to access it, you can use the implit ?self
parameter.
Note that this requires activating the ImplicitParams
GHC extension.
onFontButtonActivate :: (IsFontButton a, MonadIO m) => a -> ((?self :: a) => FontButtonActivateCallback) -> m SignalHandlerId Source #
Connect a signal handler for the activate signal, to be run before the default handler. When overloading is enabled, this is equivalent to
on
fontButton #activate callback
fontSet
type FontButtonFontSetCallback = IO () Source #
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 notifyfont signal.
afterFontButtonFontSet :: (IsFontButton a, MonadIO m) => a -> ((?self :: a) => FontButtonFontSetCallback) -> m SignalHandlerId Source #
Connect a signal handler for the fontSet signal, to be run after the default handler. When overloading is enabled, this is equivalent to
after
fontButton #fontSet callback
By default the object invoking the signal is not passed to the callback.
If you need to access it, you can use the implit ?self
parameter.
Note that this requires activating the ImplicitParams
GHC extension.
onFontButtonFontSet :: (IsFontButton a, MonadIO m) => a -> ((?self :: a) => FontButtonFontSetCallback) -> m SignalHandlerId Source #
Connect a signal handler for the fontSet signal, to be run before the default handler. When overloading is enabled, this is equivalent to
on
fontButton #fontSet callback