FontButton

The gtk.font_button.FontButton 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]

gtk.font_button.FontButton has a single CSS node with name fontbutton which contains a button node with the .font style class.

More...

class FontButton : Widget , FontChooser {

this();

static gtk.font_button.FontButton newWithFont(string fontname);

void setModal(bool modal);

void setTitle(string title);

void setUseFont(bool useFont);

void setUseSize(bool useSize);

ulong connectActivate(T callback, Flag!"After" after);

ulong connectFontSet(T callback, Flag!"After" after);

}

Constructors

this this(): Creates a new font picker widget.

Members

Functions

connectActivate ulong connectActivate(T callback, Flag!"After" after): Connect to Activate signal.
connectFontSet ulong connectFontSet(T callback, Flag!"After" after): Connect to FontSet signal.
getModal bool getModal(): Gets whether the dialog is modal.
getTitle string getTitle(): Retrieves the title of the font chooser dialog.
getUseFont bool getUseFont(): Returns whether the selected font is used in the label.
getUseSize bool getUseSize(): Returns whether the selected size is used in the label.
setModal void setModal(bool modal): Sets whether the dialog should be modal.
setTitle void setTitle(string title): Sets the title for the font chooser dialog.
setUseFont void setUseFont(bool useFont): If use_font is true, the font name will be written using the selected font.
setUseSize void setUseSize(bool useSize): If use_size is true, the font name will be written using the selected size.

Static functions

newWithFont gtk.font_button.FontButton newWithFont(string fontname): Creates a new font picker widget showing the given font.

Mixed In Members

From `mixin FontChooserT!()`

getFont string getFont(): Gets the currently-selected font name.
getFontDesc pango.font_description.FontDescription getFontDesc(): Gets the currently-selected font.
getFontFace pango.font_face.FontFace getFontFace(): Gets the pango.font_face.FontFace representing the selected font group details (i.e. family, slant, weight, width, etc).
getFontFamily pango.font_family.FontFamily getFontFamily(): Gets the pango.font_family.FontFamily representing the selected font family.
getFontFeatures string getFontFeatures(): Gets the currently-selected font features.
getFontMap pango.font_map.FontMap getFontMap(): Gets the custom font map of this font chooser widget, or null if it does not have one.
getFontSize int getFontSize(): The selected font size.
getLanguage string getLanguage(): Gets the language that is used for font features.
getLevel gtk.types.FontChooserLevel getLevel(): Returns the current level of granularity for selecting fonts.
getPreviewText string getPreviewText(): Gets the text displayed in the preview area.
getShowPreviewEntry bool getShowPreviewEntry(): Returns whether the preview entry is shown or not.
setFilterFunc void setFilterFunc(gtk.types.FontFilterFunc filter): Adds a filter function that decides which fonts to display in the font chooser.
setFont void setFont(string fontname): Sets the currently-selected font.
setFontDesc void setFontDesc(pango.font_description.FontDescription fontDesc): Sets the currently-selected font from font_desc.
setFontMap void setFontMap(pango.font_map.FontMap fontmap): Sets a custom font map to use for this font chooser widget.
setLanguage void setLanguage(string language): Sets the language to use for font features.
setLevel void setLevel(gtk.types.FontChooserLevel level): Sets the desired level of granularity for selecting fonts.
setPreviewText void setPreviewText(string text): Sets the text displayed in the preview area.
setShowPreviewEntry void setShowPreviewEntry(bool showPreviewEntry): Shows or hides the editable preview entry.
connectFontActivated ulong connectFontActivated(T callback, Flag!"After" after): Connect to FontActivated signal.

Inherited Members

