IDWriteFontSet4::GetMatchingFonts method (dwrite_3.h)
Generates a matching font set based on the requested inputs, ordered so that nearer matches are earlier.
HRESULT GetMatchingFonts( WCHAR const *familyName, DWRITE_FONT_AXIS_VALUE const *fontAxisValues, UINT32 fontAxisValueCount, DWRITE_FONT_SIMULATIONS allowedSimulations, IDWriteFontSet4 **matchingFonts );
Type: _In_z_ WCHAR const*
Font family name. This can be: a typographic family name, weight/stretch/style family name, GDI (RBIZ) family name, or full name.
Type: _In_reads_(fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*
Array of font axis values.
Number of font axis values.
Specifies which simulations (that is, algorithmic emboldening and/or slant) may be applied to matching fonts to better match the specified axis values. If the argument is DWRITE_FONT_SIMULATIONS_NONE (0), then no simulations are applied.
Type: _COM_Outptr_ IDWriteFontSet4**
Receives a pointer to a newly-created font set, which contains a prioritized list of fonts that match the specified inputs.
This can yield distinct items that were not in the original font set, including items with simulation flags (if they would be a closer match to the request) and instances that were not named by the font author. Items from the same font resources are collapsed into one: the closest possible match.
|Minimum supported client||Windows 11 Build 22621|