GnomeFontPicker

Name

GnomeFontPicker -- 

Synopsis


#include <libgnomeui/libgnomeui.h>


enum        GnomeFontPickerMode;
struct      GnomeFontPickerPrivate;
struct      GnomeFontPicker;
GtkWidget*  gnome_font_picker_new           (void);
void        gnome_font_picker_set_title     (GnomeFontPicker *gfp,
                                             const gchar *title);
const gchar* gnome_font_picker_get_title    (GnomeFontPicker *gfp);
GnomeFontPickerMode gnome_font_picker_get_mode
                                            (GnomeFontPicker *gfp);
void        gnome_font_picker_set_mode      (GnomeFontPicker *gfp,
                                             GnomeFontPickerMode mode);
void        gnome_font_picker_fi_set_use_font_in_label
                                            (GnomeFontPicker *gfp,
                                             gboolean use_font_in_label,
                                             gint size);
void        gnome_font_picker_fi_set_show_size
                                            (GnomeFontPicker *gfp,
                                             gboolean show_size);
void        gnome_font_picker_uw_set_widget (GnomeFontPicker *gfp,
                                             GtkWidget *widget);
GtkWidget*  gnome_font_picker_uw_get_widget (GnomeFontPicker *gfp);
const gchar* gnome_font_picker_get_font_name
                                            (GnomeFontPicker *gfp);
GdkFont*    gnome_font_picker_get_font      (GnomeFontPicker *gfp);
gboolean    gnome_font_picker_set_font_name (GnomeFontPicker *gfp,
                                             const gchar *fontname);
const gchar* gnome_font_picker_get_preview_text
                                            (GnomeFontPicker *gfp);
void        gnome_font_picker_set_preview_text
                                            (GnomeFontPicker *gfp,
                                             const gchar *text);

Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBin
                           +----GtkButton
                                 +----GnomeFontPicker

Properties


  "title"                gchararray           : Read / Write
  "mode"                 GnomeFontPickerMode  : Read / Write
  "font-name"            gchararray           : Read / Write
  "preview-text"         gchararray           : Read / Write
  "use-font-in-label"    gboolean             : Read / Write
  "label-font-size"      gint                 : Read / Write
  "show-size"            gboolean             : Read / Write
  "font"                 gpointer             : Read

Signal Prototypes


"font-set"  void        user_function      (GnomeFontPicker *fontpicker,
                                            gchar *arg1,
                                            gpointer user_data);

Description

Details

enum GnomeFontPickerMode

typedef enum {
    GNOME_FONT_PICKER_MODE_PIXMAP,
    GNOME_FONT_PICKER_MODE_FONT_INFO,
    GNOME_FONT_PICKER_MODE_USER_WIDGET,
    GNOME_FONT_PICKER_MODE_UNKNOWN
} GnomeFontPickerMode;


struct GnomeFontPickerPrivate

struct GnomeFontPickerPrivate;


struct GnomeFontPicker

struct GnomeFontPicker;


gnome_font_picker_new ()

GtkWidget*  gnome_font_picker_new           (void);

Create new font picker widget.


gnome_font_picker_set_title ()

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

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


gnome_font_picker_get_title ()

const gchar* gnome_font_picker_get_title    (GnomeFontPicker *gfp);

Retrieve name of the font selection dialog title


gnome_font_picker_get_mode ()

GnomeFontPickerMode gnome_font_picker_get_mode
                                            (GnomeFontPicker *gfp);

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.


gnome_font_picker_set_mode ()

void        gnome_font_picker_set_mode      (GnomeFontPicker *gfp,
                                             GnomeFontPickerMode mode);

Set 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);

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.


gnome_font_picker_fi_set_show_size ()

void        gnome_font_picker_fi_set_show_size
                                            (GnomeFontPicker *gfp,
                                             gboolean show_size);

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.


gnome_font_picker_uw_set_widget ()

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

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


gnome_font_picker_uw_get_widget ()

GtkWidget*  gnome_font_picker_uw_get_widget (GnomeFontPicker *gfp);

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


gnome_font_picker_get_font_name ()

const gchar* gnome_font_picker_get_font_name
                                            (GnomeFontPicker *gfp);

Retrieve name of font from font selection dialog.


gnome_font_picker_get_font ()

GdkFont*    gnome_font_picker_get_font      (GnomeFontPicker *gfp);

Retrieve font info from font selection dialog.


gnome_font_picker_set_font_name ()

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

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


gnome_font_picker_get_preview_text ()

const gchar* gnome_font_picker_get_preview_text
                                            (GnomeFontPicker *gfp);

Retrieve preview text from font selection dialog if available.


gnome_font_picker_set_preview_text ()

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

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

Properties

"title" (gchararray : Read / Write)

The title of the selection dialog box

"mode" (GnomeFontPickerMode : Read / Write)

The mode of operation of the font picker

"font-name" (gchararray : Read / Write)

Name of the selected font

"preview-text" (gchararray : Read / Write)

Preview text shown in the dialog

"use-font-in-label" (gboolean : Read / Write)

Use font in the label in font info mode

"label-font-size" (gint : Read / Write)

Font size for label in font info mode

"show-size" (gboolean : Read / Write)

Show size in font info mode

"font" (gpointer : Read)

The selected GtkFont

Signals

The "font-set" signal

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