IDWriteFactory3::GetSystemFontCollection method

Retrieves a weight/width/slope tree of system fonts.

Syntax

HRESULT GetSystemFontCollection(
   BOOL                   includeDownloadableFonts,
   IDWriteFontCollection1 **fontCollection,
   BOOL                   includeDownloadableFonts = FALSE
);

Parameters

includeDownloadableFonts

Type: BOOL

Indicates whether to include cloud fonts or only locally installed fonts.

fontCollection

Type: IDWriteFontCollection1**

Holds the newly created font collection object, or NULL in case of failure.

includeDownloadableFonts

Type: BOOL

If this parameter is TRUE, the function performs an immediate check for changes to the set of system fonts. If this parameter is FALSE, the function will still detect changes if the font cache service is running, but there may be some latency. For example, an application might specify TRUE if it has just installed a font and wants to be sure the font collection contains that font.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

See also

IDWriteFactory3