Export (0) Print
Expand All

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

ADD
Show:
© 2014 Microsoft