IDWriteTextLayout::GetLineMetrics 方法 (dwrite.h)
擷取文字字串中每個個別文字行的相關資訊。
語法
HRESULT GetLineMetrics(
[out, optional] DWRITE_LINE_METRICS *lineMetrics,
UINT32 maxLineCount,
[out] UINT32 *actualLineCount
);
參數
[out, optional] lineMetrics
類型: DWRITE_LINE_METRICS*
當這個方法傳回時,會包含結構陣列的指標,其中包含個別文字行的各種計算長度值。
maxLineCount
類型: UINT32
lineMetrics陣列的大小上限。
[out] actualLineCount
類型: UINT32*
當這個方法傳回時,會包含所需的 lineMetrics 陣列實際大小。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
如果 maxLineCount 不夠大,E_NOT_SUFFICIENT_BUFFER相當於HRESULT_FROM_WIN32 (ERROR_INSUFFICIENT_BUFFER) ,則會傳回 *actualLineCount,並將 *actualLineCount 設定為所需的行數。
需求
最低支援的用戶端 | 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | dwrite.h |
程式庫 | Dwrite.lib |
Dll | Dwrite.dll |