<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <linklocation="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<summary>Represents the description of an ideal font.</summary>
<remarks>This class is used both to list what fonts are available on the system and also for specifying the characteristics of a font to load.</remarks>
<summary>The size of the font in device units.</summary>
<value>A <seecref="T:System.Double"/>, the new size in Pango units.</value>
<remarks>There are <seecref="F:Pango.Scale.PangoScale"/> Pango units in one device unit. For an output backend where a device unit is a pixel, an AbsoluteSize value of 10 * <seecref="F:Pango.Scale.PangoScale"/> gives a 10 pixel font.</remarks>
<seelangword="true"/> if new_match is a better match.</returns>
<remarks>Determines if the style attributes of new_match are a closer match for the current instance than old_match, or if old_match is <seelangword="null"/>, determines if new_match is a match at all. Approximate matching is done for weight and style; other attributes must match exactly.</remarks>
<summary>Make a copy of <seecref="T:Pango.FontDescription"/></summary>
<returns>an object of type <seecref="T:Pango.FontDescription"/></returns>
<remarks>Like <seecref="M:Pango.FontDescription.Copy()"/>, but only a shallow copy is made of the family name and other allocated fields. The result can only be used until it is modified or freed. This is meant to be used when the copy is only needed temporarily.</remarks>
<paramname="desc2">an object of type <seecref="T:Pango.FontDescription"/> to test for equality</param>
<summary>Compares two font descriptions for equality.</summary>
<returns>an object of type <seecref="T:System.Boolean"/></returns>
<remarks>
<seelangword="true"/> if the two font descriptions are proveably identical. (Two font descriptions may result in identical fonts being loaded, but still compare <seelangword="false"/>.)</remarks>
<value> The family name field. (Will be <seelangword="null"/> if not previously set.)</value>
<remarks>The family name represents a family of related font styles, and will resolve to a particular <seecref="T:Pango.FontFamily"/>. In some uses of <seecref="T:Pango.FontDescription"/> , it is also possible to use a comma separated list of family names for this property.</remarks>
<summary>Sets the family name of the font without copying the string.</summary>
<value/>
<remarks>The family name represents a family of related font styles, and will resolve to a particular <seecref="T:Pango.FontFamily"/>. In some uses of <seecref="T:Pango.FontDescription"/>, it is also possible to use a comma separated list of family names for this property.</remarks>
<paramname="str">The string representation of the font description.</param>
<summary>Creates a new font description from a string representation.</summary>
<returns>The object of type <seecref="T:Pango.FontDescription"/> created.</returns>
<remarks>The form of the string representation is "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where:
<listtype="bullet"><item><term>FAMILY-LIST is a comma separated list of families optionally terminated by a comma.</term></item><item><term>STYLE-OPTIONS is a whitespace separated list of words where each WORD describes one of style, variant, weight, or stretch.</term></item><item><term>SIZE is a decimal number (size in points)</term></item></list><para>
Any one of the options may be absent. If FAMILY-LIST is absent, then the family_name field of the resulting font description will be initialized to NULL. If STYLE-OPTIONS is missing, then all style options will be set to the default values. If SIZE is missing, the size in the resulting font description will be set to 0.
<paramname="desc_to_merge">The <seecref="T:Pango.FontDescription"/> to merge from.</param>
<paramname="replace_existing">If <seelangword="true"/>, replace fields in current instance with the corresponding values from <paramrefname="desc_to_merge"/>, even if they are already exist.</param>
<summary>Merges the fields of a font description into the current instance.</summary>
<paramname="desc_to_merge">an object of type <seecref="T:Pango.FontDescription"/></param>
<paramname="replace_existing">an object of type <seecref="T:System.Boolean"/></param>
<summary>Merges the fields of a font description into the current instance without copying the field data (shallow copy).</summary>
<remarks>Like <seecref="T:Pango.FontDescription.Merge()"/>, but only a shallow copy is made of the family name and other allocated fields. desc can only be used until <paramrefname="desc_to_merge"/> is modified or freed. This is meant to be used when the merged font description is only needed temporarily.</remarks>
<summary>The size of the font in fractional points.</summary>
<value>
<para>
The size field for the font description scaled by <seecref="F:Pango.Scale.PangoScale"/>. Setting this field is in fractional points. When getting the Size the value is either in points or device units. Use <seecref="P:Pango.FontDescription.SizeIsAbsolute"/> to find out which is the case.
</para>
<para>
Returns 0 if the size field has not previously been set. Use <seecref="M:Pango.FontDescription.SetFields()"/> to find out if the field was explicitly set or not.
</para>
</value>
<remarks>
<para>There are <seecref="F:Pango.Scale.PangoScale"/> pango units in one device unit - for fonts, font points are the device unit. Therefore, the size of the font in points is <seecref="P:Pango.FontDescription.Size"/> / <seecref="F:Pango.Scale.PangoScale"/>.</para>
<para>Use <seecref="P:Pango.FontDescription.AbsoluteSize"/> if you need to set a particular size in device units</para>
<value> the style for the font description</value>
<remarks>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.</remarks>
<summary>Creates a filename representation of a font description.</summary>
<returns>an object of type <seecref="T:System.String"/></returns>
<remarks>The filename created is identical to the result from calling <seecref="M:Pango.FontDescription.ToString"/>, but with underscores instead of characters that are untypical in filenames, and in lower case only.</remarks>
<paramname="to_unset">an object of type <seecref="T:Pango.FontMask"/>
(bitmask of fields in the desc to unset).</param>
<summary>Unsets some of the fields in the <seecref="T:Pango.FontDescription"/>.</summary>
<remarks>This merely marks the fields cleared, it does not clear the settings for those fields. To clear a family name set with <seecref="P:Pango.FontDescription.FamilyStatic"/> so that it won't be returned by <seecref="P:Pango.FontDescription.Family"/>, you must actually set <seecref="P:Pango.FontDescription.Family"/> to <seelangword="null"/>.</remarks>
<summary>The weight (boldness) of the font.</summary>
<value> the weight for the font description.</value>
<remarks>The weight property specifies how bold or light the font should be. In addition to the values of the <seecref="T:Pango.Weight"/> enumeration, other intermediate numeric values are possible.</remarks>