CDC::SetTextJustification

發行項
02/28/2013

將命名空間加入至字串的分行符號字元。

int SetTextJustification(
   int nBreakExtra,
   int nBreakCount 
);

參數

nBreakExtra
指定要加入的總額外空間至行文字 (以邏輯單位 (Logical Unit)。如果目前對應方式並不 MM_TEXT，這個參數指定的值轉換成目前對應模式並捨入至最接近的單位。
nBreakCount
會指定一行分行符號字元數目。

傳回值

一個，如果函式成功，則為 0。

備註

應用程式可以使用 GetTextMetrics 成員函式以取得字型的分行符號字元。

在 SetTextJustification 成員函式呼叫之後，對文字輸出函式的呼叫 (例如 TextOut) 在中斷字元間之指定數目的平均分佈。指定的額外空間。中斷連接通常是泛空白字元 (ASCII 32)，不過，也可以將字型定義為其他字元。

成員函式 GetTextExtent 通常用於 SetTextJustification。在GetTextExtent 對齊預先計算指定線條的寬度。應用程式可以判斷指定的幾個空格在 nBreakExtra 參數可以減去值從字串的寬度 ( GetTextExtent 傳回在對齊之後。

SetTextJustification 函式可以對齊包含多個回合以不同的字型的行。在這種情況下，必須透過對齊和寫入每個逐步的建立線條個別執行。

在對齊期間，由於像是可能會發生錯誤，則系統會保留定義目前錯誤執行錯誤詞彙。在對齊包含多個回合的行時， GetTextExtent 都會自動使用這個錯誤詞彙，在計算下執行時的程度。這可讓文字輸出函式混色錯誤輸入新的回合。

在每一行對齊後，必須清除此錯誤詞彙防止將合併到下一行。這個字上呼叫 SetTextJustification 清除和 nBreakExtra 設為 0。