HildonFontSelectionDialog

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

Synopsis


#include <hildon/hildon.h>

                    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 AtkImplementorIface and GtkBuildable.

Properties

  "bold"                     gboolean              : Read / Write
  "bold-set"                 gboolean              : Read / Write / Construct
  "color"                    GdkColor*             : Read / Write
  "color-set"                gboolean              : Read / Write / Construct
  "family"                   gchar*                : 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"             gchar*                : 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. Since hildon 2.2, the previously available preview dialog has been removed.

Warning

Deprecated: In Maemo 5, HildonFontSelectionDialog was deprecated and replaced with GtkFontButton. Usage of the newer API is documented in the Maemo 5 Developer Guide

Details

HildonFontSelectionDialog

typedef struct _HildonFontSelectionDialog HildonFontSelectionDialog;

Warning

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


hildon_font_selection_dialog_new ()

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

Warning

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

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

Warning

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

Gets the text in preview dialog, which does not include the reference text. The returned string must be freed by the user. Please note that since hildon 2.2, the preview has been discontinued, so this setting has no effect.

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

Warning

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

The default preview text is "The quick brown fox jumped over the lazy dogs". Please note that since hildon 2.2, the preview has been discontinued, so this setting has no effect.

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"                   gchar*                : 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"             gchar*                : 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