![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkFontSelectionDialog; GtkWidget* gtk_font_selection_dialog_new (constgchar *title);GdkFont * gtk_font_selection_dialog_get_font (GtkFontSelectionDialog *fsd);gchar * gtk_font_selection_dialog_get_font_name (GtkFontSelectionDialog *fsd);gboolean gtk_font_selection_dialog_set_font_name (GtkFontSelectionDialog *fsd, constgchar *fontname); constgchar * gtk_font_selection_dialog_get_preview_text (GtkFontSelectionDialog *fsd);void gtk_font_selection_dialog_set_preview_text (GtkFontSelectionDialog *fsd, constgchar *text);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----GtkDialog +----GtkFontSelectionDialog
The GtkFontSelectionDialog widget is a dialog box for selecting a font.
To set the font which is initially selected, use
gtk_font_selection_dialog_set_font_name()
.
To get the selected font use gtk_font_selection_dialog_get_font_name()
.
To change the text which is shown in the preview area, use
gtk_font_selection_dialog_set_preview_text()
.
typedef struct { GtkWidget *ok_button; GtkWidget *apply_button; GtkWidget *cancel_button; } GtkFontSelectionDialog;
GtkWidget* gtk_font_selection_dialog_new (constgchar *title);
Creates a new GtkFontSelectionDialog.
title : |
the title of the dialog box. |
Returns : | a new GtkFontSelectionDialog. |
GdkFont * gtk_font_selection_dialog_get_font (GtkFontSelectionDialog *fsd);
gtk_font_selection_dialog_get_font
is deprecated and should not be used in newly-written code.
Gets the currently-selected font.
fsd : |
a GtkFontSelectionDialog. |
Returns : | the currently-selected font, or NULL |
gchar * gtk_font_selection_dialog_get_font_name (GtkFontSelectionDialog *fsd);
Gets the currently-selected font name. Note that this can be a different
string than what you set with gtk_font_selection_dialog_set_font_name()
, as
the font selection widget may normalize font names and thus return a string
with a different structure. For example, "Helvetica Italic Bold 12" could be
normalized to "Helvetica Bold Italic 12". Use pango_font_description_equal()
fsd : |
a GtkFontSelectionDialog |
Returns : | A string with the name of the current font, or g_free() |
gboolean gtk_font_selection_dialog_set_font_name (GtkFontSelectionDialog *fsd, constgchar *fontname);
Sets the currently-selected font.
fsd : |
a GtkFontSelectionDialog. |
fontname : |
a fontname. |
Returns : |
TRUE |
constgchar * gtk_font_selection_dialog_get_preview_text (GtkFontSelectionDialog *fsd);
Gets the text displayed in the preview area.
fsd : |
a GtkFontSelectionDialog. |
Returns : | the text displayed in the preview area. This string is owned by the widget and should not be modified or freed. |
void gtk_font_selection_dialog_set_preview_text (GtkFontSelectionDialog *fsd, constgchar *text);
Sets the text displayed in the preview area.
fsd : |
a GtkFontSelectionDialog. |
text : |
the text to display in the preview area. |
GtkFontSelection, GtkDialog |
the underlying widget for selecting fonts. the parent class of GtkFontSelectionDialog |