EM _ SETLIMITTEXT-Nachricht
Legt die Textgrenze eines Bearbeitungssteuerfelds fest. Die Textgrenze ist die maximale Textmenge in TCHAR s, die der Benutzer in das Bearbeitungssteuerfeld eingeben kann. Sie können diese Nachricht entweder an ein Bearbeitungssteuer steuerelement oder an ein Rich Edit-Steuerelement senden.
Für Bearbeitungssteuerelemente und Microsoft Rich Edit 1.0 werden Bytes verwendet. Für Microsoft Rich Edit 2.0 und höher werden Zeichen verwendet.
Die EM _ SETLIMITTEXT-Nachricht ist mit der EM _ LIMITTEXT-Nachricht identisch.
Parameter
-
wParam
-
Die maximale Anzahl von TCHAR-S, die der Benutzer eingeben kann. Für ANSI-Text ist dies die Anzahl von Bytes. für Unicode-Text ist dies die Anzahl von Zeichen. Diese Zahl schließt das beendende NULL-Zeichen nicht ein.
Umfangreiche Bearbeitungssteuerelemente: Wenn dieser Parameter null ist, wird die Textlänge auf 64.000 Zeichen festgelegt.
Wenn dieser Parameter 0 (null) ist, wird die Textlänge auf 0x7FFFFFFE Zeichen für einzeilenbasierte Bearbeitungssteuerelemente oder 1 für mehrzeilenbasierte Bearbeitungssteuerelemente festgelegt.
-
lParam
-
Dieser Parameter wird nicht verwendet.
Rückgabewert
Diese Meldung gibt keinen Wert zurück.
Hinweise
Die EM _ SETLIMITTEXT-Meldung schränkt nur den Text ein, den der Benutzer eingeben kann. Sie wirkt sich weder auf Text aus, der bereits im Bearbeitungssteuerfeld enthalten ist, wenn die Nachricht gesendet wird, noch auf die Länge des Texts, der von der WM _ SETTEXT-Nachricht in das Bearbeitungssteuerfeld kopiert wird. Wenn eine Anwendung die WM _ SETTEXT-Nachricht verwendet, um mehr Text in ein Bearbeitungssteuerfeld zu platzieren, als in der EM _ SETLIMITTEXT-Nachricht angegeben ist, kann der Benutzer den gesamten Inhalt des Bearbeitungssteuerfelds bearbeiten.
Bevor EM _ SETLIMITTEXT aufgerufen wird, beträgt der Standardgrenzwert für die Textmenge, die ein Benutzer in ein Bearbeitungssteuerfeld eingeben kann, 32.767 Zeichen.
Bei einzeilenbasierten Bearbeitungssteuerelementen beträgt der Textgrenzwert 0x7FFFFFFE Bytes oder den Wert des wParam-Parameters, je nach Wert kleiner. Bei mehrstufigen Bearbeitungssteuerelementen ist dieser Wert entweder 1 Byte oder der Wert des wParam-Parameters, je nach Wert kleiner.
Umfangreiche Bearbeitung: Wird in Microsoft Rich Edit 1.0 und höher unterstützt. Verwenden Sie die Meldung EM _ EXLIMITTEXT für Textlängenwerte, die größer als 64.000 sind. Informationen zur Kompatibilität von Rich Edit-Versionen mit den verschiedenen Systemversionen finden Sie unter Informationen zu Rich Edit-Steuerelementen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|