EM_SETLIMITTEXT訊息

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

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

EM_SETLIMITTEXT訊息與EM_LIMITTEXT訊息相同。

參數

wParam

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

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

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

lParam

不使用這個參數。

傳回值

此訊息不會傳回值。

備註

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

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

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

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

規格需求

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

另請參閱

EM_GETLIMITTEXT