IDWriteFontFamily::GetMatchingFonts method
Gets a list of fonts in the font family ranked in order of how well they match the specified properties.
Syntax
virtual HRESULT GetMatchingFonts(
DWRITE_FONT_WEIGHT weight,
DWRITE_FONT_STRETCH stretch,
DWRITE_FONT_STYLE style,
[out] IDWriteFontList ** matchingFonts
) = 0;
Parameters
- weight
-
Type: DWRITE_FONT_WEIGHT
A value that is used to match a requested font weight.
- stretch
-
Type: DWRITE_FONT_STRETCH
A value that is used to match a requested font stretch.
- style
-
Type: DWRITE_FONT_STYLE
A value that is used to match a requested font style.
- matchingFonts [out]
-
Type: IDWriteFontList**
An address of a pointer to the newly created IDWriteFontList object.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Requirements
|
Minimum supported client |
Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps] |
|
Minimum supported phone |
Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also