EM_LIMITTEXT訊息

設定編輯控制項的文字限制。 文字限制是 TCHAR中使用者可以輸入編輯控制項的最大文字數量。 您可以將此訊息傳送至編輯控制項或豐富的編輯控制項。

對於編輯控制項和 Microsoft Rich Edit 1.0，會使用位元組。 針對 Microsoft Rich Edit 2.0 和更新版本，會使用字元。

參數

wParam

使用者可以輸入的 TCHAR數目上限。 針對 ANSI 文字，這是位元組數目;針對 Unicode 文字，這是字元數。 這個數位不包含終止 Null 字元。

豐富的編輯控制項： 如果此參數為零，文字長度會設定為 64，000 個字元。

如果此參數為零，則文字長度會設定為單行編輯控制項的0x7FFFFFFE字元，或多行編輯控制項的 -1。

lParam

不使用這個參數。

傳回值

此訊息不會傳回值。

備註

EM_LIMITTEXT訊息只會限制使用者可以輸入的文字。 傳送訊息時，它不會影響已在編輯控制項中的任何文字，也不會影響 WM_SETTEXT 訊息複製到編輯控制項的文字長度。 如果應用程式使用 WM_SETTEXT 訊息，將比 EM_LIMITTEXT 訊息中指定的更多文字放在編輯控制項中，則使用者可以編輯編輯控制項的整個內容。

呼叫EM_LIMITTEXT之前，使用者可以在編輯控制項中輸入的文字數量預設限制為 32，767 個字元。

對於單行編輯控制項，文字限制是0x7FFFFFFE位元組或 wParam 參數的值，無論哪一個較小。 對於多行編輯控制項，此值為 -1 位元組或 wParam 參數的值，無論哪一個較小。

豐富編輯： Microsoft Rich Edit 1.0 和更新版本支援。 針對大於 64，000 的文字長度值，請使用訊息 EM_EXLIMITTEXT 。 如需豐富編輯版本與各種系統版本相容性的相關資訊，請參閱 關於 Rich Edit Controls。

規格需求

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

另請參閱

參考

EM_EXLIMITTEXT

Edit_LimitText

其他資源

WM_SETTEXT