Back to Seed Clases

Pango

Classes

Interfaces

Structs

Unions

Enums

Struct Pango.FontDescription

Import line:	Pango = imports.gi.Pango;
GIR File:	Pango-1.0.gir
C documentation:	Pango.FontDescription
Struct :	FontDescription

Properties
None

Methods / Constructors
Method / Constructor		Defined By
	new Pango.FontDescription.c_new () : Pango.FontDescription Create a new Pango.FontDescription Create a new Pango.FontDescription Returns: Pango.FontDescription the newly allocated PangoFontDescription, which
	better_match (FontDescription *old_match, FontDescription new_match) : gboolean Determines if the style attributes of new_match* are a closer match for desc than those of old_match are, or if old_match is NULL, determines if new_match is a match at all. Determines if the style attributes of new_match are a closer match for desc than those of old_match are, or if old_match is NULL, determines if new_match is a match at all. Approximate matching is done for weight and style; other style attributes must match exactly. Style attributes are all attributes other than family and size-related attributes. Approximate matching for style considers PANGO_STYLE_OBLIQUE and PANGO_STYLE_ITALIC as matches, but not as good a match as when the styles are equal. Note that old_match must match desc. Parameters: Pango.FontDescription old_match Required (not null) a PangoFontDescription, or NULL Pango.FontDescription new_match Required (not null) a PangoFontDescription Returns: gboolean TRUE if new_match is a better match	Pango.FontDescription
	copy () : Pango.FontDescription Make a copy of a PangoFontDescription. Make a copy of a PangoFontDescription. be freed with pango_font_description_free(), or NULL if desc was NULL. Returns: Pango.FontDescription the newly allocated PangoFontDescription, which should	Pango.FontDescription
	copy_static () : Pango.FontDescription Like pango_font_description_copy(), but only a shallow copy is made of the family name and other allocated fields. Like pango_font_description_copy(), but only a shallow copy is made of the family name and other allocated fields. The result can only be used until desc is modified or freed. This is meant to be used when the copy is only needed temporarily. be freed with pango_font_description_free(), or NULL if desc was NULL. Returns: Pango.FontDescription the newly allocated PangoFontDescription, which should	Pango.FontDescription
	equal (FontDescription *desc2) : gboolean Compares two font descriptions for equality. Compares two font descriptions for equality. Two font descriptions are considered equal if the fonts they describe are provably identical. This means that their masks do not have to match, as long as other fields are all the same. (Two font descriptions may result in identical fonts being loaded, but still compare FALSE.) FALSE* otherwise. Parameters: Pango.FontDescription desc2 Required (not null) another PangoFontDescription Returns: gboolean TRUE if the two font descriptions are identical,	Pango.FontDescription
	free () : none Frees a font description. Frees a font description. Returns: none	Pango.FontDescription
	get_family () : String Gets the family name field of a font description. Gets the family name field of a font description. See pango_font_description_set_family(). NULL if not previously set. This has the same life-time as the font description itself and should not be freed. Returns: String the family name field for the font description, or	Pango.FontDescription
	get_gravity () : Pango.Gravity Gets the gravity field of a font description. Gets the gravity field of a font description. See pango_font_description_set_gravity(). pango_font_description_get_set_fields() to find out if the field was explicitly set or not. Returns: Pango.Gravity the gravity field for the font description. Use	Pango.FontDescription
	get_set_fields () : Pango.FontMask Determines which fields in a font description have been set. Determines which fields in a font description have been set. fields in desc that have been set. Returns: Pango.FontMask a bitmask with bits set corresponding to the	Pango.FontDescription
	get_size () : gint32 Gets the size field of a font description. Gets the size field of a font description. See pango_font_description_set_size(). You must call pango_font_description_get_size_is_absolute() to find out which is the case. Returns 0 if the size field has not previously been set or it has been set to 0 explicitly. Use pango_font_description_get_set_fields() to find out if the field was explicitly set or not. Returns: gint32 the size field for the font description in points or device units.	Pango.FontDescription
	get_size_is_absolute () : gboolean Determines whether the size of the font is in points (not absolute) or device units (absolute). Determines whether the size of the font is in points (not absolute) or device units (absolute). See pango_font_description_set_size() and pango_font_description_set_absolute_size(). points or device units. Use pango_font_description_get_set_fields() to find out if the size field of the font description was explicitly set or not. Returns: gboolean whether the size for the font description is in	Pango.FontDescription
	get_stretch () : Pango.Stretch Gets the stretch field of a font description. Gets the stretch field of a font description. See pango_font_description_set_stretch(). pango_font_description_get_set_fields() to find out if the field was explicitly set or not. Returns: Pango.Stretch the stretch field for the font description. Use	Pango.FontDescription
	get_style () : Pango.Style Gets the style field of a PangoFontDescription. Gets the style field of a PangoFontDescription. See pango_font_description_set_style(). Use pango_font_description_get_set_fields() to find out if the field was explicitly set or not. Returns: Pango.Style the style field for the font description.	Pango.FontDescription
	get_variant () : Pango.Variant Gets the variant field of a PangoFontDescription. Gets the variant field of a PangoFontDescription. See pango_font_description_set_variant(). pango_font_description_get_set_fields() to find out if the field was explicitly set or not. Returns: Pango.Variant the variant field for the font description. Use	Pango.FontDescription
	get_weight () : Pango.Weight Gets the weight field of a font description. Gets the weight field of a font description. See pango_font_description_set_weight(). pango_font_description_get_set_fields() to find out if the field was explicitly set or not. Returns: Pango.Weight the weight field for the font description. Use	Pango.FontDescription
	hash () : guint32 Computes a hash of a PangoFontDescription structure suitable to be used, for example, as an argument to g_hash_table_new(). Computes a hash of a PangoFontDescription structure suitable to be used, for example, as an argument to g_hash_table_new(). The hash value is independent of desc->mask. Returns: guint32 the hash value.	Pango.FontDescription
	merge (FontDescription *desc_to_merge, gboolean replace_existing) : none Merges the fields that are set in desc_to_merge* into the fields in are not already set are affected. Merges the fields that are set in desc_to_merge into the fields in are not already set are affected. If TRUE, then fields that are already set will be replaced as well. If desc_to_merge is NULL, this function performs nothing. Parameters: Pango.FontDescription desc_to_merge Required (not null) the PangoFontDescription to merge from, or NULL gboolean replace_existing Required (not null) if TRUE, replace fields in desc with the corresponding values from desc_to_merge, even if they are already exist. Returns: none	Pango.FontDescription
	merge_static (FontDescription *desc_to_merge, gboolean replace_existing) : none Like pango_font_description_merge(), but only a shallow copy is made of the family name and other allocated fields. Like pango_font_description_merge(), but only a shallow copy is made of the family name and other allocated fields. desc* can only be used until desc_to_merge is modified or freed. This is meant to be used when the merged font description is only needed temporarily. Parameters: Pango.FontDescription desc_to_merge Required (not null) the PangoFontDescription to merge from gboolean replace_existing Required (not null) if TRUE, replace fields in desc with the corresponding values from desc_to_merge, even if they are already exist. Returns: none	Pango.FontDescription
	set_absolute_size (gdouble *size) : none Sets the size field of a font description, in device units. Sets the size field of a font description, in device units. This is mutually exclusive with pango_font_description_set_size() which sets the font size in points. Parameters: gdouble size* Required (not null) the new size, in Pango units. There are PANGO_SCALE Pango units in one device unit. For an output backend where a device unit is a pixel, a size value of 10 * PANGO_SCALE gives a 10 pixel font. Returns: none	Pango.FontDescription
	set_family (String *family) : none Sets the family name field of a font description. Sets the family name field of a font description. The family name represents a family of related font styles, and will resolve to a particular PangoFontFamily. In some uses of PangoFontDescription, it is also possible to use a comma separated list of family names for this field. Parameters: String family* Required (not null) a string representing the family name. Returns: none	Pango.FontDescription
	set_family_static (String *family) : none Like pango_font_description_set_family(), except that no copy of family* is made. Like pango_font_description_set_family(), except that no copy of family is made. The caller must make sure that the string passed in stays around until desc has been freed or the name is set again. This function can be used if if desc is only needed temporarily. Parameters: String family Required (not null) a string representing the family name. Returns: none	Pango.FontDescription
	set_gravity (Gravity *gravity) : none Sets the gravity field of a font description. Sets the gravity field of a font description. The gravity field specifies how the glyphs should be rotated. If gravity* is PANGO_GRAVITY_AUTO, this actually unsets the gravity mask on the font description. This function is seldom useful to the user. Gravity should normally be set on a PangoContext. Parameters: Pango.Gravity gravity Required (not null) the gravity for the font description. Returns: none	Pango.FontDescription
	set_size (gint32 *size) : none Sets the size field of a font description in fractional points. Sets the size field of a font description in fractional points. This is mutually exclusive with pango_font_description_set_absolute_size(). Parameters: gint32 size* Required (not null) the size of the font in points, scaled by PANGO_SCALE. (That is, a size value of 10 * PANGO_SCALE is a 10 point font. The conversion factor between points and device units depends on system configuration and the output device. For screen display, a logical DPI of 96 is common, in which case a 10 point font corresponds to a 10 * (96 / 72) = 13.3 pixel font. Use pango_font_description_set_absolute_size() if you need a particular size in device units. Returns: none	Pango.FontDescription
	set_stretch (Stretch *stretch) : none Sets the stretch field of a font description. Sets the stretch field of a font description. The stretch field specifies how narrow or wide the font should be. Parameters: Pango.Stretch stretch* Required (not null) the stretch for the font description Returns: none	Pango.FontDescription
	set_style (Style *style) : none Sets the style field of a PangoFontDescription. Sets the style field of a PangoFontDescription. The PangoStyle* enumeration describes whether the font is slanted and the manner in which it is slanted; it can be either PANGO_STYLE_NORMAL, PANGO_STYLE_ITALIC, or PANGO_STYLE_OBLIQUE. Most fonts will either have a italic style or an oblique style, but not both, and font matching in Pango will match italic specifications with oblique fonts and vice-versa if an exact match is not found. Parameters: Pango.Style style Required (not null) the style for the font description Returns: none	Pango.FontDescription
	set_variant (Variant *variant) : none Sets the variant field of a font description. Sets the variant field of a font description. The PangoVariant* can either be PANGO_VARIANT_NORMAL or PANGO_VARIANT_SMALL_CAPS. Parameters: Pango.Variant variant Required (not null) the variant type for the font description. Returns: none	Pango.FontDescription
	set_weight (Weight *weight) : none Sets the weight field of a font description. Sets the weight field of a font description. The weight field specifies how bold or light the font should be. In addition to the values of the PangoWeight* enumeration, other intermediate numeric values are possible. Parameters: Pango.Weight weight Required (not null) the weight for the font description. Returns: none	Pango.FontDescription
	to_filename () : String Creates a filename representation of a font description. Creates a filename representation of a font description. The filename is identical to the result from calling pango_font_description_to_string(), but with underscores instead of characters that are untypical in filenames, and in lower case only. Returns: String a new string that must be freed with g_free().	Pango.FontDescription
	to_string () : String Creates a string representation of a font description. Creates a string representation of a font description. See pango_font_description_from_string() for a description of the format of the string representation. The family list in the string description will only have a terminating comma if the last word of the list is a valid style option. Returns: String a new string that must be freed with g_free().	Pango.FontDescription
	unset_fields (FontMask *to_unset) : none Unsets some of the fields in a PangoFontDescription. Unsets some of the fields in a PangoFontDescription. The unset fields will get back to their default values. Parameters: Pango.FontMask to_unset* Required (not null) bitmask of fields in the desc to unset. Returns: none	Pango.FontDescription

Events
None

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Clutter.Text Property	font_description : Pango.FontDescription The PangoFontDescription that should be used by the ClutterText If you have a string describing the font then you should look at ClutterText:font-name instead
Clutter.Text Method	get_font_description () : Pango.FontDescription Retrieves the PangoFontDescription used by self by the ClutterText actor and it should not be modified or freed
Clutter.Text Method	set_font_description (FontDescription *font_desc) : none Sets font_desc* as the font description for a ClutterText The PangoFontDescription is copied by the ClutterText actor so you can safely call pango_font_description_free() on it after calling this function.
Gtk.CellRendererText Property	font_desc : Pango.FontDescription
Gtk.StyleContext Method	get_font (StateFlags *state*) : Pango.FontDescription Returns the font description for a given state.
Gtk.TextTag Property	font_desc : Pango.FontDescription
Gtk.ThemingEngine Method	get_font (StateFlags *state*) : Pango.FontDescription Returns the font description for a given state.
Gtk.Widget Method	modify_font (FontDescription *font_desc*) : none Sets the font to use for a widget.
Gtk.Widget Method	override_font (FontDescription *font_desc*) : none Sets the font to use for a widget.
Gucharmap.Charmap Property	font_desc : Pango.FontDescription
Gucharmap.Charmap Method	get_font_desc () : Pango.FontDescription
Gucharmap.Charmap Method	set_font_desc (FontDescription *font_desc*) : none
Gucharmap.Chartable Property	font_desc : Pango.FontDescription
Gucharmap.Chartable Method	get_font_desc () : Pango.FontDescription
Gucharmap.Chartable Method	set_font_desc (FontDescription *font_desc*) : none
Pango Method	Pango.font_description_from_string (String *str*) : Pango.FontDescription Creates a new font description from a string representation in the form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a comma separated list of families optionally terminated by a comma, STYLE_OPTIONS is a whitespace separated list of words where each WORD describes one of style, variant, weight, stretch, or gravity, and SIZE is a decimal number (size in points) or optionally followed by the unit modifier "px" for absolute size.
Pango.AttrIterator Method	get_font (FontDescription *desc, Language language, Array extra_attrs*) : none Get the font and other attributes at the current iterator position.
Pango.Context Method	get_font_description () : Pango.FontDescription Retrieve the default font description for the context.
Pango.Context Method	get_metrics (FontDescription *desc, Language language*) : Pango.FontMetrics Get overall metric information for a particular font description.
Pango.Context Method	set_font_description (FontDescription *desc*) : none Set the default font description for the context
Pango.Font Method	Pango.Font.descriptions_free (FontDescription *descs, gint32 n_descs*) : none Frees an array of font descriptions.
Pango.Font Method	describe () : Pango.FontDescription Returns a description of the font, with font size set in points.
Pango.Font Method	describe_with_absolute_size () : Pango.FontDescription Returns a description of the font, with absolute font size set (in device units).
Pango.FontFace Method	describe () : Pango.FontDescription Returns the family, style, variant, weight and stretch of a PangoFontFace.
Pango.Layout Method	get_font_description () : Pango.FontDescription Gets the font description for the layout, if any.
Pango.Layout Method	set_font_description (FontDescription *desc*) : none Sets the default font description for the layout.
Vte.Terminal Property	font_desc : Pango.FontDescription
Vte.Terminal Method	get_font () : Pango.FontDescription
Vte.Terminal Method	set_font (FontDescription *font_desc*) : none

Un-official Seed Documentation

Pango

Classes

Interfaces

Structs

Unions

Enums

Struct Pango.FontDescription