IDWriteFontSetBuilder2::AddFont 메서드(dwrite_3.h)

작성 중인 집합에 글꼴을 추가합니다. 호출자가 축 범위를 검색하고 확인할 수 있는 충분한 정보를 제공하여 잠재적으로 로컬이 아닌 글꼴을 열 필요가 없도록 합니다.

통사론

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

매개 변수

fontFile

형식: idWriteFontFile

집합에 추가할 글꼴 파일 참조 개체입니다.

fontFaceIndex

형식: UINT32

컬렉션에 있는 글꼴 면의 인덱스(0부터 시작)입니다.

fontSimulations

형식: DWRITE_FONT_SIMULATIONS

알고리즘 강화 및 기울임꼴화를 위한 글꼴 얼굴 시뮬레이션 플래그입니다.

fontAxisValues

형식: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

형식: UINT32

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

fontAxisRanges

형식: DWRITE_FONT_AXIS_RANGE const *

축 범위 목록입니다.

fontAxisRangeCount

형식: UINT32

축 범위의 수입니다.

properties

형식: DWRITE_FONT_PROPERTY const *

참조와 연결할 속성 목록입니다.

propertyCount

형식: UINT32

정의된 속성의 수입니다.

반환 값

형식: HRESULT

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

발언

글꼴 속성에는 적어도 패밀리(오타나 두께/스타일/스트레치)가 포함되어야 합니다. 그렇지 않으면 이름이 아닌 인덱스로만 IDWriteFontSet에서 글꼴에 액세스할 수 있습니다.

요구 사항

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