Compartilhar via


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

   
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dwrite.h
Biblioteca Dwrite.lib
DLL Dwrite.dll

Confira também

IDWriteTextLayout