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

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

통사론

HRESULT GetMatchingFonts(
  WCHAR const                  *familyName,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_SIMULATIONS      allowedSimulations,
  IDWriteFontSet4              **matchingFonts
);

매개 변수

familyName

형식: _In_z_ WCHAR const*

글꼴 패밀리 이름입니다. 입력 패밀리 이름, 가중치/스트레치/스타일 패밀리 이름, GDI(RBIZ) 패밀리 이름 또는 전체 이름일 수 있습니다.

fontAxisValues

형식: _In_reads_(fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*

글꼴 축 값의 배열입니다.

fontAxisValueCount

형식: UINT32

글꼴 축 값의 수입니다.

allowedSimulations

형식: DWRITE_FONT_SIMULATIONS

지정된 축 값과 더 잘 일치하도록 일치하는 글꼴에 적용할 수 있는 시뮬레이션(즉, 알고리즘 강화 및/또는 기울기)을 지정합니다. 인수가 DWRITE_FONT_SIMULATIONS_NONE(0)이면 시뮬레이션이 적용되지 않습니다.

matchingFonts

형식: _COM_Outptr_ IDWriteFontSet4**

지정된 입력과 일치하는 우선 순위가 지정된 글꼴 목록을 포함하는 새로 만든 글꼴 집합에 대한 포인터를 받습니다.

반환 값

형식: HRESULT

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

발언

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

요구 사항