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

요청된 입력에 따라 일치하는 글꼴 집합을 검색하여 더 가까운 일치 항목이 더 일찍 정렬되도록 정렬합니다.

통사론

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const   *fontProperty,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  IDWriteFontSet1              **matchingFonts
);

매개 변수

fontProperty

형식: DWRITE_FONT_PROPERTY const *

글꼴 속성(예: 오타 패밀리 또는 두께/스트레치/스타일 패밀리)입니다.

fontAxisValues

형식: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

형식: UINT32

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

matchingFonts

형식: IDWriteFontSet1**

IDWriteFontSet1 인터페이스에 대한 포인터의 주소입니다. 성공적으로 완료되면 함수는 포인터를 속성과 일치하는 우선 순위가 지정된 글꼴 목록으로 설정하고, 그렇지 않으면 포인터를 nullptr설정합니다.

반환 값

형식: HRESULT

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

발언

이 메서드는 시뮬레이션 플래그가 있는 항목(요청과 더 가까운 경우)과 글꼴 작성자가 이름을 지정하지 않은 인스턴스를 포함하여 원래 글꼴 집합에 없는 고유 항목을 생성할 수 있습니다. 동일한 글꼴 리소스의 항목은 가능한 가장 가까운 일치 항목으로 축소됩니다.

요구 사항