OfficeFontFaceCollection
OfficeIMO.Drawing
Scoped caller-supplied font faces used by drawing measurement, rasterization, and SVG export. Direct TrueType/OpenType, WOFF 1, WOFF 2, CFF/CFF2, and variable-font containers are handled by the first-party engine. An optional provider can override program loading for specialized engines.
Inheritance
- object
- OfficeFontFaceCollection
Usage
Explore 18 API references to this type
This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.
Returned or exposed by 13
- Property OfficeDrawing.Fonts
- Method OfficeFontFaceCollection.Add
- Method OfficeFontFaceCollection.AddAlias
- Method OfficeFontFaceCollection.AddFallbackFamily
- Method OfficeFontFaceCollection.AddRange
- Method OfficeFontFaceCollection.AddRangePreservingExisting
- Method OfficeFontFaceCollection.Clone
- Property OfficeFontFallbackPack.Fonts
- Property OfficeImageExportOptions.Fonts
- Property OfficeMathRenderOptions.Fonts
- Property OfficeRasterTextOptions.Fonts
- Property OfficeRenderingProfile.Fonts
- Property OfficeSvgDrawingReaderOptions.Fonts
Accepted by parameters 5
- Method OfficeFontFaceCollection.AddRange
- Method OfficeFontFaceCollection.AddRangePreservingExisting
- Constructor OfficeFontFallbackPack.OfficeFontFallbackPack
- Constructor OfficeRasterCanvas.OfficeRasterCanvas
- Constructor OfficeRenderingProfile.OfficeRenderingProfile
Constructors
public OfficeFontFaceCollection() #Creates an empty scoped font collection.
Methods
public OfficeFontFaceCollection Add(string familyName, byte[] data, OfficeFontStyle style = Regular) #Adds or replaces one family/style face. Invalid or unsupported font bytes throw.
Parameters
- familyName string
- data byte[]
- style OfficeIMO.Drawing.OfficeFontStyle = Regular
Returns
OfficeFontFaceCollectionpublic OfficeFontFaceCollection Add(string familyName, byte[] data, OfficeFontFaceDescriptor descriptor) #Adds or replaces one numerically described family face. Invalid or unsupported font bytes throw.
Parameters
- familyName string
- data byte[]
- descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor
Returns
OfficeFontFaceCollectionpublic OfficeFontFaceCollection Add(string familyName, byte[] data, OfficeFontStyle style, OfficeFontUnicodeRangeSet unicodeRanges) #Adds or replaces one unicode-range-constrained family/style face. A deterministic internal resource family is assigned when the range does not cover all Unicode scalars.
Parameters
- familyName string
- data byte[]
- style OfficeIMO.Drawing.OfficeFontStyle
- unicodeRanges OfficeIMO.Drawing.OfficeFontUnicodeRangeSet
Returns
OfficeFontFaceCollectionpublic OfficeFontFaceCollection Add(string familyName, byte[] data, OfficeFontFaceDescriptor descriptor, OfficeFontUnicodeRangeSet unicodeRanges) #Adds or replaces one unicode-range-constrained, numerically described family face.
Parameters
- familyName string
- data byte[]
- descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor
- unicodeRanges OfficeIMO.Drawing.OfficeFontUnicodeRangeSet
Returns
OfficeFontFaceCollectionpublic OfficeFontFaceCollection AddAlias(string aliasFamilyName, string sourceFamilyName) #Adds another family name for all faces already registered under an existing family. The alias reuses the immutable decoded font programs without decoding or copying them again.
Parameters
- aliasFamilyName string
- Additional family name accepted by measurement and export.
- sourceFamilyName string
- Existing family whose faces and unicode ranges are reused.
public OfficeFontFaceCollection AddFallbackFamily(string familyName) #Appends one registered family to the fallback chain used when requested faces do not cover a text element.
Parameters
- familyName string
- Registered family or resource family name to append.
public OfficeFontFaceCollection AddRange(OfficeFontFaceCollection? fonts) #Adds independent copies of all faces from another collection.
Parameters
- fonts OfficeIMO.Drawing.OfficeFontFaceCollection?
Returns
OfficeFontFaceCollectionpublic OfficeFontFaceCollection AddRangePreservingExisting(OfficeFontFaceCollection? fonts) #Adds independent copies of faces from another collection without replacing faces already registered under the same family, resource family, and style. Added faces are considered before existing fallback families, while existing document-scoped faces retain precedence.
Parameters
- fonts OfficeIMO.Drawing.OfficeFontFaceCollection?
Returns
OfficeFontFaceCollectionpublic OfficeFontFaceCollection Clone() #Creates an independent collection snapshot.
Returns
OfficeFontFaceCollectionpublic IReadOnlyList<OfficeFontFallbackRun> PlanFallbackRuns(string? text, string? familyNames, OfficeFontStyle style = Regular) #Splits text into grapheme-safe runs using the first scoped family whose selected face covers each text element. Unresolved elements retain the original family list for platform or adapter fallback.
Parameters
- text string?
- familyNames string?
- style OfficeIMO.Drawing.OfficeFontStyle = Regular
Returns
IReadOnlyList<OfficeFontFallbackRun>public IReadOnlyList<OfficeFontFallbackRun> PlanFallbackRuns(string? text, string? familyNames, OfficeFontFaceDescriptor descriptor) #Splits text into grapheme-safe runs after matching numeric weight, stretch, and slant for each family.
Parameters
- text string?
- familyNames string?
- descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor
Returns
IReadOnlyList<OfficeFontFallbackRun>public bool TryAdd(string? familyName, byte[]? data, OfficeFontStyle style = Regular) #Attempts to add or replace one family/style face without throwing for unsupported font data.
Parameters
- familyName string?
- data byte[]?
- style OfficeIMO.Drawing.OfficeFontStyle = Regular
Returns
boolpublic bool TryAdd(string? familyName, byte[]? data, OfficeFontFaceDescriptor descriptor) #Attempts to add or replace one numerically described family face.
Parameters
- familyName string?
- data byte[]?
- descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor
Returns
boolpublic bool TryAdd(string? familyName, byte[]? data, OfficeFontStyle style, OfficeFontUnicodeRangeSet? unicodeRanges) #Attempts to add or replace one unicode-range-constrained family/style face. A deterministic internal resource family is assigned when the range does not cover all Unicode scalars.
Parameters
- familyName string?
- data byte[]?
- style OfficeIMO.Drawing.OfficeFontStyle
- unicodeRanges OfficeIMO.Drawing.OfficeFontUnicodeRangeSet?
Returns
boolpublic bool TryAdd(string? familyName, byte[]? data, OfficeFontFaceDescriptor descriptor, OfficeFontUnicodeRangeSet? unicodeRanges) #Attempts to add or replace one unicode-range-constrained, numerically described family face.
Parameters
- familyName string?
- data byte[]?
- descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor
- unicodeRanges OfficeIMO.Drawing.OfficeFontUnicodeRangeSet?
Returns
boolpublic bool TryMeasureText(string? text, double fontSize, string? familyNames, OfficeFontStyle style, out double width) #Attempts to measure text with a matching scoped face.
Parameters
- text string?
- fontSize double
- familyNames string?
- style OfficeIMO.Drawing.OfficeFontStyle
- width double
Returns
boolpublic bool TryResolveFaceForText(string? text, string? familyNames, OfficeFontStyle style, out OfficeFontFace? face) #Resolves the scoped face that covers the supplied text for the requested CSS/Office family list and style. This uses the same unicode-range and fallback rules as measurement and rendering, requesting weight 400 for regular text or 700 for bold text with the corresponding upright or italic slant.
Parameters
- text string?
- familyNames string?
- style OfficeIMO.Drawing.OfficeFontStyle
- face OfficeIMO.Drawing.OfficeFontFace?
Returns
boolpublic bool TryResolveFaceForText(string? text, string? familyNames, OfficeFontStyle style, double fontSize, out OfficeFontFace? face) #Resolves a face at the authored text size, selecting a built-in TrueType optical axis automatically unless the variation resolver explicitly supplied opsz. Provider-owned programs retain their provider-selected axes.
Parameters
- text string?
- familyNames string?
- style OfficeIMO.Drawing.OfficeFontStyle
- fontSize double
- face OfficeIMO.Drawing.OfficeFontFace?
Returns
boolpublic bool TryResolveFaceForText(string? text, string? familyNames, OfficeFontFaceDescriptor descriptor, double fontSize, out OfficeFontFace? face) #Resolves numeric weight, stretch, and slant with automatic built-in TrueType optical sizing.
Parameters
- text string?
- familyNames string?
- descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor
- fontSize double
- face OfficeIMO.Drawing.OfficeFontFace?
Returns
boolpublic bool TryResolveFaceForText(string? text, string? familyNames, OfficeFontFaceDescriptor descriptor, out OfficeFontFace? face) #Resolves a scoped face using numeric weight, stretch, and slant matching.
Parameters
- text string?
- familyNames string?
- descriptor OfficeIMO.Drawing.OfficeFontFaceDescriptor
- face OfficeIMO.Drawing.OfficeFontFace?
Returns
boolInherited Methods
Properties
public IOfficeFontProgramProvider? FontProgramProvider { get; set; } #Optional decoder and outline engine for formats outside the dependency-free core. The provider reference is retained by collection clones; decoded face programs are immutable.
public Func<OfficeFontProgramLoadRequest, IReadOnlyDictionary<string, float>?>? FontVariationResolver { get; set; } #Optional variable-font axis resolver invoked for each accepted face. Values are clamped to the font-defined axis range; unknown axes and non-finite values fail closed.
public IReadOnlyList<OfficeFontFace> Faces { get; } #Registered faces in registration order.
public IReadOnlyList<string> FallbackFamilies { get; } #Registered fallback families considered after the families requested by a text run.