Freigeben über


EM_LIMITTEXT Nachricht

Legt den Textgrenzwert eines Bearbeitungssteuerelements fest. Das Textlimit ist die maximale Textmenge in TCHARs, die der Benutzer in das Bearbeitungssteuerelement eingeben kann. Sie können diese Nachricht entweder an ein Bearbeitungssteuerelement oder 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.

Parameter

wParam

Die maximale Anzahl von TCHARs, die der Benutzer eingeben kann. Für ANSI-Text ist dies die Anzahl der Bytes; Für Unicode-Text ist dies die Anzahl der Zeichen. Diese Zahl enthält nicht das beendende NULL-Zeichen.

Rich-Edit-Steuerelemente: Wenn dieser Parameter 0 ist, wird die Textlänge auf 64.000 Zeichen festgelegt.

Wenn dieser Parameter 0 ist, wird die Textlänge auf 0x7FFFFFFE Zeichen für einzeilige Bearbeitungssteuerelemente oder -1 für Mehrzeilige Bearbeitungssteuerelemente festgelegt.

lParam

Dieser Parameter wird nicht verwendet.

Rückgabewert

Diese Nachricht gibt keinen Wert zurück.

Bemerkungen

Die EM_LIMITTEXT Nachricht schränkt nur den Text ein, den der Benutzer eingeben kann. Es wirkt sich nicht auf Text aus, der bereits im Bearbeitungssteuerelement enthalten ist, wenn die Nachricht gesendet wird, noch auf die Länge des Texts, der vom WM_SETTEXT Nachricht in das Bearbeitungssteuerelement kopiert wurde. Wenn eine Anwendung die WM_SETTEXT Nachricht verwendet, um mehr Text in ein Bearbeitungssteuerelement zu platzieren, als in der EM_LIMITTEXT-Nachricht angegeben ist, kann der Benutzer den gesamten Inhalt des Bearbeitungssteuerelements bearbeiten.

Bevor EM_LIMITTEXT aufgerufen wird, beträgt der Standardgrenzwert für die Textmenge, die ein Benutzer in ein Bearbeitungssteuerelement eingeben kann, 32.767 Zeichen.

Bei einzeiligen Bearbeitungssteuerelementen ist der Textgrenzwert entweder 0x7FFFFFFE Bytes oder der Wert des wParam-Parameters , je nachdem, welcher Wert kleiner ist. Bei Steuerelementen mit mehreren Zeilen ist dieser Wert entweder -1 Byte oder der Wert des wParam-Parameters , je nachdem, welcher Wert kleiner ist.

Rich-Bearbeitung: Unterstützt in Microsoft Rich Edit 1.0 und höher. Verwenden Sie die Nachricht EM_EXLIMITTEXT für Textlängenwerte größer als 64.000. 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Header
Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

EM_EXLIMITTEXT

Edit_LimitText

Andere Ressourcen

WM_SETTEXT