<summary>
Gets a font collection representing the set of end-user defined
custom fonts.
</summary>
<param name="fontCollection">Receives a pointer to the EUDC font
collection object, or NULL in case of failure.</param>
<param name="checkForUpdates">If this parameter is nonzero, the
function performs an immediate check for changes to the set of
EUDC fonts. If this parameter is FALSE, the function will still
detect changes, but there may be some latency. For example, an
application might specify TRUE if it has itself just modified a
font and wants to be sure the font collection contains that font.
</param>
<returns>
Standard HRESULT error code. Note that if no EUDC is set on the system,
the returned collection will be empty, meaning it will return success
but GetFontFamilyCount will be zero.
</returns>
<remarks>
Querying via IDWriteFontCollection::FindFamilyName for a specific
family (like MS Gothic) will return the matching family-specific EUDC
font if one exists. Querying for "" will return the global EUDC font.
For example, if you were matching an EUDC character within a run of
the base font PMingLiu, you would retrieve the corresponding EUDC font
face using GetEudcFontCollection, then FindFamilyName with "PMingLiu",
followed by GetFontFamily and CreateFontFace.
Be aware that eudcedit.exe can create placeholder empty glyphs that
have zero advance width and no glyph outline. Although they are present
in the font (HasCharacter returns true), you are best to ignore
these and continue on with font fallback in your layout if the metrics
for the glyph are zero.
</remarks>
<summary> Gets a font collection representing the set of end-user defined custom fonts. </summary> <param name="fontCollection">Receives a pointer to the EUDC font collection object, or NULL in case of failure.</param> <param name="checkForUpdates">If this parameter is nonzero, the function performs an immediate check for changes to the set of EUDC fonts. If this parameter is FALSE, the function will still detect changes, but there may be some latency. For example, an application might specify TRUE if it has itself just modified a font and wants to be sure the font collection contains that font. </param> <returns> Standard HRESULT error code. Note that if no EUDC is set on the system, the returned collection will be empty, meaning it will return success but GetFontFamilyCount will be zero. </returns> <remarks> Querying via IDWriteFontCollection::FindFamilyName for a specific family (like MS Gothic) will return the matching family-specific EUDC font if one exists. Querying for "" will return the global EUDC font. For example, if you were matching an EUDC character within a run of the base font PMingLiu, you would retrieve the corresponding EUDC font face using GetEudcFontCollection, then FindFamilyName with "PMingLiu", followed by GetFontFamily and CreateFontFace.
Be aware that eudcedit.exe can create placeholder empty glyphs that have zero advance width and no glyph outline. Although they are present in the font (HasCharacter returns true), you are best to ignore these and continue on with font fallback in your layout if the metrics for the glyph are zero. </remarks>