IDWriteFontCollection2::GetMatchingFonts 메서드(dwrite_3.h)

지정된 글꼴 패밀리의 글꼴 목록을 검색하며 지정된 축 값과 얼마나 일치하는지 순서대로 순위가 지정됩니다.

통사론

HRESULT GetMatchingFonts(
        WCHAR const                  *familyName,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontList2             **fontList
);

매개 변수

familyName

형식: WCHAR const *

글꼴 패밀리의 이름입니다. 이름은 대/소문자를 구분하지 않지만 컬렉션의 패밀리 이름과 정확히 일치해야 합니다.

fontAxisValues

형식: DWRITE_FONT_AXIS_VALUE const *

글꼴 축 값 목록을 포함하는 배열에 대한 포인터입니다. 배열은 fontAxisValueCount 인수로 표시된 크기(요소 수)여야 합니다.

fontAxisValueCount

형식: UINT32

fontAxisValues 배열에 포함된 글꼴 축 값의 수입니다.

[out] fontList

형식: IDWriteFontList2**

IDWriteFontList2 인터페이스에 대한 포인터의 주소입니다. 성공적으로 완료되면 함수는 포인터를 새로 만든 글꼴 목록 개체로 설정합니다.

반환 값

형식: HRESULT

함수가 성공하면 S_OK반환합니다. 그렇지 않으면 HRESULT오류 코드반환합니다.

발언

일치하는 글꼴이 없으면 빈 목록 개체가 반환되지만(idWriteFontList::GetFontCount 호출하면 0이 반환되지만 함수는 오류를 반환하지 않습니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 10 빌드 16299
지원되는 최소 서버	Windows 10 빌드 16299
대상 플랫폼	Windows
헤더	dwrite_3.h
라이브러리	Dwrite.lib