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 [僅限桌面應用程式] |
標頭 |
|