Édition enrichie

Article
06/13/2023

Cette section contient des informations sur les éléments de programmation utilisés avec les contrôles d’édition enrichis. Un contrôle d’édition enrichi permet à l’utilisateur d’entrer, de modifier, d’imprimer et d’enregistrer du texte. Le texte peut recevoir une mise en forme de caractère et de paragraphe, et peut inclure des objets COM (Component Object Model) incorporés.

Étant donné que les contrôles d’édition enrichis prennent en charge presque tous les messages et codes de notification utilisés avec les contrôles d’édition multiligne, les applications qui utilisent déjà des contrôles de modification peuvent facilement être modifiées pour utiliser des contrôles d’édition enrichis.

Vues d'ensemble

Rubrique	Contenu
À propos des contrôles d’édition enrichie	Cette section présente les contrôles d’édition enrichis.
Utilisation de contrôles d’édition enrichie	Cette section contient des rubriques qui montrent comment créer et utiliser des contrôles d’édition enrichis.

Fonctions

Rubrique	Contenu
AutoCorrectProc	La fonction AutoCorrectProc est une fonction de rappel définie par l’application utilisée avec le message EM_SETAUTOCORRECTPROC .
EditStreamCallback	La fonction EditStreamCallback est une fonction de rappel définie par l’application utilisée avec les messages EM_STREAMIN et EM_STREAMOUT . Il est utilisé pour transférer un flux de données vers ou hors d’un contrôle d’édition enrichi.
EditWordBreakProcEx	La fonction EditWordBreakProcEx est une fonction de rappel définie par l’application utilisée avec le message EM_SETWORDBREAKPROCEX . Il détermine l’index de caractères du saut de mot ou de la classe de caractères et les indicateurs de saut de mot des caractères dans le texte spécifié.
Trait d’unionProc	La fonction HyphenateProc est une fonction de rappel définie par l’application utilisée avec le message EM_SETHYPHENATEINFO . Il détermine comment la coupure d’union est effectuée dans un contrôle Microsoft Rich Edit.

Interfaces

Rubrique	Contenu
IRichEditOle	L’interface IRichEditOle expose la fonctionnalité COM d’un contrôle d’édition enrichi. L’interface peut être obtenue en envoyant le message EM_GETOLEINTERFACE .
IRichEditOleCallback	L’interface IRichEditOleCallback est utilisée par un contrôle d’édition de texte enrichi pour récupérer des informations relatives à OLE à partir de son client. Un client de contrôle d’édition enrichi est chargé d’implémenter cette interface et de l’affecter au contrôle à l’aide du message EM_SETOLECALLBACK .

Messages

