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