IDWriteTextLayout::GetClusterMetrics 메서드(dwrite.h)

각 문자 모양 클러스터의 논리적 속성 및 측정값을 검색합니다.

구문

HRESULT GetClusterMetrics(
  [out, optional] DWRITE_CLUSTER_METRICS *clusterMetrics,
                  UINT32                 maxClusterCount,
  [out]           UINT32                 *actualClusterCount
);

매개 변수

[out, optional] clusterMetrics

형식: DWRITE_CLUSTER_METRICS*

이 메서드가 반환되면 문자 모양 클러스터에 대한 줄 바꿈 또는 전체 진행 너비와 같은 메트릭이 포함됩니다.

maxClusterCount

형식: UINT32

clusterMetrics 배열의 최대 크기입니다.

[out] actualClusterCount

형식: UINT32*

이 메서드가 반환될 때 필요한 clusterMetrics 배열의 실제 크기를 포함합니다.

반환 값

형식: HRESULT

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

설명

maxClusterCount가 충분히 크지 않으면 HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)과 동일한 E_NOT_SUFFICIENT_BUFFER 반환되고 actualClusterCount가 필요한 클러스터 수로 설정됩니다.

요구 사항

지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dwrite.h
라이브러리	Dwrite.lib
DLL	Dwrite.dll

추가 정보

IDWriteTextLayout