Rubrique	Contenu
EM_AUTOURLDETECT	Active ou désactive la détection automatique des URL par un contrôle d’édition enrichi.
EM_CANPASTE	Détermine si un contrôle d’édition enrichi peut coller un format de Presse-papiers spécifié.
EM_CANREDO	Détermine s’il existe des actions dans la file d’attente de restauration par progression de contrôle.
EM_DISPLAYBAND	Affiche une partie du contenu d’un contrôle d’édition enrichi, comme précédemment mis en forme pour un appareil à l’aide du message EM_FORMATRANGE .
EM_EXGETSEL	Récupère les positions des caractères de début et de fin de la sélection dans un contrôle d’édition enrichi.
EM_EXLIMITTEXT	Définit une limite supérieure à la quantité de texte que l’utilisateur peut taper ou coller dans un contrôle d’édition enrichi.
EM_EXLINEFROMCHAR	Détermine la ligne qui contient le caractère spécifié dans un contrôle d’édition enrichi.
EM_EXSETSEL	Sélectionne une plage de caractères ou d’objets COM dans un contrôle Rich Edit.
EM_FINDTEXT	Recherche du texte dans un contrôle d’édition enrichi.
EM_FINDTEXTEX	Recherche du texte dans un contrôle d’édition enrichi.
EM_FINDTEXTEXW	Recherche du texte Unicode dans un contrôle d’édition enrichi.
EM_FINDTEXTW	Recherche du texte Unicode dans un contrôle d’édition enrichi.
EM_FINDWORDBREAK	Recherche le saut de mot suivant avant ou après la position de caractère spécifiée ou récupère des informations sur le caractère à cette position.
EM_FORMATRANGE	Met en forme une plage de texte dans un contrôle d’édition enrichi pour un appareil spécifique.
EM_GETAUTOURLDETECT	Indique si la détection automatique d’URL est activée dans le contrôle d’édition enrichi.
EM_GETBIDIOPTIONS	Indique l’état actuel des options bidirectionnelles dans le contrôle d’édition enrichi.
EM_GETCHARFORMAT	Détermine la mise en forme des caractères dans un contrôle d’édition enrichi.
EM_GETCTFMODEBIAS	Obtient les valeurs de biais du mode TSF (Text Services Framework) pour un contrôle Rich Edit.
EM_GETCTFOPENSTATUS	Détermine si le clavier TSF est ouvert ou fermé.
EM_GETEDITSTYLE	Récupère les indicateurs de style de modification actuels.
EM_GETEVENTMASK	Récupère le masque d’événement pour un contrôle d’édition enrichi. Le masque d’événement spécifie les codes de notification que le contrôle envoie à sa fenêtre parente.
EM_GETHYPHENATEINFO	Obtient des informations sur la coupure d’union pour un contrôle Rich Edit.
EM_GETIMECOLOR	Récupère la couleur de composition de l’éditeur de méthode d’entrée (IME). Ce message est disponible uniquement dans les versions en langue asiatique du système d’exploitation.
EM_GETIMECOMPMODE	Obtient le mode IME actuel pour un contrôle d’édition enrichi.
EM_GETIMECOMPTEXT	Obtient le texte de composition IME.
EM_GETIMEMODEBIAS	Obtient le biais du mode IME pour un contrôle Rich Edit.
EM_GETIMEOPTIONS	Récupère les options IME actuelles. Ce message est disponible uniquement dans les versions en langue asiatique du système d’exploitation.
EM_GETIMEPROPERTY	Obtient la propriété et les fonctionnalités de l’IME associé aux paramètres régionaux d’entrée actuels.
EM_GETLANGOPTIONS	Obtient les paramètres d’option d’un contrôle d’édition enrichi pour la prise en charge de l’IME et de la langue asiatique.
EM_GETOLEINTERFACE	Récupère un objet IRichEditOle qu’un client peut utiliser pour accéder à la fonctionnalité COM d’un contrôle d’édition enrichi.
EM_GETOPTIONS	Récupère les options de contrôle d’édition enrichies.
EM_GETPAGEROTATE	Action déconseillée. Obtient la disposition du texte d’un contrôle Rich Edit.
EM_GETPARAFORMAT	Récupère la mise en forme de paragraphe de la sélection actuelle dans un contrôle d’édition enrichi.
EM_GETPUNCTUATION	Obtient les caractères de ponctuation actuels pour le contrôle d’édition enrichi. Ce message est disponible uniquement dans les versions en langue asiatique du système d’exploitation.
EM_GETREDONAME	Récupère le type de l’action suivante, le cas échéant, dans la file d’attente de restauration par progression du contrôle d’édition enrichi.
EM_GETSCROLLPOS	Obtient la position de défilement actuelle du contrôle d’édition.
EM_GETSELTEXT	Récupère le texte actuellement sélectionné dans un contrôle d’édition enrichi.
EM_GETTEXTEX	Obtient tout le texte du contrôle d’édition enrichi dans la base de code de votre choix.
EM_GETTEXTLENGTHEX	Calcule la longueur du texte de différentes façons. Il est généralement appelé avant de créer une mémoire tampon pour recevoir le texte du contrôle.
EM_GETTEXTMODE	Obtient le mode texte actuel et le niveau d’annulation d’un contrôle d’édition enrichi.
EM_GETTEXTRANGE	Récupère une plage spécifiée de caractères à partir d’un contrôle d’édition enrichi.
EM_GETTYPOGRAPHYOPTIONS	Récupère l’état actuel des options de typographie d’un contrôle d’édition enrichi.
EM_GETUNDONAME	Microsoft Rich Edit 2.0 et versions ultérieures : récupère le type de l’action d’annulation suivante, le cas échéant. Microsoft Rich Edit 1.0 : ce message n’est pas pris en charge.
EM_GETWORDBREAKPROCEX	Récupère l’adresse de la procédure de saut lexicale étendue actuellement inscrite.
EM_GETWORDWRAPMODE	Obtient les options d’habillage et de saut de mot actuels pour le contrôle d’édition enrichi. Ce message est disponible uniquement dans les versions en langue asiatique du système d’exploitation.
EM_GETZOOM	Obtient le rapport de zoom actuel, qui est toujours compris entre 1/64 et 64.
EM_HIDESELECTION	Masque ou affiche la sélection dans un contrôle d’édition enrichi.
EM_ISIME	Détermine si les paramètres régionaux d’entrée actuels sont des paramètres régionaux d’Asie de l’Est.
EM_PASTESPECIAL	Colle un format de Presse-papiers spécifique dans un contrôle d’édition enrichi.
EM_RECONVERSION	Appelle la boîte de dialogue de conversion IME.
EM_REDO	Rétablit l’action suivante dans la file d’attente de restauration par progression du contrôle.
EM_REQUESTRESIZE	Force un contrôle d’édition enrichi à envoyer un code de notification EN_REQUESTRESIZE à sa fenêtre parente.
EM_SELECTIONTYPE	Détermine le type de sélection d’un contrôle d’édition enrichi.
EM_SETBIDIOPTIONS	Définit l’état actuel des options bidirectionnelles dans le contrôle d’édition enrichi.
EM_SETBKGNDCOLOR	Définit la couleur d’arrière-plan d’un contrôle d’édition enrichi.
EM_SETCHARFORMAT	Définit la mise en forme des caractères dans un contrôle d’édition enrichi.
EM_SETCTFMODEBIAS	Définissez le biais du mode TSF pour un contrôle Rich Edit.
EM_SETCTFOPENSTATUS	Ouvre ou ferme le clavier TSF.
EM_SETEDITSTYLE	Définit les indicateurs de style de modification actuels.
EM_SETEVENTMASK	Définit le masque d’événement pour un contrôle d’édition enrichi. Le masque d’événement spécifie les codes de notification que le contrôle envoie à sa fenêtre parente.
EM_SETFONTSIZE	Définit la taille de police du texte sélectionné.
EM_SETHYPHENATEINFO	Définit la façon dont un contrôle Rich Edit effectue la coupure d’union.
EM_SETIMECOLOR	Définit la couleur de composition IME. Ce message est disponible uniquement dans les versions en langue asiatique du système d’exploitation.
EM_SETIMEMODEBIAS	Définit le biais du mode IME pour un contrôle Rich Edit.
EM_SETIMEOPTIONS	Définit les options IME. Ce message est disponible uniquement dans les versions en langue asiatique du système d’exploitation.
EM_SETLANGOPTIONS	Définit les options de prise en charge de l’IME et de la langue asiatique dans un contrôle d’édition enrichi.
EM_SETOLECALLBACK	Donne à un contrôle d’édition enrichi un objet IRichEditOleCallback que le contrôle utilise pour obtenir des ressources et des informations liées à OLE à partir du client.
EM_SETOPTIONS	Définit les options d’un contrôle d’édition enrichi.
EM_SETPAGEROTATE	Action déconseillée. Définit la disposition du texte d’un contrôle Rich Edit.
EM_SETPALETTE	Modifie la palette utilisée par l’édition enrichie pour sa fenêtre d’affichage.
EM_SETPARAFORMAT	Définit la mise en forme du paragraphe pour la sélection actuelle dans un contrôle d’édition enrichi.
EM_SETPUNCTUATION	Définit les caractères de ponctuation d’un contrôle d’édition enrichi. Ce message est disponible uniquement dans les versions en langue asiatique du système d’exploitation.
EM_SETSCROLLPOS	Indique au contrôle d’édition enrichi de faire défiler jusqu’à un point particulier.
EM_SETTARGETDEVICE	Définit l’appareil cible et la largeur de ligne utilisés pour la mise en forme « ce que vous voyez est ce que vous obtenez » (WYSIWYG) dans un contrôle d’édition enrichi.
EM_SETTEXTEX	Combine les fonctionnalités de WM_SETTEXT et de EM_REPLACESEL, et ajoute la possibilité de définir du texte à l’aide d’une page de codes et d’utiliser du texte enrichi ou du texte brut.
EM_SETTEXTMODE	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.
EM_SETTYPOGRAPHYOPTIONS	Définit l’état actuel des options de typographie d’un contrôle d’édition enrichi.
EM_SETUNDOLIMIT	Définit le nombre maximal d’actions pouvant être stockées dans la file d’attente d’annulation.
EM_SETWORDBREAKPROCEX	Définit la procédure de saut lent étendu.
EM_SETWORDWRAPMODE	Définit les options d’habillage des mots et de saut de mots pour le contrôle d’édition enrichi. Ce message est disponible uniquement dans les versions en langue asiatique du système d’exploitation.
EM_SETZOOM	Définit le rapport de zoom compris entre 1/64 et 64.
EM_SHOWSCROLLBAR	Affiche ou masque l’une des barres de défilement dans la fenêtre Hôte de texte.
EM_STOPGROUPTYPING	Empêche le contrôle de collecter des actions de frappe supplémentaires dans l’action d’annulation actuelle. Le contrôle stocke l’action de saisie suivante, le cas échéant, dans une nouvelle action dans la file d’attente d’annulation.
EM_STREAMIN	Remplace le contenu d’un contrôle d’édition enrichi par un flux de données fourni par une fonction de rappel EditStreamCallback définie par l’application.
EM_STREAMOUT	Provoque la transmission d’un contrôle d’édition enrichi à une fonction de rappel EditStreamCallback définie par l’application. La fonction de rappel peut ensuite écrire le flux de données dans un fichier ou tout autre emplacement de son choix.

