다음을 통해 공유

IDWriteFontSet::GetMatchingFonts(WCHARconst*,DWRITE_FONT_WEIGHT,DWRITE_FONT_STRETCH,DWRITE_FONT_STYLE,IDWriteFontSet**) 메서드(dwrite_3.h)

  • 아티클

지정된 속성으로 필터링된 글꼴의 하위 집합을 반환합니다.

구문

HRESULT GetMatchingFonts(
  WCHAR const         *familyName,
  DWRITE_FONT_WEIGHT  fontWeight,
  DWRITE_FONT_STRETCH fontStretch,
  DWRITE_FONT_STYLE   fontStyle,
  IDWriteFontSet      **filteredSet
);

매개 변수

familyName

글꼴 패밀리 이름입니다.

fontWeight

글꼴 두께입니다.

fontStretch

글꼴 늘이기 값입니다.

fontStyle

글꼴 스타일입니다.

filteredSet

형식: [out] IDWriteFontSet**

속성과 일치하는 글꼴의 하위 집합이거나 실패 시 nullptr입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

필터와 일치하는 글꼴이 없으면 하위 집합이 비어 있지만(GetFontCount가 0을 반환함) 함수는 오류를 반환하지 않습니다. 하위 집합은 항상 원래 집합과 같거나 작습니다. 원격 글꼴만 필터링하려는 경우 속성에서 null을, propertyCount에서 0을 전달할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 dwrite_3.h
라이브러리 Dwrite.lib
DLL Dwrite.dll

추가 정보

IDWriteFontSet