TextOut

TextOut,函式名。該函式用當前選擇的字型、背景顏色和正文顏色將一個字元串寫到指定位置。

使用方法

函式原型

參數

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兩種版本。

相關詞條

相關搜尋

熱門詞條

聯絡我們