SetTextJustification函式指定一定數量的空間,讓系統增加到一個正文字元串的間隔字元上,當應用程式調用TextOut或ExtTextOut時,空間就地加進去。
基本介紹
- 外文名:SetTextJustification
- 函式功能:該函式指定一定數量的空間
- 函式原型:BOOL SetTextJustification
- hdc:設備環境句柄
函式原型,參數,返回值,備註,
函式原型
BOOL SetTextJustification(HDC hdc, int nBreakExtra, int nBreakCount);
參數
hdc:設備環境句柄。
nBreakExtra:指定將被加到正文行的總的額外空間(按邏輯單位)。如果當前映射模式不是MM_TEXT,則由nBreakExtra標識的值將被轉換,並捨入到最近的像素上。
nBreakCount:指定一行中間隔字元的個數。
返回值
如果函式調用成功,返回值非零;如果函式調用失敗,返回是0。
Windows NT:若想獲得更多錯誤信息,請調用GetLastError函式。
備註
間隔符通常空格符(ASCII32),但一種字型可以象定義其他字元一樣來定義它。GetTextMetrics可用來得到一種字型的間隔符。 TextOut將指定的額外空間分散到一行中,甚至在間隔符中間。 GetTextExtenPoint32總是和SetTextJustification一起使用。GetTextextentPoint32在進行調整前計算給定行的寬度。必須先知道這個寬度值才能恰當計算出nBreakExtra。 SetTextJustification可用來調整含有使用不同字型的多個字元串的一行,在這種情況下,每一個字元串必須被單獨調整。 由於在調整時會發生捨入錯誤,系統保留了一個運行錯誤項來定義當前錯誤值,當調整一行包含了多個操作時,GetTextExtentPoint會在計算下一個操作範圍時自動地使用這個錯誤項,並允許TextOut混合該錯誤到新的操作里。當一行被調整後,這個錯誤項必須被清除,以避免被組合到下一行。可將nBreakExtra設為0,調用SetTextJustification來清除這個項。 速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;頭檔案:wingdi.h;庫檔案:gdi32.lib。