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函數。

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