Méthode ITextHost::TxGetMaxLength (textserv.h)

Article
08/26/2023

Obtient la longueur maximale autorisée de l’hôte de texte pour le texte.

Syntaxe

HRESULT TxGetMaxLength(
  DWORD *plength
);

Paramètres

plength

Type : DWORD*

Longueur de texte maximale autorisée, en nombre de caractères. Si INFINITE est retourné, l’objet de services de texte peut utiliser autant de mémoire que nécessaire pour stocker tout texte spécifié.

Valeur retournée

Type : HRESULT

La valeur de retour est S_OK.

Remarques

Lorsque ce maximum est atteint, l’objet de services de texte doit rejeter toute autre insertion de caractères et texte collé. Toutefois, TxSetText doit toujours accepter (et définir) le texte plus long que la longueur maximale. En effet, cette méthode est utilisée pour la liaison et est essentielle pour maintenir l’intégrité des données auxquelles le contrôle est lié.

Cette méthode est parallèle au message EM_LIMITTEXT .

Si la limite retournée est inférieure au nombre de caractères actuellement dans l’objet services de texte, aucune donnée n’est perdue. Au lieu de cela, aucune modification n’est autorisée dans le texte autre que la suppression tant que le texte n’est pas réduit en dessous de la limite.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	textserv.h
DLL	Msftedit.dll