Метод 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 недостаточно велик, возвращается E_NOT_SUFFICIENT_BUFFER, эквивалентное HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER), а для параметра actualClusterCount устанавливается необходимое количество кластеров.

Требования

См. также раздел

IDWriteTextLayout