GtkFontButton

A button that launches a font selection dialog.

Object Hierarchy

GObject
`-- GtkObject
       `-- GtkWidget
              `-- GtkContainer
                     `-- GtkBin
                            `-- GtkButton
                                   `-- GtkFontButton

Description

This button is very similar to the GtkColorButton or the GtkFileChooserButton. The two functions of this button are to display the current font selected, and to launch a font selection dialog when clicked.

When clicked the GtkFontButton, will launch a GtkFontSelectionDialog. You may set many of the dialog's properties using its methods. The button is most suitable in preference dialogs, where you need the user to select a font.

Constructors

-- Creates a new GtkFontButton.

GtkFontButton::new_with_font (string fontname);

-- Create a new GtkFontButton with a preset font selected.

Methods

get_font_name()
  Retrieves the name of the font selected.
get_show_size()
  Returns whether the font size is displayed on the label.
get_show_style()
  Returns whether the font style is displayed on the label.
get_title()
  Retrieves the title of the resulting font selection dialog.
get_use_font()
  Returns whether the selected font is used by the button.
get_use_size()
  Returns whether the selected font size is used by the button.
set_font_name()
  Sets the font used by the button.
set_show_size()
  Sets whether the font size will be shown on the button.
set_show_style()
  Sets whether the font style will be shown on the button.
set_title()
  Sets the title of the resulting font selection dialog.
set_use_font()
  Sets whether the font button will use the selected font.
set_use_size()
  Sets whether the font button will use the selected font size.

Signals

"font-set"
  Emitted when the user selects a font.