SetTextJustification 函式 (wingdi.h)

發行項
08/27/2023

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