structure CHARFORMAT2A (Rich Edit 2.0)
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 .
Syntaxe
typedef struct _charformat2a {
UINT cbSize;
DWORD dwMask;
DWORD dwEffects;
LONG yHeight;
LONG yOffset;
COLORREF crTextColor;
BYTE bCharSet;
BYTE bPitchAndFamily;
char szFaceName[LF_FACESIZE];
WORD wWeight;
SHORT sSpacing;
COLORREF crBackColor;
LCID lcid;
union {
DWORD dwReserved;
DWORD dwCookie;
};
DWORD dwReserved;
SHORT sStyle;
WORD wKerning;
BYTE bUnderlineType;
BYTE bAnimation;
BYTE bRevAuthor;
BYTE bUnderlineColor;
} CHARFORMAT2A;
Membres
cbSize
Type : UINT
Spécifie la taille, en octets, de la structure. Avant de passer cette structure à un contrôle d’édition enrichi, définissez cbSize sur la taille de la structure CHARFORMAT ou CHARFORMAT2 . Si cbSize est égal à la taille d’une structure CHARFORMAT , le contrôle utilise uniquement les membres CHARFORMAT .
dwMask
Type : DWORD
Spécifie les parties de la structure CHARFORMAT2 qui contiennent des informations valides. Le membre dwMask peut être une combinaison des valeurs de deux jeux d’indicateurs de bits. Un jeu indique les membres de la structure qui sont valides. Un autre ensemble indique les attributs valides dans le membre dwEffects .
Définissez les valeurs suivantes pour indiquer les attributs valides du membre dwEffects .
Définissez les valeurs suivantes pour indiquer les membres de structure valides.
dwEffects
Type : DWORD
Ensemble d’indicateurs de bits qui spécifient des effets de caractère. Certains indicateurs sont inclus uniquement pour la compatibilité avec les interfaces TOM ( Text Object Model ) Microsoft ; le contrôle d’édition enrichi stocke la valeur, mais ne l’utilise pas pour afficher du texte.
Ce membre peut être une combinaison des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Les caractères sont tous des lettres majuscules. La valeur n’affecte pas la façon dont le contrôle affiche le texte. Cette valeur s’applique uniquement aux versions antérieures à Microsoft Rich Edit 3.0. |
|
La couleur d’arrière-plan est la valeur de retour de GetSysColor(COLOR_WINDOW). Si cet indicateur est défini, le membre crBackColor est ignoré. |
|
La couleur du texte est la valeur de retour de GetSysColor(COLOR_WINDOWTEXT). Si cet indicateur est défini, le membre crTextColor est ignoré. |
|
Les caractères sont en gras. |
|
Les caractères sont affichés avec une ombre décalée de 3/4 point ou d’un pixel, selon la valeur la plus grande. |
|
Les caractères sont en relief. La valeur n’affecte pas la façon dont le contrôle affiche le texte. |
|
Les caractères sont des membres moins courants d’un script. Une police qui prend en charge un script doit case activée si elle a des glyphes pour ces caractères. |
|
La police est choisie par le contrôle d’édition enrichi, car la police active ne prend pas en charge les caractères. Ce processus est appelé liaison de polices. |
|
Pour Microsoft Rich Edit 3.0 et versions ultérieures, les caractères ne sont pas affichés. |
|
Les caractères sont affichés sous forme de caractères imprimés. La valeur n’affecte pas la façon dont le contrôle affiche le texte. |
|
Les caractères sont italiques. |
|
Un contrôle d’édition enrichi peut envoyer des codes de notification EN_LINK lorsqu’il reçoit des messages de souris alors que le pointeur de la souris se trouve sur du texte avec l’effet CFE_LINK . |
|
Les caractères font partie d’un lien de nom convivial. |
|
Les caractères se trouvent dans une zone mathématique. |
|
Les caractères ne participent pas à une accumulation mathématique. Par exemple, lorsqu’il est appliqué à un /, le / ne sera pas utilisé pour générer une fraction. |
|
Les caractères sont affichés sous forme de texte ordinaire dans une zone mathématique. |
|
Les caractères sont affichés sous forme de caractères hiérarchiques. La valeur n’affecte pas la façon dont le contrôle affiche le texte. |
|
Les caractères sont protégés ; Une tentative de modification entraîne une EN_PROTECTED code de notification. |
|
Les caractères sont marqués comme révisés. |
|
Les caractères sont affichés sous forme de caractères ombrés. La valeur n’affecte pas la façon dont le contrôle affiche le texte. |
|
Les caractères sont en minuscules majuscules. La valeur n’affecte pas la façon dont le contrôle affiche le texte. |
|
Les caractères sont rayés. |
|
Les caractères sont des indices. Les valeurs CFE_SUPERSCRIPT et CFE_SUBSCRIPT s’excluent mutuellement. Pour les deux valeurs, le contrôle calcule automatiquement un décalage et une taille de police plus petite. Vous pouvez également utiliser les membres yHeight et yOffset pour spécifier explicitement la taille de police et le décalage des caractères d’indice et d’exposant. |
|
Les caractères sont en exposant. |
|
Les caractères sont soulignés. |
yHeight
Type : LONG
Spécifie la hauteur des caractères, en twips (1/1440 de pouce ou 1/20 du point d’une imprimante). Pour utiliser ce membre, définissez l’indicateur CFM_SIZE dans le membre dwMask .
yOffset
Type : LONG
Décalage de caractères par rapport à la ligne de base, en twips. Si la valeur de ce membre est positive, le caractère est un exposant ; si la valeur est négative, le caractère est un indice. Pour utiliser ce membre, définissez l’indicateur CFM_OFFSET dans le membre dwMask .
crTextColor
Type : COLORREF
Couleur du texte. Pour utiliser ce membre, définissez l’indicateur CFM_COLOR dans le membre dwMask . Ce membre est ignoré si l’effet de caractère CFE_AUTOCOLOR est spécifié. Pour générer un COLORREF, utilisez la macro RVB .
bCharSet
Type : BYTE
Valeur du jeu de caractères. Il peut s’agir de l’une des valeurs spécifiées pour le membre lfCharSet de la structure LOGFONT . Pour utiliser ce membre, définissez l’indicateur CFM_CHARSET dans le membre dwMask .
bPitchAndFamily
Type : BYTE
Spécifie la famille de polices et le pitch. Ce membre est identique au membre lfPitchAndFamily de la structure LOGFONT .
szFaceName[LF_FACESIZE]
Type : TCHAR[LF_FACESIZE]
Tableau de caractères avec fin null spécifiant le nom de la police. Pour utiliser ce membre, définissez l’indicateur CFM_FACE dans le membre dwMask .
wWeight
Type : WORD
Poids de police. Ce membre est identique au membre lfWeight de la structure LOGFONT . Pour utiliser ce membre, définissez l’indicateur CFM_WEIGHT dans le membre dwMask .
sSpacing
Type : SHORT
Espace horizontal entre les lettres, en twips. Cette valeur n’a aucun effet sur le texte affiché par un contrôle d’édition enrichi ; il est inclus pour la compatibilité avec les interfaces Windows TOM. Pour utiliser ce membre, définissez l’indicateur CFM_SPACING dans le membre dwMask .
crBackColor
Type : COLORREF
Couleur d’arrière-plan. Pour utiliser ce membre, définissez l’indicateur CFM_BACKCOLOR dans le membre dwMask . Ce membre est ignoré si l’effet de caractère CFE_AUTOBACKCOLOR est spécifié. Pour générer un , utilisez la macro.
lcid
Type : LCID
Identificateur de paramètres régionaux 32 bits qui contient un identificateur de langue dans le mot inférieur et un identificateur de tri et une valeur réservée dans le mot supérieur. Ce membre n’a aucun effet sur le texte affiché par un contrôle d’édition enrichi, mais les vérificateurs d’orthographe et de grammaire peuvent l’utiliser pour résoudre les problèmes liés à la langue. Vous pouvez utiliser la macro pour créer une valeur LCID . Pour utiliser ce membre, définissez l’indicateur CFM_LCID dans le membre dwMask .
dwReserved
Type : DWORD
Réservés au; la valeur doit être égale à zéro.
Type : DWORD
Réservés au; la valeur doit être égale à zéro.
dwCookie
Type : DWORD
Cookie client. Ce membre est opaque à un contrôle d’édition enrichi.
sStyle
Type : SHORT
Handle de style caractère. Cette valeur n’a aucun effet sur le texte affiché par un contrôle d’édition enrichi ; il est inclus pour la compatibilité avec les interfaces WindowsTOM. Pour utiliser ce membre, définissez l’indicateur CFM_STYLE dans le membre dwMask . Pour plus d’informations, consultez la documentation TOM.
wKerning
Type : WORD
Valeur de la taille de police, au-dessus de laquelle kernner le caractère (yHeight). Cette valeur n’a aucun effet sur le texte affiché par un contrôle d’édition enrichi ; il est inclus pour la compatibilité avec les interfaces TOM. Pour utiliser ce membre, définissez l’indicateur CFM_KERNING dans le membre dwMask .
bUnderlineType
Type : BYTE
Spécifie le type de soulignement. Pour utiliser ce membre, définissez l’indicateur CFM_UNDERLINETYPE dans le membre dwMask . Ce membre peut être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
La structure mappe le soulignement de bits de CHARFORMAT à CHARFORMAT2 (autrement dit, elle effectue un soulignement de type CHARFORMAT sur ce texte). |
|
Pour la composition IME, falsifier une sélection. |
|
Texte souligné avec une seule ligne pleine. |
|
Texte souligné avec des tirets. |
|
Texte souligné avec une ligne pointillée et pointillée. |
|
Texte souligné avec une ligne pointillée et doublée. |
|
Texte souligné avec une ligne en pointillés. Pour les versions antérieures à Microsoft Rich Edit 3.0, le texte s’affiche avec un soulignement solide. |
|
Texte souligné avec une double ligne. Le contrôle d’édition enrichi affiche le texte avec un soulignement solide. |
|
Afficher en tant que CFU_UNDERLINEWAVE. |
|
Afficher en tant que CFU_UNDERLINE. |
|
Afficher en tant que CFU_UNDERLINEWAVE. |
|
Afficher en tant que CFU_UNDERLINEDASH. |
|
Pas de soulignement. Il s’agit de la valeur par défaut. |
|
Afficher en tant que CFU_UNDERLINE. |
|
Afficher en tant que CFU_UNDERLINEDASH. |
|
Afficher en tant que CFU_UNDERLINEDASHDOT. |
|
Afficher en tant que CFU_UNDERLINEDASHDOT. |
|
Afficher en tant que CFU_UNDERLINEDOT. |
|
Afficher en tant que CFU_UNDERLINEDASH. |
|
RichEdit 4.1 et versions ultérieures : texte souligné avec une ligne ondulée. |
|
RichEdit 4.1 et versions ultérieures : soulignez uniquement les mots. Le contrôle d’édition enrichi affiche le texte avec un soulignement solide. |
bAnimation
Type : BYTE
Type d’animation de texte. Cette valeur n’a aucun effet sur le texte affiché par un contrôle d’édition enrichi ; il est inclus pour la compatibilité avec les interfaces TOM. Pour utiliser ce membre, définissez l’indicateur CFM_ANIMATION dans le membre dwMask .
bRevAuthor
Type : BYTE
Index qui identifie l’auteur qui effectue une révision. Le contrôle d’édition enrichi utilise des couleurs de texte différentes pour chaque index d’auteur différent. Pour utiliser ce membre, définissez l’indicateur CFM_REVAUTHOR dans le membre dwMask .
bUnderlineColor
Type : BYTE
Couleur de soulignement :
- UnderlineColor_Black = 0x00 ;
- UnderlineColor_Blue = 0x01 ;
- UnderlineColor_Aqua = 0x02 ;
- UnderlineColor_Lime = 0x03 ;
- UnderlineColor_Fuchsia = 0x04 ;
- UnderlineColor_Red = 0x05 ;
- UnderlineColor_Yellow = 0x06 ;
- UnderlineColor_White = 0x07 ;
- UnderlineColor_Navy = 0x08 ;
- UnderlineColor_Teal = 0x09 ;
- UnderlineColor_Green = 0x0A ;
- UnderlineColor_Purple = 0x0B ;
- UnderlineColor_Maroon = 0x0C ;
- UnderlineColor_Olive = 0x0D ;
- UnderlineColor_DkGray = 0x0E ;
- UnderlineColor_LtGray = 0x0F ;
Remarques
Pour désactiver un attribut de mise en forme, définissez la valeur appropriée dans dwMask , mais ne définissez pas la valeur correspondante dans dwEffects. Par exemple, pour désactiver l’italique, définissez CFM_ITALIC mais ne définissez pas CFE_ITALIC.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| En-tête | richedit.h |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour