GlyphTypeface Class

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Specifies a physical font face that corresponds to a font file on the disk.

public ref class GlyphTypeface : System::ComponentModel::ISupportInitialize

public class GlyphTypeface : System.ComponentModel.ISupportInitialize

type GlyphTypeface = class
    interface ISupportInitialize

Public Class GlyphTypeface
Implements ISupportInitialize

Inheritance

Object

GlyphTypeface

Implements

ISupportInitialize

Remarks

The GlyphTypeface object is a low level text object that corresponds to a single face of a font family as represented by an OpenType font file, or serialized as a block of memory in a document. The correct GlyphTypeface to use for a run of characters in a given logical font is normally determined by the WPF font system and recorded in the GlyphRun objects generated by the FormattedText object and line formatting text APIs.

The GlyphTypeface provides properties and methods for:

• Obtaining font face common metrics, such as the ratio of ascent and descent to em size.

• Obtaining metrics, outlines, and bitmaps for individual glyphs.

• Serialization in a document.

The following list describes the type of application scenarios that illustrate the value of using the low-level control that the GlyphTypeface object provides.

• A fixed format document generator may use the GlyphTypeface to obtain a binary image of the font for embedding in a document container

• A printer driver may use the GlyphTypeface to obtain font glyph outlines or bitmaps, or the entire font image for sending to the printer.

• A GlyphTypeface viewer application may use the GlyphTypeface to obtain metric and bitmap information.

Each glyph defines metrics that specify how it aligns with other Glyphs. The following graphic defines metric values for glyph characters.

Metric values of glyph characters

Constructors

GlyphTypeface()	Initializes a new instance of the GlyphTypeface class.
GlyphTypeface(Uri)	Initializes a new instance of the GlyphTypeface class using the specified font file location.
GlyphTypeface(Uri, StyleSimulations)	Initializes a new instance of the GlyphTypeface class using the specified font file location and StyleSimulations value.

Properties

AdvanceHeights	Gets the advance heights for the glyphs represented by the GlyphTypeface object.
AdvanceWidths	Gets the advance widths for the glyphs represented by the GlyphTypeface object.
Baseline	Gets the baseline value for the GlyphTypeface.
BottomSideBearings	Gets the distance from bottom edge of the black box to the bottom end of the advance vector for the glyphs represented by the GlyphTypeface object.
CapsHeight	Gets the distance from the baseline to the top of an English capital, relative to em size, for the GlyphTypeface object.
CharacterToGlyphMap	Gets the nominal mapping of a Unicode code point to a glyph index as defined by the font 'CMAP' table.
Copyrights	Gets the copyright information for the GlyphTypeface object.
Descriptions	Gets the description information for the GlyphTypeface object.
DesignerNames	Gets the designer information for the GlyphTypeface object.
DesignerUrls	Gets the designer URL information for the GlyphTypeface object.
DistancesFromHorizontalBaselineToBlackBoxBottom	Gets the offset value from the horizontal Western baseline to the bottom of the glyph black box for the glyphs represented by the GlyphTypeface object.
EmbeddingRights	Gets the font embedding permission for the GlyphTypeface object.
FaceNames	Gets the face name for the GlyphTypeface object.
FamilyNames	Gets the family name for the GlyphTypeface object.
FontUri	Gets or sets the URI for the GlyphTypeface object.
GlyphCount	Gets the number of glyphs for the GlyphTypeface object.
Height	Gets the height of the character cell relative to the em size.
LeftSideBearings	Gets the distance from the leading end of the advance vector to the left edge of the black box for the glyphs represented by the GlyphTypeface object.
LicenseDescriptions	Gets the font license description information for the GlyphTypeface object.
ManufacturerNames	Gets the font manufacturer information for the GlyphTypeface object.
RightSideBearings	Gets the distance from the right edge of the black box to the right end of the advance vector for the glyphs represented by the GlyphTypeface object.
SampleTexts	Gets the sample text information for the GlyphTypeface object.
Stretch	Gets the FontStretch value for the GlyphTypeface object.
StrikethroughPosition	Gets a value that indicates the distance from the baseline to the strikethrough for the typeface.
StrikethroughThickness	Gets a value that indicates the thickness of the strikethrough relative to the font em size.
Style	Gets the style for the GlyphTypeface object.
StyleSimulations	Gets or sets the StyleSimulations for the GlyphTypeface object.
Symbol	Gets a value that indicates whether the GlyphTypeface font conforms to Unicode encoding.
TopSideBearings	Gets the distance from the top end of the vertical advance vector to the top edge of the black box for the glyphs represented by the GlyphTypeface object.
Trademarks	Gets the trademark notice information for the GlyphTypeface object.
UnderlinePosition	Gets the position of the underline in the GlyphTypeface.
UnderlineThickness	Gets the thickness of the underline relative to em size.
VendorUrls	Gets the vendor URL information for the GlyphTypeface object.
Version	Gets the font face version interpreted from the font's 'NAME' table.
VersionStrings	Gets the version string information for the GlyphTypeface object interpreted from the font's 'NAME' table.
Weight	Gets the designed weight of the font represented by the GlyphTypeface object.
Win32FaceNames	Gets the Win32 face name for the font represented by the GlyphTypeface object.
Win32FamilyNames	Gets the Win32 family name for the font represented by the GlyphTypeface object.
XHeight	Gets the Western x-height relative to em size for the font represented by the GlyphTypeface object.

Methods

ComputeSubset(ICollection<UInt16>)	Returns the binary image of the font subset based on a specified collection of glyphs.
Equals(Object)	Determines whether the specified object is equal to the current GlyphTypeface object.
GetFontStream()	Returns the font file stream represented by the GlyphTypeface object.
GetGlyphOutline(UInt16, Double, Double)	Returns a Geometry value describing the path for a single glyph in the font.
GetHashCode()	Serves as a hash function for GlyphTypeface.
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Explicit Interface Implementations

ISupportInitialize.BeginInit()	For a description of this member, see BeginInit().
ISupportInitialize.EndInit()	For a description of this member, see EndInit().

See also

• Glyphs
• GlyphRun