OfficeTextShapingRequest
OfficeIMO.Drawing
Describes a Unicode text run and font passed to a shared shaping provider.
Inheritance
- object
- OfficeTextShapingRequest
Usage
Explore 2 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.
Accepted by parameters 2
Constructors
public OfficeTextShapingRequest(string text, string fontName, byte[] fontData, bool isOpenTypeCff, int unitsPerEm, OfficeTextDirection direction = Auto, string? language = null) #Creates an immutable text-shaping request.
Parameters
- text string
- Original UTF-16 text to shape.
- fontName string
- Display or resource name of the selected font.
- fontData byte[]
- Complete font-program snapshot.
- isOpenTypeCff bool
- True for OpenType/CFF outlines; false for TrueType outlines.
- unitsPerEm int
- Font design units per em.
- direction OfficeIMO.Drawing.OfficeTextDirection = Auto
- Resolved base direction for the run.
- language string? = null
- Optional BCP 47 language hint.
public OfficeTextShapingRequest(string text, string fontName, byte[] fontData, bool isOpenTypeCff, int unitsPerEm, OfficeTextDirection direction, string? language, OfficeTextFeatureSettings featureSettings) #Creates an immutable text-shaping request with explicit OpenType feature values.
Parameters
- text string
- fontName string
- fontData byte[]
- isOpenTypeCff bool
- unitsPerEm int
- direction OfficeIMO.Drawing.OfficeTextDirection
- language string?
- featureSettings OfficeIMO.Drawing.OfficeTextFeatureSettings
public OfficeTextShapingRequest(string text, string fontName, byte[] fontData, bool isOpenTypeCff, int unitsPerEm, OfficeTextDirection direction, string? language, CancellationToken cancellationToken) #Creates an immutable text-shaping request with cooperative cancellation.
Parameters
- text string
- fontName string
- fontData byte[]
- isOpenTypeCff bool
- unitsPerEm int
- direction OfficeIMO.Drawing.OfficeTextDirection
- language string?
- cancellationToken System.Threading.CancellationToken
public OfficeTextShapingRequest(string text, string fontName, byte[] fontData, bool isOpenTypeCff, int unitsPerEm, OfficeTextDirection direction, string? language, CancellationToken cancellationToken, int? fontCollectionIndex) #Creates an immutable text-shaping request for a selected face in a font collection.
Parameters
- text string
- fontName string
- fontData byte[]
- isOpenTypeCff bool
- unitsPerEm int
- direction OfficeIMO.Drawing.OfficeTextDirection
- language string?
- cancellationToken System.Threading.CancellationToken
- fontCollectionIndex int?
public OfficeTextShapingRequest(string text, string fontName, byte[] fontData, bool isOpenTypeCff, int unitsPerEm, OfficeTextDirection direction, string? language, CancellationToken cancellationToken, int? fontCollectionIndex, IReadOnlyDictionary<string, float>? variationCoordinates) #Creates an immutable text-shaping request for a selected variable-font instance.
Parameters
- text string
- fontName string
- fontData byte[]
- isOpenTypeCff bool
- unitsPerEm int
- direction OfficeIMO.Drawing.OfficeTextDirection
- language string?
- cancellationToken System.Threading.CancellationToken
- fontCollectionIndex int?
- variationCoordinates System.Collections.Generic.IReadOnlyDictionary<string, float>?
public OfficeTextShapingRequest(string text, string fontName, byte[] fontData, bool isOpenTypeCff, int unitsPerEm, OfficeTextDirection direction, string? language, CancellationToken cancellationToken, int? fontCollectionIndex, IReadOnlyDictionary<string, float>? variationCoordinates, OfficeTextFeatureSettings featureSettings) #Creates an immutable text-shaping request for a selected variable-font instance with explicit OpenType feature values.
Parameters
- text string
- fontName string
- fontData byte[]
- isOpenTypeCff bool
- unitsPerEm int
- direction OfficeIMO.Drawing.OfficeTextDirection
- language string?
- cancellationToken System.Threading.CancellationToken
- fontCollectionIndex int?
- variationCoordinates System.Collections.Generic.IReadOnlyDictionary<string, float>?
- featureSettings OfficeIMO.Drawing.OfficeTextFeatureSettings
Inherited Methods
Properties
public string FontName { get; } #Display or resource name of the selected font.
public byte[] FontData { get; } #Defensive snapshot of the complete font program.
public bool IsOpenTypeCff { get; } #True for OpenType/CFF outlines; false for TrueType outlines.
public int UnitsPerEm { get; } #Font design units per em used by glyph advances and offsets.
public int? FontCollectionIndex { get; } #Selected zero-based face when OfficeTextShapingRequest.FontData contains a TrueType collection.
public OfficeTextDirection Direction { get; } #Resolved base direction of the run.
public CancellationToken CancellationToken { get; } #Cancellation observed by cooperative host shapers.
public IReadOnlyDictionary<string, float> VariationCoordinates { get; } #Clamped design-space values for the selected variable-font instance.
public OfficeTextFeatureSettings FeatureSettings { get; } #Explicit OpenType feature values for this run.