É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. |