EM_SETTEXTMODE message

Définit le mode texte ou le niveau d’annulation 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 et des paramètres de niveau d’annulation du contrôle.

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

Valeur Signification
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 d’une fonctionnalité 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 de niveau d’annulation. Si vous ne spécifiez pas de valeur de niveau d’annulation, le niveau d’annulation reste à son paramètre actuel.

Valeur Signification
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 Signification
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 pouvez avoir le grec et l’anglais. Notez que cela empêche le texte Unicode d’entrer dans 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 zéro.

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

Notes

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, 10 pts 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 marqueur de fin de document ou un retour chariot par défaut, pour mettre en forme les paragraphes. Les contrôles de texte brut, en revanche, 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

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

Voir aussi

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODE

WM_SETTEXT