OnFontSubstituted

ConversionEvents.OnFontSubstituted property

Fired when a font referenced by the source document is not available and is substituted (either by a customer-supplied FontSubstitute rule, by the configured default font, or by the conversion pipeline’s internal fallback).

public Action<FontSubstitutionContext> OnFontSubstituted { get; set; }

Remarks

The event is deduplicated per (SourceFileName, OriginalFontName) within a single Converter.Convert(...) call — subscribers receive at most one notification per missing font per source document. Fires synchronously on the conversion thread. Not raised for image conversions.

For presentation documents, font substitution is detected only on Windows, because the engine resolves it through platform-specific font matching that is unavailable on other operating systems.

See Also