GtkFontSelectionDialog

GtkFontSelectionDialog — Deprecated dialog box for selecting fonts

Types and Values

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

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

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

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

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

Returns

the embedded GtkFontSelection.

[transfer none]

Since: 2.22

Types and Values

struct GtkFontSelectionDialog

struct GtkFontSelectionDialog;

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkFontSelectionDialog.html