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
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |