使用方法
函式原型
參數
hdc
[輸入] 設備環境的句柄
nXStart
[輸入] 指定用於字元串對齊的基準點的邏輯X坐標。
nYStart
[輸入] 指定用於字元串對齊的基準點的邏輯Y坐標。
lpString
[輸入] 指向將被繪製字元串的指針。此字元串不必為以\0結束的,因為cbString中指定了字元串的長度。
cbString
[輸入] 指定了字元串的長度。
返回值
如果函式調用成功,返回值為非零值。
如果函式調用失敗,返回值為0。
Windows NT:若想獲得更多錯誤信息,請調用GetLastError函式。
VB 6.0
Declare Function TextOutA Lib "gdi32" (ByVal hdc As Long, ByVal nXStart As Long, ByVal nYStart As Long, ByVal lpString As String, ByVal cchString As Long) As Long
備註
對基準點的解釋依賴於當前字元對齊模式,一個應用程式可以調用GetTextAlign來獲得該模式,調用SetTextAlign來更改該模式。
預設地,此函式不能使用和修改當前位置,但一個應用程式可以在每次在指定設備環境中調用TextOut之前,通過將參數fMode設為TA_UPDATECP值來調用SetTextAlign,以允許系統在調用TextOut時修改當前位置,當上述標誌設定時,系統會忽略隨後調用TextOut中的nXStart和nYStart值。
當把函式TextOut放入一個路徑括弧內時,系統為包含每一個字元並加上字元值的TrueType正文產生一個路徑,產生的區域是字元框加上正文,而不是正文本身,可以在把TextOut放入路徑括弧之前設定背景模式為透明的,這樣就能得到由TrueType正文的輪廓封閉而成的區域。下面是說明這個過程的例程代碼:
GetClientRect(hwnd, &r);
BeginPath(hdc);
TextOut(hdc, r.left, r.top, "Defenestration can be hazardous", 4);
EndPath(hdc);
SelectClipPath(hdc, RGN_AND);
FillRect(hdc, &r, GetStockObject(GRAY_BRUSH))。
速查
Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;
頭檔案:wingdi.h;
庫檔案:gdi32.lib;
Unicode:在Windows NT環境下實現為Unicode和ANSI兩種版本。