IDWriteTextLayout::GetClusterMetrics-Methode (dwrite.h)

Ruft logische Eigenschaften und Messungen jedes Glyphenclusters ab.

Syntax

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

Parameter

[out, optional] clusterMetrics

Typ: DWRITE_CLUSTER_METRICS*

Wenn diese Methode zurückgibt, enthält Metriken, z. B. Zeilenumbruch oder gesamter Vorlaufbreite, für einen Glyphencluster.

maxClusterCount

Typ: UINT32

Die maximale Größe des clusterMetrics-Arrays .

[out] actualClusterCount

Typ: UINT32*

Wenn diese Methode zurückgegeben wird, enthält die tatsächliche Größe des erforderlichen clusterMetrics-Arrays .

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn maxClusterCount nicht groß genug ist, wird E_NOT_SUFFICIENT_BUFFER zurückgegeben, was HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) entspricht, und actualClusterCount wird auf die Anzahl der benötigten Cluster festgelegt.

Anforderungen

Weitere Informationen

Idwritetextlayout