Windows Dev Center

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.

IDWriteFontCollection::FindFamilyName method

Finds the font family with the specified family name.

Syntax


virtual HRESULT FindFamilyName(
  [in]  const WCHAR  * familyName,
  [out]       UINT32 * index,
  [out]       BOOL   * exists
) = 0;

Parameters

familyName [in]

Type: const WCHAR*

An array of characters, which is null-terminated, containing the name of the font family. The name is not case-sensitive but must otherwise exactly match a family name in the collection.

index [out]

Type: UINT32*

When this method returns, contains the zero-based index of the matching font family if the family name was found; otherwise, UINT_MAX.

exists [out]

Type: BOOL*

When this method returns, TRUE if the family name exists; otherwise, FALSE.

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

IDWriteFontCollection

 

 

Community Additions

Show:
© 2015 Microsoft