GnomeFontPicker

GnomeFontPicker

Functions

Properties

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

Signals

Types and Values

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.

Flags: Read


The “font-name” property

  “font-name”                gchar *

Name of the selected font.

Flags: Read / Write

Default value: "sans 12"


The “label-font-size” property

  “label-font-size”          gint

Font size for label in font info mode.

Flags: Read / Write

Allowed values: [8,72]

Default value: 14


The “mode” property

  “mode”                     GnomeFontPickerMode

The mode of operation of the font picker.

Flags: Read / Write

Default value: GNOME_FONT_PICKER_MODE_PIXMAP


The “preview-text” property

  “preview-text”             gchar *

Preview text shown in the dialog.

Flags: Read / Write

Default value: "AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz"


The “show-size” property

  “show-size”                gboolean

Show size in font info mode.

Flags: Read / Write

Default value: TRUE


The “title” property

  “title”                    gchar *

The title of the selection dialog box.

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.

Flags: Read / Write

Default value: FALSE

Signal Details

The “font-set” signal

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

Flags: Run First