Partager via


Édition enrichie

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.