API Reference
PdfEmbeddedFontFallbackSet
Pairs embedded fallback candidates with generated PDF font slots used for rendering planned fallback runs.
Inheritance
- Object
- PdfEmbeddedFontFallbackSet
Usage
This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.
Returned or exposed by
Accepted by parameters
Constructors
public PdfEmbeddedFontFallbackSet(IEnumerable<PdfEmbeddedFontFallbackCandidate> candidates, IEnumerable<PdfStandardFont> fontSlots) #Creates a reusable fallback set from prioritized candidates and matching generated font slots.
Parameters
- candidates System.Collections.Generic.IEnumerable{OfficeIMO.Pdf.PdfEmbeddedFontFallbackCandidate}
- Fallback font candidates in priority order.
- fontSlots System.Collections.Generic.IEnumerable{OfficeIMO.Pdf.PdfStandardFont}
- Generated standard-font family slots ordered the same way as candidates.
Methods
public IReadOnlyList<PdfTextShapingDiagnostic> AnalyzeAdvancedTextLayout(String text, String source = "", PdfTextShapingMode shapingMode = UnicodeScalar) #IReadOnlyList<PdfTextShapingDiagnostic>Finds advanced-layout warnings for text planned against this fallback set, including selected-font OpenType feature gaps.
Parameters
- text System.String
- Text to inspect.
- source System.String = ""
- Optional caller-provided source label such as a block, field, sheet, slide, or converter area.
- shapingMode OfficeIMO.Pdf.PdfTextShapingMode = UnicodeScalar
- Text shaping mode to use when checking fallback font coverage.
Returns
Advanced text layout diagnostics in source order, with duplicate warning families collapsed.
public PdfTextFallbackPlan PlanText(String text, String source = "", PdfTextShapingMode shapingMode = UnicodeScalar) #PdfTextFallbackPlanPlans fallback coverage for text using this set's prioritized candidates.
Parameters
- text System.String
- Text to inspect.
- source System.String = ""
- Optional caller-provided source label such as a block, field, sheet, slide, or converter area.
- shapingMode OfficeIMO.Pdf.PdfTextShapingMode = UnicodeScalar
- Text shaping mode to use when checking fallback font coverage.
Returns
A fallback plan with covered text segments and missing-glyph diagnostics.
public IReadOnlyList<TextRun> PlanTextRuns(String text, String source = "", TextRun styleTemplate = null, PdfTextShapingMode shapingMode = UnicodeScalar) #IReadOnlyList<TextRun>Plans text and converts a fully covered plan into styled rich text runs assigned to this set's generated font slots.
Parameters
- text System.String
- Text to inspect and convert.
- source System.String = ""
- Optional caller-provided source label such as a block, field, sheet, slide, or converter area.
- styleTemplate OfficeIMO.Pdf.TextRun = null
- Optional run whose styling is copied to each generated text run.
- shapingMode OfficeIMO.Pdf.PdfTextShapingMode = UnicodeScalar
- Text shaping mode to use when checking fallback font coverage.
Returns
Text runs that can be used with rich paragraphs, lists, tables, panels, and canvas text boxes.
public PdfOptions RegisterFonts(PdfOptions options) #PdfOptionsRegisters every fallback candidate into its generated font family slot, including bold and italic variants.
Parameters
- options OfficeIMO.Pdf.PdfOptions
- PDF options to configure.
Returns
The supplied options for fluent chaining.
public Boolean TryPlanTextRuns(String text, out IReadOnlyList<TextRun> runs, String source = "", TextRun styleTemplate = null, PdfConversionReport report = null, String converter = "OfficeIMO.Pdf", PdfTextShapingMode shapingMode = UnicodeScalar) #BooleanPlans text and returns renderable rich text runs only when every non-layout scalar is covered.
Parameters
- text System.String
- Text to inspect and convert.
- runs System.Collections.Generic.IReadOnlyList{OfficeIMO.Pdf.TextRun}@
- Renderable rich text runs when the plan is fully covered; otherwise an empty collection.
- source System.String = ""
- Optional caller-provided source label such as a block, field, sheet, slide, or converter area.
- styleTemplate OfficeIMO.Pdf.TextRun = null
- Optional run whose styling is copied to each generated text run.
- report OfficeIMO.Pdf.PdfConversionReport = null
- Optional conversion report that receives missing-glyph diagnostics from incomplete plans.
- converter System.String = "OfficeIMO.Pdf"
- Converter or adapter name used when writing diagnostics to report.
- shapingMode OfficeIMO.Pdf.PdfTextShapingMode = UnicodeScalar
- Text shaping mode to use when checking fallback font coverage.
Returns
true when runs contains a fully covered renderable plan; otherwise false.