ITextHost::TxGetMaxLength-Methode (textserv.h)

Ruft die maximal zulässige Länge des Texthosts für den Text ab.

Syntax

HRESULT TxGetMaxLength(
  DWORD *plength
);

Parameter

plength

Typ: DWORD*

Die maximal zulässige Textlänge in Anzahl von Zeichen. Wenn INFINITE zurückgegeben wird, kann das Text services-Objekt so viel Arbeitsspeicher wie erforderlich verwenden, um den angegebenen Text zu speichern.

Rückgabewert

Typ: HRESULT

Der Rückgabewert ist S_OK.

Hinweise

Wenn dieses Maximum erreicht ist, sollte das Text services-Objekt alle weiteren Zeicheneinfügungen und eingefügten Text ablehnen. TxSetText sollte jedoch weiterhin Text akzeptieren (und festlegen), der länger als die maximale Länge ist. Dies liegt daran, dass diese Methode für die Bindung verwendet wird und entscheidend für die Aufrechterhaltung der Integrität der Daten ist, an die das Steuerelement gebunden ist.

Diese Methode parallelisiert die EM_LIMITTEXT Meldung.

Wenn der zurückgegebene Grenzwert kleiner als die Anzahl der Zeichen ist, die derzeit im Text services-Objekt enthalten sind, gehen keine Daten verloren. Stattdessen sind keine Bearbeitungen am Text zulässig , außer dem Löschen, bis der Text auf unter den Grenzwert reduziert wird.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	textserv.h
DLL	Msftedit.dll

Siehe auch

Konzept

EM_LIMITTEXT

ITextHost

Referenz

Fensterlose Rich-Edit-Steuerelemente