getDefaultDirection gtk.types.TextDirection getDefaultDirection(): Obtains the current default reading direction.
setDefaultDirection void setDefaultDirection(gtk.types.TextDirection dir): Sets the default reading direction for widgets.
actionSetEnabled void actionSetEnabled(string actionName, bool enabled): Enable or disable an action installed with gtk.widget_class.WidgetClass.installAction.
activate bool activate(): For widgets that can be “activated” (buttons, menu items, etc.), this function activates them.
activateAction bool activateAction(string name, glib.variant.VariantG args): Looks up the action in the action groups associated with widget and its ancestors, and activates it.
activateDefault void activateDefault(): Activates the default.activate action from widget.
addController void addController(gtk.event_controller.EventController controller): Adds controller to widget so that it will receive events.
addCssClass void addCssClass(string cssClass): Adds a style class to widget.
addMnemonicLabel void addMnemonicLabel(gtk.widget.Widget label): Adds a widget to the list of mnemonic labels for this widget.
addTickCallback uint addTickCallback(gtk.types.TickCallback callback): Queues an animation frame update and adds a callback to be called before each frame.
allocate void allocate(int width, int height, int baseline, gsk.transform.Transform transform): This function is only used by gtk.widget.Widget subclasses, to assign a size, position and (optionally) baseline to their child widgets.
childFocus bool childFocus(gtk.types.DirectionType direction): Called by widgets as the user moves around the window using keyboard shortcuts.
computeBounds bool computeBounds(gtk.widget.Widget target, graphene.rect.Rect outBounds): Computes the bounds for widget in the coordinate space of target.
computeExpand bool computeExpand(gtk.types.Orientation orientation): Computes whether a container should give this widget extra space when possible.
computePoint bool computePoint(gtk.widget.Widget target, graphene.point.Point point, graphene.point.Point outPoint): Translates the given point in widget's coordinates to coordinates relative to target’s coordinate system.
computeTransform bool computeTransform(gtk.widget.Widget target, graphene.matrix.Matrix outTransform): Computes a matrix suitable to describe a transformation from widget's coordinate system into target's coordinate system.
contains bool contains(double x, double y): Tests if the point at (x, y) is contained in widget.
createPangoContext pango.context.Context createPangoContext(): Creates a new pango.context.Context with the appropriate font map, font options, font description, and base direction for drawing text for this widget.
createPangoLayout pango.layout.Layout createPangoLayout(string text): Creates a new pango.layout.Layout with the appropriate font map, font description, and base direction for drawing text for this widget.
disposeTemplate void disposeTemplate(gobject.types.GType widgetType): Clears the template children for the given widget.
dragCheckThreshold bool dragCheckThreshold(int startX, int startY, int currentX, int currentY): Checks to see if a drag movement has passed the GTK drag threshold.
errorBell void errorBell(): Notifies the user about an input-related error on this widget.
getAllocatedBaseline int getAllocatedBaseline(): Returns the baseline that has currently been allocated to widget.
getAllocatedHeight int getAllocatedHeight(): Returns the height that has currently been allocated to widget.
getAllocatedWidth int getAllocatedWidth(): Returns the width that has currently been allocated to widget.
getAncestor gtk.widget.Widget getAncestor(gobject.types.GType widgetType): Gets the first ancestor of widget with type widget_type.
getBaseline int getBaseline(): Returns the baseline that has currently been allocated to widget.
getCanFocus bool getCanFocus(): Determines whether the input focus can enter widget or any of its children.
getCanTarget bool getCanTarget(): Queries whether widget can be the target of pointer events.
getChildVisible bool getChildVisible(): Gets the value set with gtk.widget.Widget.setChildVisible.
getClipboard gdk.clipboard.Clipboard getClipboard(): Gets the clipboard object for widget.
getColor void getColor(gdk.rgba.RGBA color): Gets the current foreground color for the widget’s CSS style.
getCssClasses string[] getCssClasses(): Returns the list of style classes applied to widget.
getCssName string getCssName(): Returns the CSS name that is used for self.
getCursor gdk.cursor.Cursor getCursor(): Queries the cursor set on widget.
getDirection gtk.types.TextDirection getDirection(): Gets the reading direction for a particular widget.
getDisplay gdk.display.Display getDisplay(): Get the gdk.display.Display for the toplevel window associated with this widget.
getFirstChild gtk.widget.Widget getFirstChild(): Returns the widget’s first child.
getFocusChild gtk.widget.Widget getFocusChild(): Returns the current focus child of widget.
getFocusOnClick bool getFocusOnClick(): Returns whether the widget should grab focus when it is clicked with the mouse.
getFocusable bool getFocusable(): Determines whether widget can own the input focus.
getFontMap pango.font_map.FontMap getFontMap(): Gets the font map of widget.
getFontOptions cairo.font_options.FontOptions getFontOptions(): Returns the cairo.font_options.FontOptions of widget.
getFrameClock gdk.frame_clock.FrameClock getFrameClock(): Obtains the frame clock for a widget.
getHalign gtk.types.Align getHalign(): Gets the horizontal alignment of widget.
getHasTooltip bool getHasTooltip(): Returns the current value of the has-tooltip property.
getHeight int getHeight(): Returns the content height of the widget.
getHexpand bool getHexpand(): Gets whether the widget would like any available extra horizontal space.
getHexpandSet bool getHexpandSet(): Gets whether gtk.widget.Widget.setHexpand has been used to explicitly set the expand flag on this widget.
getLastChild gtk.widget.Widget getLastChild(): Returns the widget’s last child.
getLayoutManager gtk.layout_manager.LayoutManager getLayoutManager(): Retrieves the layout manager used by widget.
getMapped bool getMapped(): Whether the widget is mapped.
getMarginBottom int getMarginBottom(): Gets the bottom margin of widget.
getMarginEnd int getMarginEnd(): Gets the end margin of widget.
getMarginStart int getMarginStart(): Gets the start margin of widget.
getMarginTop int getMarginTop(): Gets the top margin of widget.
getName string getName(): Retrieves the name of a widget.
getNative gtk.native.Native getNative(): Returns the nearest gtk.native.Native ancestor of widget.
getNextSibling gtk.widget.Widget getNextSibling(): Returns the widget’s next sibling.
getOpacity double getOpacity(): #Fetches the requested opacity for this widget.
getOverflow gtk.types.Overflow getOverflow(): Returns the widget’s overflow value.
getPangoContext pango.context.Context getPangoContext(): Gets a pango.context.Context with the appropriate font map, font description, and base direction for this widget.
getParent gtk.widget.Widget getParent(): Returns the parent widget of widget.
getPreferredSize void getPreferredSize(gtk.requisition.Requisition minimumSize, gtk.requisition.Requisition naturalSize): Retrieves the minimum and natural size of a widget, taking into account the widget’s preference for height-for-width management.
getPrevSibling gtk.widget.Widget getPrevSibling(): Returns the widget’s previous sibling.
getPrimaryClipboard gdk.clipboard.Clipboard getPrimaryClipboard(): Gets the primary clipboard of widget.
getRealized bool getRealized(): Determines whether widget is realized.
getReceivesDefault bool getReceivesDefault(): Determines whether widget is always treated as the default widget within its toplevel when it has the focus, even if another widget is the default.
getRequestMode gtk.types.SizeRequestMode getRequestMode(): Gets whether the widget prefers a height-for-width layout or a width-for-height layout.
getRoot gtk.root.Root getRoot(): Returns the gtk.root.Root widget of widget.
getScaleFactor int getScaleFactor(): Retrieves the internal scale factor that maps from window coordinates to the actual device pixels.
getSensitive bool getSensitive(): Returns the widget’s sensitivity.
getSettings gtk.settings.Settings getSettings(): Gets the settings object holding the settings used for this widget.
getSize int getSize(gtk.types.Orientation orientation): Returns the content width or height of the widget.
getSizeRequest void getSizeRequest(int width, int height): Gets the size request that was explicitly set for the widget using gtk.widget.Widget.setSizeRequest.
getStateFlags gtk.types.StateFlags getStateFlags(): Returns the widget state as a flag set.
getStyleContext gtk.style_context.StyleContext getStyleContext(): Returns the style context associated to widget.
getTemplateChild gobject.object.ObjectG getTemplateChild(gobject.types.GType widgetType, string name): Fetch an object build from the template XML for widget_type in this widget instance.
getTooltipMarkup string getTooltipMarkup(): Gets the contents of the tooltip for widget.
getTooltipText string getTooltipText(): Gets the contents of the tooltip for widget.
getValign gtk.types.Align getValign(): Gets the vertical alignment of widget.
getVexpand bool getVexpand(): Gets whether the widget would like any available extra vertical space.
getVexpandSet bool getVexpandSet(): Gets whether gtk.widget.Widget.setVexpand has been used to explicitly set the expand flag on this widget.
getVisible bool getVisible(): Determines whether the widget is visible.
getWidth int getWidth(): Returns the content width of the widget.
grabFocus bool grabFocus(): Causes widget to have the keyboard focus for the gtk.window.Window it's inside.
hasCssClass bool hasCssClass(string cssClass): Returns whether css_class is currently applied to widget.
hasDefault bool hasDefault(): Determines whether widget is the current default widget within its toplevel.
hasFocus bool hasFocus(): Determines if the widget has the global input focus.
hasVisibleFocus bool hasVisibleFocus(): Determines if the widget should show a visible indication that it has the global input focus.
hide void hide(): Reverses the effects of gtk.widget.Widget.show.
inDestruction bool inDestruction(): Returns whether the widget is currently being destroyed.
initTemplate void initTemplate(): Creates and initializes child widgets defined in templates.
insertActionGroup void insertActionGroup(string name, gio.action_group.ActionGroup group): Inserts group into widget.
insertAfter void insertAfter(gtk.widget.Widget parent, gtk.widget.Widget previousSibling): Inserts widget into the child widget list of parent.
insertBefore void insertBefore(gtk.widget.Widget parent, gtk.widget.Widget nextSibling): Inserts widget into the child widget list of parent.
isAncestor bool isAncestor(gtk.widget.Widget ancestor): Determines whether widget is somewhere inside ancestor, possibly with intermediate containers.
isDrawable bool isDrawable(): Determines whether widget can be drawn to.
isFocus bool isFocus(): Determines if the widget is the focus widget within its toplevel.
isSensitive bool isSensitive(): Returns the widget’s effective sensitivity.
isVisible bool isVisible(): Determines whether the widget and all its parents are marked as visible.
keynavFailed bool keynavFailed(gtk.types.DirectionType direction): Emits the ::keynav-failed signal on the widget.
listMnemonicLabels gtk.widget.Widget[] listMnemonicLabels(): Returns the widgets for which this widget is the target of a mnemonic.
map void map(): Causes a widget to be mapped if it isn’t already.
measure void measure(gtk.types.Orientation orientation, int forSize, int minimum, int natural, int minimumBaseline, int naturalBaseline): Measures widget in the orientation orientation and for the given for_size.
mnemonicActivate bool mnemonicActivate(bool groupCycling): Emits the ::mnemonic-activate signal.
observeChildren gio.list_model.ListModel observeChildren(): Returns a gio.list_model.ListModel to track the children of widget.
observeControllers gio.list_model.ListModel observeControllers(): Returns a gio.list_model.ListModel to track the gtk.event_controller.EventControllers of widget.
pick gtk.widget.Widget pick(double x, double y, gtk.types.PickFlags flags): Finds the descendant of widget closest to the point (x, y).
queueAllocate void queueAllocate(): Flags the widget for a rerun of the vfuncGtk.Widget.size_allocate function.
queueDraw void queueDraw(): Schedules this widget to be redrawn in the paint phase of the current or the next frame.
queueResize void queueResize(): Flags a widget to have its size renegotiated.
realize void realize(): Creates the GDK resources associated with a widget.
removeController void removeController(gtk.event_controller.EventController controller): Removes controller from widget, so that it doesn't process events anymore.
removeCssClass void removeCssClass(string cssClass): Removes a style from widget.
removeMnemonicLabel void removeMnemonicLabel(gtk.widget.Widget label): Removes a widget from the list of mnemonic labels for this widget.
removeTickCallback void removeTickCallback(uint id): Removes a tick callback previously registered with gtk.widget.Widget.addTickCallback.
setCanFocus void setCanFocus(bool canFocus): Specifies whether the input focus can enter the widget or any of its children.
setCanTarget void setCanTarget(bool canTarget): Sets whether widget can be the target of pointer events.
setChildVisible void setChildVisible(bool childVisible): Sets whether widget should be mapped along with its parent.
setCssClasses void setCssClasses(string[] classes): Clear all style classes applied to widget and replace them with classes.
setCursor void setCursor(gdk.cursor.Cursor cursor): Sets the cursor to be shown when pointer devices point towards widget.
setCursorFromName void setCursorFromName(string name): Sets a named cursor to be shown when pointer devices point towards widget.
setDirection void setDirection(gtk.types.TextDirection dir): Sets the reading direction on a particular widget.
setFocusChild void setFocusChild(gtk.widget.Widget child): Set child as the current focus child of widget.
setFocusOnClick void setFocusOnClick(bool focusOnClick): Sets whether the widget should grab focus when it is clicked with the mouse.
setFocusable void setFocusable(bool focusable): Specifies whether widget can own the input focus.
setFontMap void setFontMap(pango.font_map.FontMap fontMap): Sets the font map to use for Pango rendering.
setFontOptions void setFontOptions(cairo.font_options.FontOptions options): Sets the cairo.font_options.FontOptions used for Pango rendering in this widget.
setHalign void setHalign(gtk.types.Align align_): Sets the horizontal alignment of widget.
setHasTooltip void setHasTooltip(bool hasTooltip): Sets the has-tooltip property on widget to has_tooltip.
setHexpand void setHexpand(bool expand): Sets whether the widget would like any available extra horizontal space.
setHexpandSet void setHexpandSet(bool set): Sets whether the hexpand flag will be used.
setLayoutManager void setLayoutManager(gtk.layout_manager.LayoutManager layoutManager): Sets the layout manager delegate instance that provides an implementation for measuring and allocating the children of widget.
setMarginBottom void setMarginBottom(int margin): Sets the bottom margin of widget.
setMarginEnd void setMarginEnd(int margin): Sets the end margin of widget.
setMarginStart void setMarginStart(int margin): Sets the start margin of widget.
setMarginTop void setMarginTop(int margin): Sets the top margin of widget.
setName void setName(string name): Sets a widgets name.
setOpacity void setOpacity(double opacity): Request the widget to be rendered partially transparent.
setOverflow void setOverflow(gtk.types.Overflow overflow): Sets how widget treats content that is drawn outside the widget's content area.
setParent void setParent(gtk.widget.Widget parent): Sets parent as the parent widget of widget.
setReceivesDefault void setReceivesDefault(bool receivesDefault): Specifies whether widget will be treated as the default widget within its toplevel when it has the focus, even if another widget is the default.
setSensitive void setSensitive(bool sensitive): Sets the sensitivity of a widget.
setSizeRequest void setSizeRequest(int width, int height): Sets the minimum size of a widget.
setStateFlags void setStateFlags(gtk.types.StateFlags flags, bool clear): Turns on flag values in the current widget state.
setTooltipMarkup void setTooltipMarkup(string markup): Sets markup as the contents of the tooltip, which is marked up with Pango markup.
setTooltipText void setTooltipText(string text): Sets text as the contents of the tooltip.
setValign void setValign(gtk.types.Align align_): Sets the vertical alignment of widget.
setVexpand void setVexpand(bool expand): Sets whether the widget would like any available extra vertical space.
setVexpandSet void setVexpandSet(bool set): Sets whether the vexpand flag will be used.
setVisible void setVisible(bool visible): Sets the visibility state of widget.
shouldLayout bool shouldLayout(): Returns whether widget should contribute to the measuring and allocation of its parent.
show void show(): Flags a widget to be displayed.
snapshotChild void snapshotChild(gtk.widget.Widget child, gtk.snapshot.Snapshot snapshot): Snapshot the a child of widget.
translateCoordinates bool translateCoordinates(gtk.widget.Widget destWidget, double srcX, double srcY, double destX, double destY): Translate coordinates relative to src_widget’s allocation to coordinates relative to dest_widget’s allocations.
triggerTooltipQuery void triggerTooltipQuery(): Triggers a tooltip query on the display where the toplevel of widget is located.
unmap void unmap(): Causes a widget to be unmapped if it’s currently mapped.
unparent void unparent(): Dissociate widget from its parent.
unrealize void unrealize(): Causes a widget to be unrealized (frees all GDK resources associated with the widget).
unsetStateFlags void unsetStateFlags(gtk.types.StateFlags flags): Turns off flag values for the current widget state.
connectDestroy ulong connectDestroy(T callback, Flag!"After" after): Connect to Destroy signal.
connectDirectionChanged ulong connectDirectionChanged(T callback, Flag!"After" after): Connect to DirectionChanged signal.
connectHide ulong connectHide(T callback, Flag!"After" after): Connect to Hide signal.
connectKeynavFailed ulong connectKeynavFailed(T callback, Flag!"After" after): Connect to KeynavFailed signal.
connectMap ulong connectMap(T callback, Flag!"After" after): Connect to Map signal.
connectMnemonicActivate ulong connectMnemonicActivate(T callback, Flag!"After" after): Connect to MnemonicActivate signal.
connectMoveFocus ulong connectMoveFocus(T callback, Flag!"After" after): Connect to MoveFocus signal.
connectQueryTooltip ulong connectQueryTooltip(T callback, Flag!"After" after): Connect to QueryTooltip signal.
connectRealize ulong connectRealize(T callback, Flag!"After" after): Connect to Realize signal.
connectShow ulong connectShow(T callback, Flag!"After" after): Connect to Show signal.
connectStateFlagsChanged ulong connectStateFlagsChanged(T callback, Flag!"After" after): Connect to StateFlagsChanged signal.
connectUnmap ulong connectUnmap(T callback, Flag!"After" after): Connect to Unmap signal.
connectUnrealize ulong connectUnrealize(T callback, Flag!"After" after): Connect to Unrealize signal.

