CtkFontSelectionDialog

CtkFontSelectionDialog — Deprecated dialog box for selecting fonts

Functions

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── CtkWidget
            ╰── CtkContainer
                ╰── CtkBin
                    ╰── CtkWindow
                        ╰── CtkDialog
                            ╰── CtkFontSelectionDialog

Implemented Interfaces

CtkFontSelectionDialog implements AtkImplementorIface and CtkBuildable.

Includes

#include <ctk/ctk.h>

Description

The CtkFontSelectionDialog widget is a dialog box for selecting a font.

To set the font which is initially selected, use ctk_font_selection_dialog_set_font_name().

To get the selected font use ctk_font_selection_dialog_get_font_name().

To change the text which is shown in the preview area, use ctk_font_selection_dialog_set_preview_text().

In CTK+ 3.2, CtkFontSelectionDialog has been deprecated in favor of CtkFontChooserDialog.

CtkFontSelectionDialog as CtkBuildable

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

Functions

ctk_font_selection_dialog_new ()

CtkWidget *
ctk_font_selection_dialog_new (const gchar *title);

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

Use CtkFontChooserDialog

Creates a new CtkFontSelectionDialog.

Parameters

title

the title of the dialog window

 

Returns

a new CtkFontSelectionDialog


ctk_font_selection_dialog_get_font_name ()

gchar *
ctk_font_selection_dialog_get_font_name
                               (CtkFontSelectionDialog *fsd);

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

Use CtkFontChooserDialog

Gets the currently-selected font name.

Note that this can be a different string than what you set with ctk_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().


ctk_font_selection_dialog_set_font_name ()

gboolean
ctk_font_selection_dialog_set_font_name
                               (CtkFontSelectionDialog *fsd,
                                const gchar *fontname);

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

Use CtkFontChooserDialog

Sets the currently selected font.

Parameters

fsd

a CtkFontSelectionDialog

 

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.


ctk_font_selection_dialog_get_preview_text ()

const gchar *
ctk_font_selection_dialog_get_preview_text
                               (CtkFontSelectionDialog *fsd);

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

Use CtkFontChooserDialog

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


ctk_font_selection_dialog_set_preview_text ()

void
ctk_font_selection_dialog_set_preview_text
                               (CtkFontSelectionDialog *fsd,
                                const gchar *text);

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

Use CtkFontChooserDialog

Sets the text displayed in the preview area.

Parameters

fsd

a CtkFontSelectionDialog

 

text

the text to display in the preview area

 

ctk_font_selection_dialog_get_cancel_button ()

CtkWidget *
ctk_font_selection_dialog_get_cancel_button
                               (CtkFontSelectionDialog *fsd);

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

Use CtkFontChooserDialog

Gets the “Cancel” button.

Parameters

Returns

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

[transfer none]

Since: 2.14


ctk_font_selection_dialog_get_ok_button ()

CtkWidget *
ctk_font_selection_dialog_get_ok_button
                               (CtkFontSelectionDialog *fsd);

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

Use CtkFontChooserDialog

Gets the “OK” button.

Parameters

Returns

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

[transfer none]

Since: 2.14


ctk_font_selection_dialog_get_font_selection ()

CtkWidget *
ctk_font_selection_dialog_get_font_selection
                               (CtkFontSelectionDialog *fsd);

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

Use CtkFontChooserDialog

Retrieves the CtkFontSelection widget embedded in the dialog.

Parameters

Returns

the embedded CtkFontSelection.

[transfer none]

Since: 2.22

Types and Values

struct CtkFontSelectionDialog

struct CtkFontSelectionDialog;

See Also

CtkFontSelection, CtkDialog, CtkFontChooserDialog