WM_GETTEXTLENGTH訊息

決定與視窗相關聯的文字長度，以字元為單位。

#define WM_GETTEXTLENGTH                0x000E

參數

wParam

不使用此參數，而且必須是零。

lParam

不使用此參數，而且必須是零。

傳回值

類型： LRESULT

傳回值是字元中的文字長度，不包括終止的 Null 字元。

備註

對於編輯控制項，要複製的文字是編輯控制項的內容。 對於下拉式方塊，文字是下拉式方塊 (或靜態文字) 部分的編輯控制項內容。 對於按鈕，文字是按鈕名稱。 對於其他視窗，文字是視窗標題。 若要判斷清單方塊中專案的長度，應用程式可以使用 LB_GETTEXTLEN 訊息。

傳送 WM_GETTEXTLENGTH 訊息時， DefWindowProc 函式會傳回文字的長度，以字元為單位。 在某些情況下， DefWindowProc 函式會傳回大於文字實際長度的值。 這會以 ANSI 和 Unicode 的特定混合發生，這是因為系統允許在文字內 (DBCS) 字元的雙位元組字元集存在。 不過，傳回值一律會至少與文字的實際長度相同;因此，您一律可以使用它來引導緩衝區配置。 當應用程式同時使用 ANSI 函式和使用 Unicode 的常見對話方塊時，就會發生此行為。

若要取得文字的確切長度，請使用 WM_GETTEXT、 LB_GETTEXT或 CB_GETLBTEXT 訊息，或 GetWindowText 函式。

將 WM_GETTEXTLENGTH 訊息傳送至非文字靜態控制項，例如靜態點陣圖或靜態圖示控制項，不會傳回字串值。 相反地，它會傳回零。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Winuser.h (包含 Windows.h)

另請參閱

參考

DefWindowProc

GetWindowText

GetWindowTextLength

WM_GETTEXT

概念

Windows

其他資源

CB_GETLBTEXT

LB_GETTEXT

LB_GETTEXTLEN