GtkFontSelectionDialog

GtkFontSelectionDialog — Deprecated dialog box for selecting fonts

Functions

GtkWidget *	gtk_font_selection_dialog_new ()
gchar *	gtk_font_selection_dialog_get_font_name ()
gboolean	gtk_font_selection_dialog_set_font_name ()
const gchar *	gtk_font_selection_dialog_get_preview_text ()
void	gtk_font_selection_dialog_set_preview_text ()
GtkWidget *	gtk_font_selection_dialog_get_cancel_button ()
GtkWidget *	gtk_font_selection_dialog_get_ok_button ()
GtkWidget *	gtk_font_selection_dialog_get_font_selection ()

Types and Values

struct

GtkFontSelectionDialog

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBin
                    ╰── GtkWindow
                        ╰── GtkDialog
                            ╰── GtkFontSelectionDialog

Implemented Interfaces

GtkFontSelectionDialog implements AtkImplementorIface and GtkBuildable.

Includes

#include <gtk/gtk.h>

Description

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().

In GTK+ 3.2, GtkFontSelectionDialog has been deprecated in favor of GtkFontChooserDialog.

GtkFontSelectionDialog as GtkBuildable

The GtkFontSelectionDialog implementation of the GtkBuildable interface exposes the embedded GtkFontSelection as internal child with the name “font_selection”. It also exposes the buttons with the names “ok_button”, “cancel_button” and “apply_button”.

Functions

gtk_font_selection_dialog_new ()

GtkWidget *
gtk_font_selection_dialog_new (const gchar *title);

gtk_font_selection_dialog_new has been deprecated since version 3.2 and should not be used in newly-written code.

Use GtkFontChooserDialog

Creates a new GtkFontSelectionDialog.

Parameters

title

the title of the dialog window

Returns

a new GtkFontSelectionDialog

gtk_font_selection_dialog_get_font_name ()

gchar *
gtk_font_selection_dialog_get_font_name
                               (GtkFontSelectionDialog *fsd);

gtk_font_selection_dialog_get_font_name has been deprecated since version 3.2 and should not be used in newly-written code.

Use GtkFontChooserDialog

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() if you want to compare two font descriptions.

Parameters

fsd

a GtkFontSelectionDialog

Returns

A string with the name of the current font, or NULL if no font is selected. You must free this string with g_free().

gtk_font_selection_dialog_set_font_name ()

gboolean
gtk_font_selection_dialog_set_font_name
                               (GtkFontSelectionDialog *fsd,
                                const gchar *fontname);

gtk_font_selection_dialog_set_font_name has been deprecated since version 3.2 and should not be used in newly-written code.

Use GtkFontChooserDialog

Sets the currently selected font.

Parameters

fsd	a GtkFontSelectionDialog
fontname	a font name like “Helvetica 12” or “Times Bold 18”

Returns

TRUE if the font selected in fsd is now the fontname specified, FALSE otherwise.

gtk_font_selection_dialog_get_preview_text ()

const gchar *
gtk_font_selection_dialog_get_preview_text
                               (GtkFontSelectionDialog *fsd);

gtk_font_selection_dialog_get_preview_text has been deprecated since version 3.2 and should not be used in newly-written code.

Use GtkFontChooserDialog

Gets the text displayed in the preview area.

Parameters

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

gtk_font_selection_dialog_set_preview_text ()

void
gtk_font_selection_dialog_set_preview_text
                               (GtkFontSelectionDialog *fsd,
                                const gchar *text);

gtk_font_selection_dialog_set_preview_text has been deprecated since version 3.2 and should not be used in newly-written code.

Use GtkFontChooserDialog

Sets the text displayed in the preview area.

Parameters

fsd	a GtkFontSelectionDialog
text	the text to display in the preview area

gtk_font_selection_dialog_get_cancel_button ()

GtkWidget *
gtk_font_selection_dialog_get_cancel_button
                               (GtkFontSelectionDialog *fsd);

gtk_font_selection_dialog_get_cancel_button has been deprecated since version 3.2 and should not be used in newly-written code.

Use GtkFontChooserDialog

Gets the “Cancel” button.

Parameters

fsd

a GtkFontSelectionDialog

Returns

the GtkWidget used in the dialog for the “Cancel” button.

[transfer none]

Since: 2.14

gtk_font_selection_dialog_get_ok_button ()

GtkWidget *
gtk_font_selection_dialog_get_ok_button
                               (GtkFontSelectionDialog *fsd);

gtk_font_selection_dialog_get_ok_button has been deprecated since version 3.2 and should not be used in newly-written code.

Use GtkFontChooserDialog

Gets the “OK” button.

Parameters

fsd

a GtkFontSelectionDialog

Returns

the GtkWidget used in the dialog for the “OK” button.

[transfer none]

Since: 2.14

gtk_font_selection_dialog_get_font_selection ()

GtkWidget *
gtk_font_selection_dialog_get_font_selection
                               (GtkFontSelectionDialog *fsd);

gtk_font_selection_dialog_get_font_selection has been deprecated since version 3.2 and should not be used in newly-written code.

Use GtkFontChooserDialog

Retrieves the GtkFontSelection widget embedded in the dialog.

Parameters

fsd

a GtkFontSelectionDialog

Returns

the embedded GtkFontSelection.

[transfer none]

Since: 2.22

Types and Values

struct GtkFontSelectionDialog

struct GtkFontSelectionDialog;

GtkFontSelectionDialog

Functions

Types and Values

Object Hierarchy

Implemented Interfaces

Includes

Description

GtkFontSelectionDialog as GtkBuildable

Functions

gtk_font_selection_dialog_new ()

Parameters

Returns

gtk_font_selection_dialog_get_font_name ()

Parameters

Returns

gtk_font_selection_dialog_set_font_name ()

Parameters

Returns

gtk_font_selection_dialog_get_preview_text ()

Parameters

Returns

gtk_font_selection_dialog_set_preview_text ()

Parameters

gtk_font_selection_dialog_get_cancel_button ()

Parameters

Returns

gtk_font_selection_dialog_get_ok_button ()

Parameters

Returns

gtk_font_selection_dialog_get_font_selection ()

Parameters

Returns

Types and Values

struct GtkFontSelectionDialog

See Also