SetTextJustification 函式 (wingdi.h)
SetTextJustification函式會指定系統應該新增至文字字串中中斷字元的空間量。 當應用程式呼叫 TextOut 或 ExtTextOut 函式時,就會新增空間。
語法
BOOL SetTextJustification(
[in] HDC hdc,
[in] int extra,
[in] int count
);
參數
[in] hdc
裝置內容的控制碼。
[in] extra
要新增至文字行的額外空間總計,以邏輯單位為單位。 如果目前的對應模式未MM_TEXT, nBreakExtra 參數所識別的值會轉換並四捨五入為最接近的圖元。
[in] count
行中的斷字元數。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。
備註
中斷字元通常是 ASCII 32) (空白字元,但可能由字型定義為其他字元。 GetTextMetrics函式可用來擷取字型的斷字元。
TextOut函式會將指定的額外空間平均分散在行中的分隔符號之間。
GetTextExtentPoint32函式一律會與SetTextJustification函式搭配使用。 有時候 ,GetTextExtentPoint32 函式會在計算指定行的寬度之前考慮理由,有時不會考慮。 如需詳細資訊,請參閱 GetTextExtentPoint32。 計算適當的 nBreakExtra 值之前,必須先知道此寬度。
SetTextJustification 可用來對齊包含不同字型中多個字串的行。 在此情況下,每個字串都必須分開對齊。
由於在理由期間可能會發生進位錯誤,因此系統會保留定義目前錯誤值的執行中錯誤字詞。 當調整包含多個執行的行時, GetTextExtentPoint 會在計算下一次執行的範圍時自動使用這個錯誤字詞,讓 TextOut 將錯誤混合到新的回合中。 在對齊每一行之後,必須清除這個錯誤字詞,以防止它併入下一行。 呼叫 SetTextJustification 並將 nBreakExtra 設定為零,即可清除字詞。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | wingdi.h (包含 Windows.h) |
程式庫 | Gdi32.lib |
Dll | Gdi32.dll |