TextOut

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

基本介紹

• 中文名：TextOut
• 屬性：函式
• 功能：選擇的字型、背景顏色和正文顏色
• 原型：BOOL TextOut(

使用方法

函式原型

BOOL TextOut(HDC hdc, // 設備描述表句柄int nXStart, // 字元串的開始位置 x坐標int nYStart, // 字元串的開始位置 y坐標LPCTSTR lpString, // 字元串int cbString // 字元串中字元的個數);

參數

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