IDWriteTextLayout::GetClusterMetrics メソッド

各グリフ クラスターの論理プロパティおよび測定値を取得します。

構文

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

パラメーター

• clusterMetrics [out, optional]
  このメソッドが返されるときに、グリフ クラスターのメトリック (改行やアドバンス幅の合計など) が格納されます。

• maxClusterCount
  clusterMetrics 配列の最大サイズ。

• actualClusterCount [out]
  このメソッドが返されるときに、必要な clusterMetrics 配列の実際のサイズが格納されます。

戻り値

メソッドが成功した場合は、S_OK が返されます。 それ以外の場合は、エラー コードが返されます。HRESULT.

解説

maxClusterCount の大きさが不十分な場合は、HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) に相当する E_NOT_SUFFICIENT_BUFFER が返され、actualClusterCount が必要なクラスター数に設定されます。

要件

クライアントの最小要件	Windows 7, Windows Vista SP2 および Windows Vista 用のプラットフォーム更新プログラム
サーバーの最小要件	Windows Server 2008 R2, Windows Server 2008 SP2 および Windows Server 2008 用のプラットフォーム更新プログラム
ヘッダー	Dwrite.h
ライブラリ	Dwrite.lib
DLL	Dwrite.dll

参照

IDWriteTextLayout