GnomeFontPicker: GNOME UI Library Reference Manual

GnomeFontPicker

Functions

GtkWidget *	gnome_font_picker_new ()
void	gnome_font_picker_set_title ()
const gchar *	gnome_font_picker_get_title ()
GnomeFontPickerMode	gnome_font_picker_get_mode ()
void	gnome_font_picker_set_mode ()
void	gnome_font_picker_fi_set_use_font_in_label ()
void	gnome_font_picker_fi_set_show_size ()
void	gnome_font_picker_uw_set_widget ()
GtkWidget *	gnome_font_picker_uw_get_widget ()
const gchar *	gnome_font_picker_get_font_name ()
GdkFont *	gnome_font_picker_get_font ()
gboolean	gnome_font_picker_set_font_name ()
const gchar *	gnome_font_picker_get_preview_text ()
void	gnome_font_picker_set_preview_text ()

Properties

gpointer	font	Read
char *	font-name	Read / Write
int	label-font-size	Read / Write
GnomeFontPickerMode	mode	Read / Write
char *	preview-text	Read / Write
gboolean	show-size	Read / Write
char *	title	Read / Write
gboolean	use-font-in-label	Read / Write

Signals

void

font-set

Run First

Types and Values

enum	GnomeFontPickerMode
	GnomeFontPickerPrivate
struct	GnomeFontPicker

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkButton
                            ╰── GnomeFontPicker

Implemented Interfaces

GnomeFontPicker implements AtkImplementorIface, GtkBuildable and GtkActivatable.

Includes

#include <libgnomeui/libgnomeui.h>

Description

Functions

gnome_font_picker_new ()

GtkWidget *
gnome_font_picker_new (void);

gnome_font_picker_new is deprecated and should not be used in newly-written code.

Create new font picker widget.

Returns

Pointer to new font picker widget.

gnome_font_picker_set_title ()

void
gnome_font_picker_set_title (GnomeFontPicker *gfp,
                             const gchar *title);

gnome_font_picker_set_title is deprecated and should not be used in newly-written code.

Sets the title for the font selection dialog. If title is NULL, then the default is used.

Parameters

gfp	Pointer to GNOME font picker widget.
title	String containing font selection dialog title.

gnome_font_picker_get_title ()

const gchar *
gnome_font_picker_get_title (GnomeFontPicker *gfp);

gnome_font_picker_get_title is deprecated and should not be used in newly-written code.

Retrieve name of the font selection dialog title

Parameters

gfp

Pointer to GNOME font picker widget.

Returns

Pointer to an internal copy of the title string

gnome_font_picker_get_mode ()

GnomeFontPickerMode
gnome_font_picker_get_mode (GnomeFontPicker *gfp);

gnome_font_picker_get_mode is deprecated and should not be used in newly-written code.

Returns current font picker button mode (or what to show). Possible values include GNOME_FONT_PICKER_MODE_PIXMAP, GNOME_FONT_PICKER_MODE_FONT_INFO, and GNOME_FONT_PICKER_MODE_USER_WIDGET.

Parameters

gfp

Pointer to GNOME font picker widget.

Returns

Button mode currently set in font picker widget, or GNOME_FONT_PICKER_MODE_UNKNOWN on error.

gnome_font_picker_set_mode ()

void
gnome_font_picker_set_mode (GnomeFontPicker *gfp,
                            GnomeFontPickerMode mode);

gnome_font_picker_set_mode is deprecated and should not be used in newly-written code.

Set value of subsequent font picker button mode (or what to show).

Parameters

gfp	Pointer to GNOME font picker widget.
mode	Value of subsequent font picker button mode (or what to show)

gnome_font_picker_fi_set_use_font_in_label ()

void
gnome_font_picker_fi_set_use_font_in_label
                               (GnomeFontPicker *gfp,
                                gboolean use_font_in_label,
                                gint size);

gnome_font_picker_fi_set_use_font_in_label is deprecated and should not be used in newly-written code.

If use_font_in_label is TRUE, font name will be written using font chosen by user and using size passed to this function. This only applies if current button mode is GNOME_FONT_PICKER_MODE_FONT_INFO.

Parameters

gfp	Pointer to GNOME font picker widget.
use_font_in_label	If `TRUE`, font name will be written using font chosen.
size	Display font using this point size.

gnome_font_picker_fi_set_show_size ()

void
gnome_font_picker_fi_set_show_size (GnomeFontPicker *gfp,
                                    gboolean show_size);

gnome_font_picker_fi_set_show_size is deprecated and should not be used in newly-written code.

If show_size is TRUE, font size will be displayed along with font chosen by user. This only applies if current button mode is GNOME_FONT_PICKER_MODE_FONT_INFO.

Parameters

gfp	Pointer to GNOME font picker widget.
show_size	`TRUE` if font size should be displayed in dialog.

gnome_font_picker_uw_set_widget ()

void
gnome_font_picker_uw_set_widget (GnomeFontPicker *gfp,
                                 GtkWidget *widget);

gnome_font_picker_uw_set_widget is deprecated and should not be used in newly-written code.

Set the user-supplied widget as the inside of the font picker. This only applies with GNOME_FONT_PICKER_MODE_USER_WIDGET.

Parameters

gfp	Pointer to GNOME font picker widget.
widget	User widget to display for inside of font picker.

gnome_font_picker_uw_get_widget ()

GtkWidget *
gnome_font_picker_uw_get_widget (GnomeFontPicker *gfp);

gnome_font_picker_uw_get_widget is deprecated and should not be used in newly-written code.

Get the user-supplied widget inside of the font picker. This only applies with GNOME_FONT_PICKER_MODE_USER_WIDGET.

Parameters

gfp

Pointer to GNOME font picker widget.

Returns

a GtkWidget, or NULL if not in GNOME_FONT_PICKER_MODE_USER_WIDGET mode

gnome_font_picker_get_font_name ()

const gchar *
gnome_font_picker_get_font_name (GnomeFontPicker *gfp);

gnome_font_picker_get_font_name is deprecated and should not be used in newly-written code.

Retrieve name of font from font selection dialog.

Parameters

gfp

Pointer to GNOME font picker widget.

Returns

Pointer to an internal copy of the font name.

gnome_font_picker_get_font ()

GdkFont *
gnome_font_picker_get_font (GnomeFontPicker *gfp);

gnome_font_picker_get_font is deprecated and should not be used in newly-written code.

Retrieve font info from font selection dialog.

Parameters

gfp

Pointer to GNOME font picker widget.

Returns

Return value of gtk_font_selection_dialog_get_font, or NULL if font dialog is not being displayed. The value is not a copy but an internal value and should not be modified.

gnome_font_picker_set_font_name ()

gboolean
gnome_font_picker_set_font_name (GnomeFontPicker *gfp,
                                 const gchar *fontname);

gnome_font_picker_set_font_name is deprecated and should not be used in newly-written code.

Set or update currently-displayed font in font picker dialog.

Parameters

gfp	Pointer to GNOME font picker widget.
fontname	Name of font to display in font selection dialog

Returns

Return value of gtk_font_selection_dialog_set_font_name if the font selection dialog exists, otherwise FALSE.

gnome_font_picker_get_preview_text ()

const gchar *
gnome_font_picker_get_preview_text (GnomeFontPicker *gfp);

gnome_font_picker_get_preview_text is deprecated and should not be used in newly-written code.

Retrieve preview text from font selection dialog if available.

Parameters

gfp

Pointer to GNOME font picker widget.

Returns

Reference to internal copy of preview text string, or NULL if no font dialog is being displayed.

gnome_font_picker_set_preview_text ()

void
gnome_font_picker_set_preview_text (GnomeFontPicker *gfp,
                                    const gchar *text);

gnome_font_picker_set_preview_text is deprecated and should not be used in newly-written code.

Set preview text in font picker, and in font selection dialog if one is being displayed.

Parameters

gfp	Pointer to GNOME font picker widget.
text	New preview text

Types and Values

enum GnomeFontPickerMode

GnomeFontPickerMode is deprecated and should not be used in newly-written code.

Members

GNOME_FONT_PICKER_MODE_PIXMAP
GNOME_FONT_PICKER_MODE_FONT_INFO
GNOME_FONT_PICKER_MODE_USER_WIDGET
GNOME_FONT_PICKER_MODE_UNKNOWN

GnomeFontPickerPrivate

typedef struct _GnomeFontPickerPrivate GnomeFontPickerPrivate;

GnomeFontPickerPrivate is deprecated and should not be used in newly-written code.

struct GnomeFontPicker

struct GnomeFontPicker;

GnomeFontPicker is deprecated and should not be used in newly-written code.

Property Details

The `“font”` property

  “font”                     gpointer

The selected GtkFont.

Owner: GnomeFontPicker

Flags: Read

The `“font-name”` property

  “font-name”                char *

Name of the selected font.

Owner: GnomeFontPicker

Flags: Read / Write

Default value: "sans 12"

The `“label-font-size”` property

  “label-font-size”          int

Font size for label in font info mode.

Owner: GnomeFontPicker

Flags: Read / Write

Allowed values: [8,72]

Default value: 14

The `“mode”` property

  “mode”                     GnomeFontPickerMode

The mode of operation of the font picker.

Owner: GnomeFontPicker

Flags: Read / Write

Default value: GNOME_FONT_PICKER_MODE_PIXMAP

The `“preview-text”` property

  “preview-text”             char *

Preview text shown in the dialog.

Owner: GnomeFontPicker

Flags: Read / Write

Default value: "AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz"

The `“show-size”` property

  “show-size”                gboolean

Show size in font info mode.

Owner: GnomeFontPicker

Flags: Read / Write

Default value: TRUE

The `“title”` property

  “title”                    char *

The title of the selection dialog box.

Owner: GnomeFontPicker

Flags: Read / Write

Default value: "Pick a Font"

The `“use-font-in-label”` property

  “use-font-in-label”        gboolean

Use font in the label in font info mode.

Owner: GnomeFontPicker

Flags: Read / Write

Default value: FALSE

Signal Details

The `“font-set”` signal

void
user_function (GnomeFontPicker *fontpicker,
               char            *arg1,
               gpointer         user_data)

Flags: Run First