GtkFontButton: GTK+ 4 Reference Manual

## GtkFontButton GtkFontButton — A button to launch a font chooser dialog |

## Functions

GtkWidget * | gtk_font_button_new ()
GtkWidget * | gtk_font_button_new_with_font ()
gboolean | gtk_font_button_set_font_name ()
const gchar * | gtk_font_button_get_font_name ()
void | gtk_font_button_set_show_style ()
gboolean | gtk_font_button_get_show_style ()
void | gtk_font_button_set_show_size ()
gboolean | gtk_font_button_get_show_size ()
void | gtk_font_button_set_use_font ()
gboolean | gtk_font_button_get_use_font ()
void | gtk_font_button_set_use_size ()
gboolean | gtk_font_button_get_use_size ()
void | gtk_font_button_set_title ()
const gchar * | gtk_font_button_get_title ()

## Types and Values

struct | GtkFontButton

## Includes

    #include <gtk/gtk.h>

## Description

The GtkFontButton 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 fontbutton.

## Functions

### gtk_font_button_new ()

    GtkWidget *
    gtk_font_button_new (void);

Creates a new font picker widget.

#### Returns

a new font picker widget.

Since: 2.4

### gtk_font_button_new_with_font ()

    GtkWidget *
    gtk_font_button_new_with_font (const gchar *fontname);

Creates a new font picker widget.

#### Parameters

fontname | Name of font to display in font chooser dialog |

#### Returns

a new font picker widget.

Since: 2.4

### gtk_font_button_set_font_name ()

    gboolean
    gtk_font_button_set_font_name (GtkFontButton *font_button,
                                   const gchar *fontname);

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

#### Parameters

font_button | a GtkFontButton |
fontname | Name of font to display in font chooser dialog |

#### Returns

`TRUE`

Since: 2.4

### gtk_font_button_get_font_name ()

    const gchar *
    gtk_font_button_get_font_name (GtkFontButton *font_button);

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 `pango_font_description_from_string()` . If you’re interested in peeking certain values (family name, style, size, weight) just query these properties from the PangoFontDescription object.

#### Parameters

font_button | a GtkFontButton |

#### Returns

an internal copy of the font name which must not be freed.

Since: 2.4

### gtk_font_button_set_show_style ()

    void
    gtk_font_button_set_show_style (GtkFontButton *font_button,
                                    gboolean show_style);

If `show_style` is `TRUE`, the font style will be displayed along with name of the selected font.

#### Parameters

font_button | a GtkFontButton |
show_style | `TRUE` if font style should be displayed in label. |

Since: 2.4

### gtk_font_button_get_show_style ()

    gboolean
    gtk_font_button_get_show_style (GtkFontButton *font_button);

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

#### Parameters

font_button | a GtkFontButton |

#### Returns

whether the font style will be shown in the label.

Since: 2.4

### gtk_font_button_set_show_size ()

    void
    gtk_font_button_set_show_size (GtkFontButton *font_button,
                                   gboolean show_size);

If `show_size` is `TRUE`, the font size will be displayed along with the name of the selected font.

#### Parameters

font_button | a GtkFontButton |
show_size | `TRUE` if font size should be displayed in dialog. |

Since: 2.4

### gtk_font_button_get_show_size ()

    gboolean
    gtk_font_button_get_show_size (GtkFontButton *font_button);

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

#### Parameters

font_button | a GtkFontButton |

#### Returns

whether the font size will be shown in the label.

Since: 2.4

### gtk_font_button_set_use_font ()

    void
    gtk_font_button_set_use_font (GtkFontButton *font_button,
                                  gboolean use_font);

If `use_font` is `TRUE`, the font name will be written using the selected font.

#### Parameters

font_button | a GtkFontButton |
use_font | If `TRUE`, font name will be written using font chosen. |

Since: 2.4

### gtk_font_button_get_use_font ()

    gboolean
    gtk_font_button_get_use_font (GtkFontButton *font_button);

Returns whether the selected font is used in the label.

#### Parameters

font_button | a GtkFontButton |

#### Returns

whether the selected font is used in the label.

Since: 2.4

### gtk_font_button_set_use_size ()

    void
    gtk_font_button_set_use_size (GtkFontButton *font_button,
                                  gboolean use_size);

If `use_size` is `TRUE`, the font name will be written using the selected size.

#### Parameters

font_button | a GtkFontButton |
use_size | If `TRUE`, font name will be written using the selected size. |

Since: 2.4

### gtk_font_button_get_use_size ()

    gboolean
    gtk_font_button_get_use_size (GtkFontButton *font_button);

Returns whether the selected size is used in the label.

#### Parameters

font_button | a GtkFontButton |

#### Returns

whether the selected size is used in the label.

Since: 2.4

### gtk_font_button_set_title ()

    void
    gtk_font_button_set_title (GtkFontButton *font_button,
                               const gchar *title);

Sets the title for the font chooser dialog.

#### Parameters

font_button | a GtkFontButton |
title | a string containing the font chooser dialog title |

Since: 2.4

### gtk_font_button_get_title ()

    const gchar *
    gtk_font_button_get_title (GtkFontButton *font_button);

Retrieves the title of the font chooser dialog.

#### Parameters

font_button | a GtkFontButton |

#### Returns

an internal copy of the title string which must not be freed.

Since: 2.4

## Types and Values

### struct GtkFontButton

    struct GtkFontButton {
      GtkWidget parent_instance;
    };

## See Also

GtkFontChooserDialog, GtkColorButton.