Notifications

Rubrique	Contenu
EN_ALIGNLTR	Avertit la fenêtre parente d’un contrôle d’édition enrichi que la direction du paragraphe a changé de gauche à droite. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_COMMAND .
EN_ALIGNRTL	Avertit la fenêtre parente d’un contrôle d’édition enrichi que la direction du paragraphe a changé de droite à gauche. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_COMMAND .
EN_CORRECTTEXT	Avertit la fenêtre parente d’un contrôle d’édition enrichi qu’un SYV_CORRECT mouvement s’est produit, ce qui permet à la fenêtre parente d’annuler la correction du texte. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_DRAGDROPDONE	Avertit la fenêtre parente d’un contrôle d’édition enrichi que l’opération de glisser-déplacer est terminée. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_DROPFILES	Avertit la fenêtre parente d’un contrôle d’édition enrichi que l’utilisateur tente de supprimer des fichiers dans le contrôle. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY lorsqu’il reçoit le message WM_DROPFILES .
EN_IMECHANGE	Avertit le parent d’un contrôle d’édition enrichi que le status de conversion IME a changé. Ce message est disponible uniquement pour les versions en langue asiatique du système d’exploitation. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_COMMAND .
EN_LINK	Avertit la fenêtre parente d’un contrôle d’édition enrichi lorsque l’utilisateur clique sur la souris ou lorsque le pointeur de la souris se trouve sur du texte qui a l’effet CFE_LINK. La fenêtre parente du contrôle reçoit ce code de notification par le biais d’un message WM_NOTIFY .
EN_LOWFIRTF	Avertit la fenêtre parente d’un contrôle d’édition enrichie qu’un mot clé RTF (Rich Text Format) non pris en charge a été reçu. Un contrôle Rich Edit envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_MSGFILTER	Avertit la fenêtre parente d’un contrôle d’édition enrichi d’un événement de clavier ou de souris dans le contrôle. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_OBJECTPOSITIONS	Avertit la fenêtre parente d’un contrôle d’édition enrichie lorsque le contrôle lit des objets. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_OLEOPFAILED	Avertit la fenêtre parente d’un contrôle d’édition enrichi qu’une action utilisateur sur un objet COM a échoué. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_PROTECTED	Avertit la fenêtre parente d’un contrôle d’édition enrichi que l’utilisateur effectue une action qui modifierait une plage de texte protégée. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_REQUESTRESIZE	Avertit la fenêtre parente d’un contrôle d’édition enrichi que le contenu du contrôle est plus petit ou plus grand que la taille de la fenêtre du contrôle. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_SAVECLIPBOARD	Avertit la fenêtre parente du contrôle d’édition enrichie que le contrôle se ferme et que le Presse-papiers contient des informations. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_SELCHANGE	Avertit la fenêtre parente d’un contrôle d’édition enrichi que la sélection actuelle a changé. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .
EN_STOPNOUNDO	Avertit la fenêtre parente d’un contrôle d’édition enrichi qu’une action s’est produite pour laquelle le contrôle ne peut pas allouer suffisamment de mémoire pour conserver l’état d’annulation. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY .

Structures

Rubrique	Contenu
BIDIOPTIONS	Contient des informations bidirectionnelles sur un contrôle d’édition enrichi. Cette structure est utilisée par les messages EM_GETBIDIOPTIONS et EM_SETBIDIOPTIONS pour obtenir et définir les informations bidirectionnelles d’un contrôle.
CHARFORMAT	Contient des informations sur la mise en forme des caractères dans un contrôle d’édition enrichi.
CHARFORMAT2	Contient des informations sur la mise en forme des caractères dans un contrôle d’édition enrichi. CHARFORMAT2 est une extension Microsoft Rich Edit 2.0 de la structure CHARFORMAT . Microsoft Rich Edit 2.0 vous permet d’utiliser l’une ou l’autre structure avec les messages EM_GETCHARFORMAT et EM_SETCHARFORMAT .
CHARRANGE	Spécifie une plage de caractères dans un contrôle d’édition enrichi.
COMPCOLOR	Contient les paramètres de couleur d’une chaîne de composition.
EDITSTREAM	Contient les informations qu’une application transmet à un contrôle d’édition enrichi dans un message EM_STREAMIN ou EM_STREAMOUT . Le contrôle d’édition enrichi utilise les informations pour transférer un flux de données vers ou hors du contrôle.
ENCORRECTTEXT	Contient des informations sur le texte sélectionné à corriger.
ENDROPFILES	Contient des informations associées à un code de notification EN_DROPFILES . Un contrôle d’édition enrichi envoie ce code de notification lorsqu’il reçoit un message WM_DROPFILES .
ENLINK	Contient des informations sur un code de notification EN_LINK à partir d’un contrôle d’édition enrichi.
ENLOWFIRTF	Contient des informations sur un mot clé RTF non pris en charge dans un contrôle Rich Edit.
ENOLEOPFAILED	Contient des informations sur une opération ayant échoué.
ENPROTECTED	Contient des informations associées à un code de notification EN_PROTECTED . Un contrôle d’édition enrichi envoie cette notification lorsque l’utilisateur tente de modifier du texte protégé.
ENSAVECLIPBOARD	Contient des informations sur les objets et le texte dans le Presse-papiers.
FINDTEXT	Contient des informations sur une opération de recherche dans un contrôle d’édition enrichi. Cette structure est utilisée avec le message EM_FINDTEXT .
FINDTEXTEX	Contient des informations sur le texte à rechercher dans un contrôle d’édition enrichi. Cette structure est utilisée avec le message EM_FINDTEXTEX .
FORMATRANGE	Contient les informations qu’un contrôle d’édition enrichi utilise pour mettre en forme sa sortie pour un appareil particulier. Cette structure est utilisée avec le message EM_FORMATRANGE .
GETTEXTEX	Contient des informations sur une opération permettant d’obtenir du texte à partir d’un contrôle d’édition enrichi. Cette structure est passée dans le wParam dans le message EM_GETTEXTEX .
GETTEXTLENGTHEX	Contient des informations sur la façon dont la longueur de texte d’un contrôle d’édition enrichi doit être calculée. Cette structure est passée dans le wParam dans le message EM_GETTEXTLENGTHEX .
TRAIT D’UNIONINFO	Contient des informations sur la coupure d’union dans un contrôle Rich Edit.
HYPHRESULT	Contient des informations sur le résultat de la coupure d’union dans un contrôle Rich Edit.
IMECOMPTEXT	Contient des informations sur le texte de composition dans un contrôle Rich Edit.
MSGFILTER	Contient des informations sur un événement de clavier ou de souris. Un contrôle d’édition enrichi envoie cette structure à sa fenêtre parente dans le cadre d’un code de notification EN_MSGFILTER , ce qui permet au parent de modifier le message ou d’empêcher son traitement.
OBJECTPOSITIONS	Contient des informations sur la position de l’objet.
PARAFORMAT	Contient des informations sur les attributs de mise en forme de paragraphe dans un contrôle d’édition enrichi. Cette structure est utilisée avec les messages EM_GETPARAFORMAT et EM_SETPARAFORMAT .
PARAFORMAT2	Contient des informations sur les attributs de mise en forme de paragraphe dans un contrôle d’édition enrichi.
PONCTUATION	Contient des informations sur la ponctuation utilisée dans un contrôle d’édition enrichi.
REOBJECT	Contient des informations sur un objet .
REPASTESPECIAL	Contient des informations indiquant si l’aspect d’affichage d’un objet collé doit être basé sur le contenu de l’objet ou sur l’icône qui représente l’objet.
REQRESIZE	Contient la taille demandée d’un contrôle d’édition enrichi. Un contrôle d’édition enrichi envoie cette structure à sa fenêtre parente dans le cadre d’un code de notification EN_REQUESTRESIZE .
SELCHANGE	Contient des informations associées à un code de notification EN_SELCHANGE . Un contrôle d’édition enrichi envoie cette notification à sa fenêtre parente lorsque la sélection actuelle change.
SETTEXTEX	Spécifie la page de codes (le cas échéant) à utiliser pour définir le texte, si le texte remplace tout le texte du contrôle ou seulement la sélection, et si l’état d’annulation doit être conservé.
TEXTRANGE	Reçoit une plage de texte à partir d’un contrôle d’édition enrichi. Cette structure est remplie par le message EM_GETTEXTRANGE . La mémoire tampon pointée par le membre lpstrText doit être suffisamment grande pour recevoir tous les caractères et le caractère null de fin.

Constantes

Rubrique	Contenu
Indicateurs de masque d’événement de contrôle d’édition enrichi	Le masque d’événement spécifie les codes de notification qu’un contrôle d’édition enrichi envoie à sa fenêtre parente.
Styles de contrôle d’édition enrichis	Décrit les styles de fenêtre propres aux contrôles d’édition enrichis.