From FontChooser

getFont string getFont(): Gets the currently-selected font name.
getFontDesc pango.font_description.FontDescription getFontDesc(): Gets the currently-selected font.
getFontFace pango.font_face.FontFace getFontFace(): Gets the pango.font_face.FontFace representing the selected font group details (i.e. family, slant, weight, width, etc).
getFontFamily pango.font_family.FontFamily getFontFamily(): Gets the pango.font_family.FontFamily representing the selected font family.
getFontFeatures string getFontFeatures(): Gets the currently-selected font features.
getFontMap pango.font_map.FontMap getFontMap(): Gets the custom font map of this font chooser widget, or null if it does not have one.
getFontSize int getFontSize(): The selected font size.
getLanguage string getLanguage(): Gets the language that is used for font features.
getLevel gtk.types.FontChooserLevel getLevel(): Returns the current level of granularity for selecting fonts.
getPreviewText string getPreviewText(): Gets the text displayed in the preview area.
getShowPreviewEntry bool getShowPreviewEntry(): Returns whether the preview entry is shown or not.
setFilterFunc void setFilterFunc(gtk.types.FontFilterFunc filter): Adds a filter function that decides which fonts to display in the font chooser.
setFont void setFont(string fontname): Sets the currently-selected font.
setFontDesc void setFontDesc(pango.font_description.FontDescription fontDesc): Sets the currently-selected font from font_desc.
setFontMap void setFontMap(pango.font_map.FontMap fontmap): Sets a custom font map to use for this font chooser widget.
setLanguage void setLanguage(string language): Sets the language to use for font features.
setLevel void setLevel(gtk.types.FontChooserLevel level): Sets the desired level of granularity for selecting fonts.
setPreviewText void setPreviewText(string text): Sets the text displayed in the preview area.
setShowPreviewEntry void setShowPreviewEntry(bool showPreviewEntry): Shows or hides the editable preview entry.
connectFontActivated ulong connectFontActivated(T callback, Flag!"After" after): Connect to FontActivated signal.

Detailed Description

Deprecated: Use gtk.font_dialog_button.FontDialogButton instead

gtk font_button classes

FontButton

FontButton

CSS nodes

From mixin FontChooserT!()

From `mixin FontChooserT!()`