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
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkButton
                                 +----GimpFontSelectButton

Implemented Interfaces

GimpFontSelectButton implements AtkImplementorIface.

Properties


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

Signal Prototypes


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

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

Properties

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

Signals

The "font-set" signal

void        user_function                  (GimpFontSelectButton *widget,
                                            gchar *font_name,
                                            gboolean dialog_closing,
                                            gpointer user_data);

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