GlyphRun Class

 

Represents a sequence of glyphs from a single face of a single font at a single size, and with a single rendering style.

Namespace:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

System.Object
  System.Windows.Media.GlyphRun

public class GlyphRun : ISupportInitialize

NameDescription
System_CAPS_pubmethodGlyphRun()

Obsolete.Initializes a new instance of the GlyphRun class.

System_CAPS_pubmethodGlyphRun(GlyphTypeface, Int32, Boolean, Double, IList<UInt16>, Point, IList<Double>, IList<Point>, IList<Char>, String, IList<UInt16>, IList<Boolean>, XmlLanguage)

Obsolete.Initializes a new instance of the GlyphRun class by specifying properties of the class.

System_CAPS_pubmethodGlyphRun(GlyphTypeface, Int32, Boolean, Double, Single, IList<UInt16>, Point, IList<Double>, IList<Point>, IList<Char>, String, IList<UInt16>, IList<Boolean>, XmlLanguage)

Initializes a new instance of the GlyphRun class by specifying properties of the class.

System_CAPS_pubmethodGlyphRun(Single)

Initializes a new instance of the GlyphRun class.

NameDescription
System_CAPS_pubpropertyAdvanceWidths

Gets or sets the list of Double values that represent the advance widths corresponding to the glyph indices.

System_CAPS_pubpropertyBaselineOrigin

Gets or sets the baseline origin of the GlyphRun.

System_CAPS_pubpropertyBidiLevel

Gets or sets the bidirectional nesting level of the GlyphRun.

System_CAPS_pubpropertyCaretStops

Gets or sets the list of Boolean values that determine whether there are caret stops for every UTF16 code point in the Unicode representing the GlyphRun.

System_CAPS_pubpropertyCharacters

Gets or sets the list of UTF16 code points that represent the Unicode content of the GlyphRun.

System_CAPS_pubpropertyClusterMap

Gets or sets the list of UInt16 values that maps characters in the GlyphRun to glyph indices.

System_CAPS_pubpropertyDeviceFontName

Gets or sets the specific device font for which the GlyphRun has been optimized.

System_CAPS_pubpropertyFontRenderingEmSize

Gets or sets the em size used for rendering the GlyphRun.

System_CAPS_pubpropertyGlyphIndices

Gets or sets an array of UInt16 values that represent the glyph indices in the rendering physical font.

System_CAPS_pubpropertyGlyphOffsets

Gets or sets an array of Point values representing the offsets of the glyphs in the GlyphRun.

System_CAPS_pubpropertyGlyphTypeface

Gets or sets the GlyphTypeface for the GlyphRun.

System_CAPS_pubpropertyIsHitTestable

Gets a value indicating whether there are any valid caret character hits within the GlyphRun.

System_CAPS_pubpropertyIsSideways

Gets or sets a value indicating whether to rotate glyphs.

System_CAPS_pubpropertyLanguage

Gets or sets the XmlLanguage for the GlyphRun.

System_CAPS_pubpropertyPixelsPerDip

Get or sets the PixelsPerDip at which the text should be rendered.

NameDescription
System_CAPS_pubmethodBuildGeometry()

Retrieves the Geometry for the GlyphRun.

System_CAPS_pubmethodComputeAlignmentBox()

Retrieves the alignment box for the GlyphRun.

System_CAPS_pubmethodComputeInkBoundingBox()

Retrieves the ink bounding box for the GlyphRun.

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetCaretCharacterHitFromDistance(Double, Boolean)

Retrieves the CharacterHit value that represents the character hit of the caret of the GlyphRun.

System_CAPS_pubmethodGetDistanceFromCaretCharacterHit(CharacterHit)

Retrieves the offset from the leading edge of the GlyphRun to the leading or trailing edge of a caret stop containing the specified character hit.

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetNextCaretCharacterHit(CharacterHit)

Retrieves the next valid caret character hit in the logical direction in the GlyphRun.

System_CAPS_pubmethodGetPreviousCaretCharacterHit(CharacterHit)

Retrieves the previous valid caret character hit in the logical direction in the GlyphRun.

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

The GlyphRun object includes font details such as glyph indices and individual glyph positions. In addition, The GlyphRun object contains the original Unicode code points the run was generated from, character to glyph buffer offset mapping information, and per-character and per-glyph flags.

The Glyphs element represents the output of a GlyphRun in XAML. The following markup syntax is used to describe the Glyphs element.

<!-- The example shows how to use a Glyphs object. -->
<Page
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  >

   <StackPanel Background="PowderBlue">

      <Glyphs
         FontUri             = "C:\WINDOWS\Fonts\TIMES.TTF"
         FontRenderingEmSize = "100"
         StyleSimulations    = "BoldSimulation"
         UnicodeString       = "Hello World!"
         Fill                = "Black"
         OriginX             = "100"
         OriginY             = "200"
      />

   </StackPanel>
</Page>

Each glyph defines metrics that specify how it aligns with other Glyphs. The following graphic defines the various typographic qualities of two different glyph characters.

Diagraph of glyph measurements

Various typographic qualities of two different glyph characters

.NET Framework
Available since 3.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: