GtkAda Reference Manual - Package Gtk.Font_Selection

[Contents] [Back] [Prev] [Up] [Next] [Forward]

# Package Gtk.Font`_`Selection

This widget provides a nice way for the user of your application to select fonts. It first searches on your system for the list of fonts available, and displays a set of boxes to select them based on their name, their weight, their size, etc. This widget is provided in two forms, one widget that can be embedded in any container, a Gtk_Font_Selection, whereas the other one comes directly in its own separate window (to be popped up as a dialog).

Some filters can be applied to the widget, when you want the user to select only a font only among a specific subset (like bitmap or true-type fonts for instance). There are two kinds of filters: a base filter, set in your application and that the user can not change; a user filter that can be modified interactively by the user.

- Gtk.Font_Selection Widget Hierarchy
- Gtk.Font_Selection Subprograms

## Widget Hierarchy

    GObject                       (see section Package Glib.Object)
    Gtk_Object                    (see section Package Gtk.Object)
       \___ Gtk_Widget            (see section Package Gtk.Widget)
          \___ Gtk_Container      (see section Package Gtk.Container)
             \___ Gtk_Bin         (see section Package Gtk.Bin)
                \___ Gtk_Window   (see section Package Gtk.Window)
                   \___ Gtk_Dialog (see section Package Gtk.Dialog)
                      \___ Gtk_Font_Selection_Dialog (see section Package Gtk.Font_Selection_Dialog)

## Subprograms

### Font_Selection functions
    procedure Gtk_New
      (Widget             : out    Gtk_Font_Selection);
| Create a new font selection widget. It can be added to any existing container.
    function Get_Type              return Gtk.Gtk_Type;
| Return the internal value associated with a Gtk_Font_Selection.
    function Get_Font_Name
      (Fontsel            : access Gtk_Font_Selection_Record)
       return String;
| Return the name of the font selected by the user. It returns an empty string if not font is selected. The string has the same format as in Pango.Font.
    function Set_Font_Name
      (Fontsel            : access Gtk_Font_Selection_Record;
       Fontname           :        String)
       return Boolean;
| Set the name and attributes of the selected font in Fontsel. Fontname should have the format described in Pango.Font. Fontself must have been displayed on the screen already
    function Get_Preview_Text
      (Fontsel            : access Gtk_Font_Selection_Record)
       return UTF8_String;
| Return the string used to preview the selected font in the dialog.
    procedure Set_Preview_Text
      (Fontsel            : access Gtk_Font_Selection_Record;
       Text               :        UTF8_String);
| Set the string to use to preview the selected font.
### Font_Selection_Dialog functions
    procedure Gtk_New
      (Widget             : out    Gtk_Font_Selection_Dialog;
       Title              :        UTF8_String);
| Create a new dialog to select a font. The font selection widget has its own window, whose title is chosen by Title.
    function Dialog_Get_Type       return Gtk.Gtk_Type;
| Return the internal value associated with a Gtk_Font_Selection_Dialog.
    function Get_Font_Name
      (Fsd                : access Gtk_Font_Selection_Dialog_Record)
       return String;
| Return the name of the font selected by the user. It returns an empty string if not font is selected. The string has the same format as excepted in the Gdk.Font package. This is also the standard format on X11 systems.
    function Set_Font_Name
      (Fsd                : access Gtk_Font_Selection_Dialog_Record;
       Fontname           :        String)
       return Boolean;
| Set the name and attributes of the selected font in Fontsel. Fontname should have the standard format on X11 systems, that fully describe the family, weight, size, slant, etc. of the font.
    function Get_Preview_Text
      (Fsd                : access Gtk_Font_Selection_Dialog_Record)
       return UTF8_String;
| Return the string used to preview the selected font in the dialog.
    procedure Set_Preview_Text
      (Fsd                : access Gtk_Font_Selection_Dialog_Record;
       Text               :        UTF8_String);
| Set the string to use to preview the selected font.
    function Get_Cancel_Button
      (Fsd                : access Gtk_Font_Selection_Dialog_Record)
       return Gtk.Button.Gtk_Button;
| Return the Id of the cancel button of the dialog. You can use this to set up a callback on that button. The callback should close the dialog, and ignore any value that has been set in it.
    function Get_OK_Button
      (Fsd                : access Gtk_Font_Selection_Dialog_Record)
       return Gtk.Button.Gtk_Button;
| Return the Id of the Ok button. The callback set on this button should close the dialog if the selected font is valid, and do whatever if should with it.
    function Get_Apply_Button
      (Fsd                : access Gtk_Font_Selection_Dialog_Record)
       return Gtk.Button.Gtk_Button;
| Return the Id of the Apply button. The callback on this button should temporarily apply the font, but should be able to cancel its effect if the Cancel button is selected.

[Contents] [Back] [Prev] [Up] [Next] [Forward]