HildonFontSelectionDialog

HildonFontSelectionDialog — A widget used to allow users to select a font with certain properties.

Synopsis




            HildonFontSelectionDialog;
GtkWidget*  hildon_font_selection_dialog_new
                                            (GtkWindow *parent,
                                             const gchar *title);
gchar*      hildon_font_selection_dialog_get_preview_text
                                            (HildonFontSelectionDialog *fsd);
void        hildon_font_selection_dialog_set_preview_text
                                            (HildonFontSelectionDialog *fsd,
                                             const gchar *text);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----HildonFontSelectionDialog

Implemented Interfaces

HildonFontSelectionDialog implements GtkBuildable and AtkImplementorIface.

Properties


  "bold"                 gboolean              : Read / Write
  "bold-set"             gboolean              : Read / Write / Construct
  "color"                GdkColor              : Read / Write
  "color-set"            gboolean              : Read / Write / Construct
  "family"               gchararray            : Read / Write
  "family-set"           gboolean              : Read / Write / Construct
  "font-scaling"         gdouble               : Read / Write
  "italic"               gboolean              : Read / Write
  "italic-set"           gboolean              : Read / Write / Construct
  "position"             gint                  : Read / Write
  "position-set"         gboolean              : Read / Write / Construct
  "preview-text"         gchararray            : Read / Write
  "size"                 gint                  : Read / Write
  "size-set"             gboolean              : Read / Write / Construct
  "strikethrough"        gboolean              : Read / Write
  "strikethrough-set"    gboolean              : Read / Write / Construct
  "underline"            gboolean              : Read / Write
  "underline-set"        gboolean              : Read / Write / Construct

Description

Font selection can be made using this widget. Users can select font name, size, style, etc. Users can also preview text in the selected font.

Details

HildonFontSelectionDialog

typedef struct _HildonFontSelectionDialog HildonFontSelectionDialog;

hildon_font_selection_dialog_new ()

GtkWidget*  hildon_font_selection_dialog_new
                                            (GtkWindow *parent,
                                             const gchar *title);

If NULL is passed for title, then default title "Font" will be used.

parent : the parent window
title : the title of font selection dialog
Returns : a new HildonFontSelectionDialog

hildon_font_selection_dialog_get_preview_text ()

gchar*      hildon_font_selection_dialog_get_preview_text
                                            (HildonFontSelectionDialog *fsd);

Gets the text in preview dialog, which does not include the reference text. The returned string must be freed by the user.

fsd : the font selection dialog
Returns : a string pointer

hildon_font_selection_dialog_set_preview_text ()

void        hildon_font_selection_dialog_set_preview_text
                                            (HildonFontSelectionDialog *fsd,
                                             const gchar *text);

The default preview text is "The quick brown fox jumped over the lazy dogs"

fsd : the font selection dialog
text : the text to be displayed in the preview dialog

Property Details

The "bold" property

  "bold"                 gboolean              : Read / Write

Whether the text is bold.

Default value: FALSE

The "bold-set" property

  "bold-set"             gboolean              : Read / Write / Construct

Whether the bold is inconsistent.

Default value: FALSE

The "color" property

  "color"                GdkColor              : Read / Write

GdkColor for the text.

The "color-set" property

  "color-set"            gboolean              : Read / Write / Construct

Is font bold status set or inconsistent.

Default value: FALSE

The "family" property

  "family"               gchararray            : Read / Write

Font family used.

Default value: "Sans"

The "family-set" property

  "family-set"           gboolean              : Read / Write / Construct

Is font family set or inconsistent.

Default value: FALSE

The "font-scaling" property

  "font-scaling"         gdouble               : Read / Write

The font scaling factor applied to the preview dialog.

Allowed values: [0,10]

Default value: 1

The "italic" property

  "italic"               gboolean              : Read / Write

Is font set as italic.

Default value: FALSE

The "italic-set" property

  "italic-set"           gboolean              : Read / Write / Construct

Is font italic status set or inconsistent.

Default value: FALSE

The "position" property

  "position"             gint                  : Read / Write

The font positioning versus baseline.

Allowed values: [-1,1]

Default value: 0

The "position-set" property

  "position-set"         gboolean              : Read / Write / Construct

Is the font positioning set.

Default value: FALSE

The "preview-text" property

  "preview-text"         gchararray            : Read / Write

The text used for the preview dialog.

Default value: ""

The "size" property

  "size"                 gint                  : Read / Write

Font size.

Allowed values: [6,32]

Default value: 16

The "size-set" property

  "size-set"             gboolean              : Read / Write / Construct

Is font size set or inconsistent.

Default value: FALSE

The "strikethrough" property

  "strikethrough"        gboolean              : Read / Write

Is the font striken-through.

Default value: FALSE

The "strikethrough-set" property

  "strikethrough-set"    gboolean              : Read / Write / Construct

Is the font strikenthrough status set.

Default value: FALSE

The "underline" property

  "underline"            gboolean              : Read / Write

Is font underline status set or inconsistent.

Default value: FALSE

The "underline-set" property

  "underline-set"        gboolean              : Read / Write / Construct

Whether the underline is inconsistent.

Default value: FALSE