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
Referenz