_
SelectionThis 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.
Widget Hierarchy |
---|
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_Font_Selection_Dialog (see section Package Gtk.Font_Selection_Dialog) |
Types |
---|
type Gtk_Font_Filter_Type is (Font_Filter_Base, Font_Filter_User); | |
These are the two types of filter available - base and user. The
base filter is set by the application and can't be changed by the
user.
| |
type Gtk_Font_Metric_Type is (Font_Metric_Pixels, Font_Metric_Points); | |
Used to determine whether point or pixel sizes are used.
| |
subtype Gtk_Font_Type is Gint; | |
Used for determining the type of a font style (bitmap, scalable,...),
and also for setting filters. These can be combined if a style has
bitmaps and scalable fonts available.
|
Subprograms |
---|
Font_Selection functions | ||
procedure Gtk_New (Widget : out Gtk_Font_Selection); | ||
Create a new font selection widget. | ||
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. | ||
function Get_Font (Fontsel : access Gtk_Font_Selection_Record) return Gdk.Font.Gdk_Font; | ||
Allocate and return the font selected by the user. | ||
function Set_Font_Name (Fontsel : access Gtk_Font_Selection_Record; Fontname : in String) return Boolean; | ||
Set the name and attributes of the selected font in Fontsel. | ||
procedure Set_Filter (Fsd : access Gtk_Font_Selection_Record; Filter_Type : in Gtk_Font_Filter_Type; Font_Type : in Gtk_Font_Type := Font_All; Foundries : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Weights : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Slants : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Setwidths : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Spacings : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Charsets : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array); | ||
Set up one of the filters used to display the fonts. | ||
function Get_Preview_Text (Fontsel : access Gtk_Font_Selection_Record) return String; | ||
Return the string used to preview the selected font in the dialog.
| ||
procedure Set_Preview_Text (Fontsel : access Gtk_Font_Selection_Record; Text : in 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 : in String); | ||
Create a new dialog to select a font. | ||
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. | ||
function Get_Font (Fsd : access Gtk_Font_Selection_Dialog_Record) return Gdk.Font.Gdk_Font; | ||
Allocate and return the font selected by the user. | ||
function Set_Font_Name (Fsd : access Gtk_Font_Selection_Dialog_Record; Fontname : in String) return Boolean; | ||
Set the name and attributes of the selected font in Fontsel. | ||
procedure Set_Filter (Fsd : access Gtk_Font_Selection_Dialog_Record; Filter_Type : in Gtk_Font_Filter_Type; Font_Type : in Gtk_Font_Type := Font_All; Foundries : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Weights : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Slants : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Setwidths : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Spacings : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array; Charsets : in Gtkada.Types.Chars_Ptr_Array := Gtkada.Types.Null_Array); | ||
Set up one of the filters used to display the fonts. | ||
function Get_Preview_Text (Fsd : access Gtk_Font_Selection_Dialog_Record) return 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 : in 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. | ||
function Get_OK_Button (Fsd : access Gtk_Font_Selection_Dialog_Record) return Gtk.Button.Gtk_Button; | ||
Return the Id of the Ok button. | ||
function Get_Apply_Button (Fsd : access Gtk_Font_Selection_Dialog_Record) return Gtk.Button.Gtk_Button; | ||
Return the Id of the Apply button. |