Método IDWriteTextLayout::GetClusterMetrics (dwrite.h)

Recupera as propriedades lógicas e as medidas de cada cluster de glifo.

Sintaxe

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

Parâmetros

[out, optional] clusterMetrics

Tipo: DWRITE_CLUSTER_METRICS*

Quando esse método retorna, contém métricas, como quebra de linha ou largura de avanço total, para um cluster de glifo.

maxClusterCount

Tipo: UINT32

O tamanho máximo da matriz clusterMetrics .

[out] actualClusterCount

Tipo: UINT32*

Quando esse método retorna, contém o tamanho real da matriz clusterMetrics necessária.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se maxClusterCount não for grande o suficiente, E_NOT_SUFFICIENT_BUFFER, que é equivalente a HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER), será retornado e actualClusterCount será definido como o número de clusters necessários.

Requisitos

Confira também

IDWriteTextLayout