message EM_SETTEXTMODE

Définit le mode texte ou annuler le niveau d’un contrôle d’édition enrichi. Le message échoue si le contrôle contient du texte.

Paramètres

wParam

Une ou plusieurs valeurs du type d’énumération TEXTMODE . Les valeurs spécifient les nouveaux paramètres du mode texte du contrôle et annulent les paramètres de niveau.

Spécifiez l’une des valeurs suivantes pour définir le paramètre en mode texte. Si vous ne spécifiez pas de valeur de mode texte, le mode texte reste à son paramètre actuel.

Valeur	Sens
TM_PLAINTEXT	Indique le mode texte brut, dans lequel le contrôle est similaire à un contrôle d’édition standard. Pour plus d’informations sur le mode texte brut, consultez la section Remarques suivante.
TM_RICHTEXT	Indique le mode texte enrichi, dans lequel le contrôle dispose de fonctionnalités d’édition enrichie standard. Le mode texte enrichi est le paramètre par défaut.

Spécifiez l’une des valeurs suivantes pour définir le paramètre d’annulation de niveau. Si vous ne spécifiez pas de valeur de niveau d’annulation, le niveau d’annulation reste à son paramètre actuel.

Valeur	Sens
TM_SINGLELEVELUNDO	Le contrôle permet à l’utilisateur d’annuler uniquement la dernière action qui peut être annulée.
TM_MULTILEVELUNDO	Le contrôle prend en charge plusieurs opérations d’annulation. Il s’agit du paramètre par défaut. Utilisez le message EM_SETUNDOLIMIT pour définir le nombre maximal d’actions d’annulation.

Spécifiez l’une des valeurs suivantes pour définir le paramètre de page de codes. Si vous ne spécifiez pas de valeur de page de codes, la page de codes reste à son paramètre actuel.

Valeur	Sens
TM_SINGLECODEPAGE	Le contrôle autorise uniquement le clavier anglais et un clavier correspondant au jeu de caractères par défaut. Par exemple, vous pourriez avoir le grec et l’anglais. Notez que cela empêche le texte Unicode d’entrer le contrôle. Par exemple, utilisez cette valeur si un contrôle Rich Edit doit être limité au texte ANSI.
TM_MULTICODEPAGE	Le contrôle autorise plusieurs pages de codes et du texte Unicode dans le contrôle. Il s’agit du paramètre par défaut.

lParam

Ce paramètre n’est pas utilisé ; il doit être égal à zéro.

Valeur retournée

Si le message réussit, la valeur de retour est égale à zéro.

Si le message échoue, la valeur de retour est une valeur différente de zéro.

Remarques

En mode texte enrichi, un contrôle d’édition enrichi dispose de fonctionnalités d’édition enrichie standard. Toutefois, en mode texte brut, le contrôle est similaire à un contrôle d’édition standard :

• Le texte d’un contrôle de texte brut ne peut avoir qu’un seul format (par exemple Gras, 10pt Arial).
• L’utilisateur ne peut pas coller des formats de texte enrichi, tels que RTF (Rich Text Format) ou des objets incorporés dans un contrôle de texte brut.
• Les contrôles en mode texte enrichi ont toujours un retour chariot ou un marqueur de fin de document par défaut pour mettre en forme des paragraphes. Les contrôles de texte brut, d’autre part, n’ont pas besoin du marqueur de fin de document par défaut. Il est donc omis.

Le contrôle ne doit contenir aucun texte lorsqu’il reçoit le message EM_SETTEXTMODE . Pour vous assurer qu’il n’y a pas de texte, envoyez un message WM_SETTEXT avec une chaîne vide ( » « ).

Spécifications

Besoin	Valeur
Client minimum pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête de page	Richedit.h

Voir aussi

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODE

WM_SETTEXT