Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IDWriteFontFamily::GetFirstMatchingFont method

Gets the font that best matches the specified properties.

Syntax


virtual HRESULT GetFirstMatchingFont(
        DWRITE_FONT_WEIGHT   weight,
        DWRITE_FONT_STRETCH  stretch,
        DWRITE_FONT_STYLE    style,
  [out] IDWriteFont         ** matchingFont
) = 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.

matchingFont [out]

Type: IDWriteFont**

When this method returns, contains the address of a pointer to the newly created IDWriteFont 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

Dwrite.h

Library

Dwrite.lib

DLL

Dwrite.dll

See also

IDWriteFontFamily

 

 

Community Additions

Show:
© 2016 Microsoft