Modification enrichie

Cette section contient des informations sur les éléments de programmation utilisés avec des 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 être affecté à des caractères et à une mise en forme de paragraphe, et peut inclure des objets COM (Component Object Model) incorporés.

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

Aperçus

Sujet	Contenu
à propos des contrôles d’édition enrichi	Cette section présente les contrôles d’édition enrichis.
à l’aide de contrôles d’édition enrichis	Cette section contient des rubriques qui montrent comment créer et utiliser des contrôles d’édition enrichis.

Fonctions

Sujet	Contenu
correction automatiqueProc	La fonction decorrection automatique 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ère du saut de mot ou de la classe de caractères et des indicateurs de saut de mot des caractères dans le texte spécifié.
hyphenateProc	La fonction HyphenateProc est une fonction de rappel définie par l’application utilisée avec le message EM_SETHYPHENATEINFO. Il détermine la façon dont la trait d’union est effectuée dans un contrôle Microsoft Rich Edit.

Interfaces

Sujet	Contenu
IRichEditOle	L’interface IRichEditOle expose les fonctionnalités 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 liées à 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

Sujet	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 rétablissement du 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 d’URL automatique 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 d’édition 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 envoyés par le contrôle à sa fenêtre parente.
EM_GETHYPHENATEINFO	Obtient des informations sur la trait d’union pour un contrôle Rich Edit.
EM_GETIMECOLOR	Récupère la couleur de composition IME (Input Method Editor). Ce message est disponible uniquement dans les versions asiatiques 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 asiatiques du système d’exploitation.
EM_GETIMEPROPERTY	Obtient la propriété et les fonctionnalités de l’IME associée 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 aux fonctionnalités COM d’un contrôle d’édition enrichi.
EM_GETOPTIONS	Récupère les options de contrôle d’édition enrichies.
EM_GETPAGEROTATE	Obsolescent. Obtient la disposition du texte d’un contrôle Rich Edit.
EM_GETPARAFORMAT	Récupère la mise en forme des paragraphes 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 asiatiques 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 rétablissement 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 n’importe quelle base de code spécifique souhaitée.
EM_GETTEXTLENGTHEX	Calcule la longueur du texte de différentes manières. 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 annule le niveau d’un contrôle d’édition enrichi.
EM_GETTEXTRANGE	Récupère une plage de caractères spécifiée à partir d’un contrôle d’édition enrichi.
EM_GETTYPOGRAPHYOPTIONS	Récupère l’état actuel des options typographiques 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 d’arrêt de mot actuellement inscrite.
EM_GETWORDWRAPMODE	Obtient les options d’habillage du mot actuel et de saut de mot pour le contrôle d’édition enrichi. Ce message est disponible uniquement dans les versions asiatiques 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 conversion IME.
EM_REDO	Rétablit l’action suivante dans la file d’attente de rétablissement 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 d’édition 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 envoyés par le contrôle à 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 un trait d’union.
EM_SETIMECOLOR	Définit la couleur de composition IME. Ce message est disponible uniquement dans les versions asiatiques 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 asiatiques du système d’exploitation.
EM_SETLANGOPTIONS	Définit des options pour la 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	Obsolescent. Définit la disposition du texte d’un contrôle Rich Edit.
EM_SETPALETTE	Modifie la palette utilisée par les modifications enrichies pour sa fenêtre d’affichage.
EM_SETPARAFORMAT	Définit la mise en forme de 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 asiatiques 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 annuler le niveau 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 typographiques 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 de mot étendu.
EM_SETWORDWRAPMODE	Définit les options word-wrapping et word-breaking pour le contrôle d’édition enrichi. Ce message est disponible uniquement dans les versions asiatiques du système d’exploitation.
EM_SETZOOM	Définit le rapport de zoom n’importe où 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 saisie 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 application définie EditStreamCallback fonction de rappel.
EM_STREAMOUT	Provoque un contrôle d’édition enrichi pour transmettre son contenu à une application définie EditStreamCallback fonction de rappel. La fonction de rappel peut ensuite écrire le flux de données dans un fichier ou tout autre emplacement choisi.

Notifications

Sujet	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 est passée à 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 mouvement de SYV_CORRECT 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 s’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 l’état de conversion IME a changé. Ce message est disponible uniquement pour les versions asiatiques 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 le texte qui a l’effet CFE_LINK. La fenêtre parente du contrôle reçoit ce code de notification via un message WM_NOTIFY.
EN_LOWFIRTF	Avertit la fenêtre parente d’un contrôle Rich Edit d’un contrôle Rich Edit 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 clavier ou 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 enrichi lorsque le contrôle lit dans les 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 maintenir l’état d’annulation. Un contrôle d’édition enrichi envoie ce code de notification sous la forme d’un message WM_NOTIFY.

Structures

Sujet	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 de caractères dans un contrôle d’édition enrichi.
CHARFORMAT2	Contient des informations sur la mise en forme de 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 des 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 des 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 du 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.
HYPHENATEINFO	Contient des informations sur la trait d’union dans un contrôle Rich Edit.
HYPHRESULT	Contient des informations sur le résultat de la trait 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 clavier ou 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 de l’empêcher d’être traité.
OBJECTPOSITIONS	Contient des informations de position d’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.
de 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 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 simplement 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 renseignée 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

Sujet	Contenu
des indicateurs de masque d’événements rich Edit Control	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 enrichi	Décrit les styles de fenêtre uniques aux contrôles d’édition enrichis.