## GimpFontSelectButton

GimpFontSelectButton —

## Synopsis

                GimpFontSelectButton;
    GtkWidget*  gimp_font_select_button_new     (const gchar *title,
                                                 const gchar *font_name);
    const gchar* gimp_font_select_button_get_font_name
                                                (GimpFontSelectButton *button);
    void        gimp_font_select_button_set_font_name
                                                (GimpFontSelectButton *button,
                                                 const gchar *font_name);
    void        gimp_font_select_button_close_popup
                                                (GimpFontSelectButton *button);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkButton
                                           +----GimpFontSelectButton

## Implemented Interfaces

GimpFontSelectButton implements AtkImplementorIface.

## Properties

      "font-name"            gchararray            : Read / Write
      "title"                gchararray            : Read / Write / Construct Only

## Signals

    "font-set"  void        user_function      (GimpFontSelectButton *widget,
                                                gchar                *font_name,
                                                gboolean              dialog_closing,
                                                gpointer              user_data)           : Run first

## Description

## Details

### GimpFontSelectButton

    typedef struct _GimpFontSelectButton GimpFontSelectButton;

### gimp_font_select_button_new ()

    GtkWidget*  gimp_font_select_button_new     (const gchar *title,
                                                 const gchar *font_name);

Creates a new GtkWidget that completely controls the selection of a font. This widget is suitable for placement in a table in a plug-in dialog.

`title` : | Title of the dialog to use or `NULL` means to use the default title.
`font_name` : | Initial font name.
Returns : | A GtkWidget that you can use in your UI.

### gimp_font_select_button_get_font_name ()

    const gchar* gimp_font_select_button_get_font_name
                                                (GimpFontSelectButton *button);

Retrieves the name of currently selected font.

`button` : | A GimpFontSelectButton
Returns : | an internal copy of the font name which must not be freed.

Since 2.4

### gimp_font_select_button_set_font_name ()

    void        gimp_font_select_button_set_font_name
                                                (GimpFontSelectButton *button,
                                                 const gchar *font_name);

Sets the current font for the font select button.

`button` : | A GimpFontSelectButton
`font_name` : | Font name to set; `NULL` means no change.

Since 2.4

### gimp_font_select_button_close_popup ()

    void        gimp_font_select_button_close_popup
                                                (GimpFontSelectButton *button);

Closes the popup window associated with `button`.

`button` : | A GimpFontSelectButton

## Property Details

### The "`font-name`" property

      "font-name"            gchararray            : Read / Write

The name of the currently selected font.

Default value: "Sans"

Since 2.4

### The "`title`" property

      "title"                gchararray            : Read / Write / Construct Only

The title to be used for the font selection dialog.

Default value: "Font Selection"

Since GIMP 2.4

## Signal Details

### The "font-set" signal

    void        user_function                  (GimpFontSelectButton *widget,
                                                gchar                *font_name,
                                                gboolean              dialog_closing,
                                                gpointer              user_data)           : Run first

The ::font-set signal is emitted when the user selects a font.

`widget` : | the object which received the signal.
`font_name` : | the name of the currently selected font.
`dialog_closing` : | whether the dialog was closed or not.
`user_data` : | user data set when the signal handler was connected.

Since 2.4