structure PARAFORMAT2 (Rich Edit 2.0)
Contient des informations sur les attributs de mise en forme de paragraphe dans un contrôle d’édition enrichi. PARAFORMAT2 est une extension Microsoft Rich Edit 2.0 de la structure PARAFORMAT . Microsoft Rich Edit 2.0 vous permet d’utiliser l’une ou l’autre structure avec les messages EM_GETPARAFORMAT et EM_SETPARAFORMAT .
Syntaxe
typedef struct _paraformat2 {
UINT cbSize;
DWORD dwMask;
WORD wNumbering;
union {
WORD wReserved;
WORD wEffects;
};
LONG dxStartIndent;
LONG dxRightIndent;
LONG dxOffset;
WORD wAlignment;
SHORT cTabCount;
LONG rgxTabs[MAX_TAB_STOPS];
LONG dySpaceBefore;
LONG dySpaceAfter;
LONG dyLineSpacing;
SHORT sStyle;
BYTE bLineSpacingRule;
BYTE bOutlineLevel;
WORD wShadingWeight;
WORD wShadingStyle;
WORD wNumberingStart;
WORD wNumberingStyle;
WORD wNumberingTab;
WORD wBorderSpace;
WORD wBorderWidth;
WORD wBorders;
} PARAFORMAT2;
Membres
cbSize
Type : UINT
Taille de la structure, en octets. Avant de passer cette structure à un contrôle d’édition enrichi, définissez cbSize sur la taille de la structure PARAFORMAT ou PARAFORMAT2 . Si cbSize est égal à la taille d’une structure PARAFORMAT , le contrôle utilise uniquement les membres PARAFORMAT .
dwMask
Type : DWORD
Les membres de la structure PARAFORMAT2 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 wEffects .
Définissez les valeurs suivantes pour indiquer les membres de structure valides.
Définissez les valeurs suivantes pour indiquer les attributs valides du membre wEffects .
wNumbering
Type : WORD
Options utilisées pour les paragraphes à puces ou numérotés. Pour utiliser ce membre, définissez l’indicateur PFM_NUMBERING dans le membre dwMask .
Ce membre peut être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Pas de numérotation de paragraphes ou de puces. |
|
Insérez une puce au début de chaque paragraphe sélectionné. |
Les versions d’édition enrichie antérieures à la version 3.0 n’affichent pas les numéros de paragraphe. Toutefois, pour la compatibilité avec les interfaces TOM (Microsoft Text Object Model ), wNumbering peut spécifier l’une des valeurs suivantes. (Le contrôle d’édition enrichie stocke la valeur, mais ne l’utilise pas pour afficher le texte.)
wReserved
wEffects
Type : WORD
Ce membre est également appelé wReserved for Microsoft Rich Edit 1.0, car il était réservé.
Rich Edit 1.0 : Réservés au; la valeur doit être égale à zéro.
Rich Edit 2.0 : Ensemble d’indicateurs de bits qui spécifient des effets de paragraphe. Ces indicateurs sont inclus uniquement pour la compatibilité avec les interfaces TOM ; le contrôle d’édition enrichi stocke la valeur, mais ne l’utilise pas pour afficher le texte.
Ce membre peut être une combinaison des valeurs suivantes.
dxStartIndent
Type : LONG
Retrait de la première ligne du paragraphe, en twips. La mise en retrait des lignes suivantes dépend du membre dxOffset . Pour utiliser le membre dxStartIndent, définissez l’indicateur PFM_STARTINDENT ou PFM_OFFSETINDENT dans le membre dwMask . Si vous définissez la mise en retrait, utilisez l’indicateur PFM_STARTINDENT pour spécifier une mise en retrait absolue à partir de la marge gauche ; ou utilisez l’indicateur PFM_OFFSETINDENT pour spécifier une mise en retrait par rapport à la mise en retrait actuelle du paragraphe. Utilisez l’un ou l’autre indicateur pour récupérer la mise en retrait actuelle.
dxRightIndent
Type : LONG
Mise en retrait du côté droit du paragraphe, par rapport à la marge droite, en twips. Pour utiliser ce membre, définissez l’indicateur PFM_RIGHTINDENT dans le membre dwMask .
dxOffset
Type : LONG
Retrait de la deuxième ligne et des lignes suivantes, par rapport à la mise en retrait de la première ligne, en twips. La première ligne est mise en retrait si ce membre est négatif ou outdented si ce membre est positif. Pour utiliser ce membre, définissez l’indicateur PFM_OFFSET dans le membre dwMask .
wAlignment
Type : WORD
Alignement des paragraphes. Pour utiliser ce membre, définissez l’indicateur PFM_ALIGNMENT dans le membre dwMask . Ce membre peut être l’une des valeurs suivantes.
cTabCount
Type : SHORT
Nombre de taquets de tabulation définis dans le tableau rgxTabs .
rgxTabs[MAX_TAB_STOPS]
Type : LONG
Tableau de positions de taquet de tabulation absolues. Chaque élément du tableau spécifie des informations sur un taquet de tabulation. Les 24 bits d’ordre inférieur spécifient le décalage absolu, en twips. Pour utiliser ce membre, définissez l’indicateur PFM_TABSTOPS dans le membre dwMask .
Rich Edit 2.0 : Pour la compatibilité avec les interfaces TOM, vous pouvez utiliser les huit bits d’ordre élevé pour stocker des informations supplémentaires sur chaque tab-stop.
Les bits 24 à 27 peuvent spécifier l’une des valeurs suivantes pour indiquer l’alignement de la tabulation. Ces bits n’affectent pas l’affichage du contrôle d’édition enrichi pour les versions antérieures à Microsoft Rich Edit 3.0.
| Valeur | Signification |
|---|---|
|
Onglet Ordinaire |
|
Onglet Centre |
|
Onglet aligné à droite |
|
Onglet Décimal |
|
Word onglet barre (barre verticale) |
Les bits 28 à 31 peuvent spécifier l’une des valeurs suivantes pour indiquer le type de leader de tabulation. Ces bits n’affectent pas l’affichage du contrôle d’édition enrichi.
| Valeur | Signification |
|---|---|
|
Aucun leader |
|
Leader en pointillés |
|
Leader en pointillés |
|
Leader souligné |
|
Chef de ligne épais |
|
Tête de ligne double |
dySpaceBefore
Type : LONG
Taille de l’espacement au-dessus du paragraphe, en twips. Pour utiliser ce membre, définissez l’indicateur PFM_SPACEBEFORE dans le membre dwMask . La valeur doit être supérieure ou égale à zéro.
dySpaceAfter
Type : LONG
Spécifie la taille de l’espacement sous le paragraphe, en twips. Pour utiliser ce membre, définissez l’indicateur PFM_SPACEAFTER dans le membre dwMask . La valeur doit être supérieure ou égale à zéro.
dyLineSpacing
Type : LONG
Espacement entre les lignes. Pour obtenir une description de la façon dont cette valeur est interprétée, consultez le membre bLineSpacingRule . Pour utiliser ce membre, définissez l’indicateur PFM_LINESPACING dans le membre dwMask .
sStyle
Type : SHORT
Style de texte. Pour utiliser ce membre, définissez l’indicateur PFM_STYLE dans le membre dwMask . Ce membre est inclus uniquement pour la compatibilité avec les interfaces TOM et les Word ; le contrôle d’édition enrichi stocke la valeur, mais ne l’utilise pas pour afficher le texte.
bLineSpacingRule
Type : BYTE
Type d’interligne. Pour utiliser ce membre, définissez l’indicateur PFM_LINESPACING dans le membre dwMask . Ce membre peut être l’une des valeurs suivantes.
bOutlineLevel
Type : BYTE
Réservés au; doit être égal à zéro.
wShadingWeight
Type : WORD
Pourcentage de couleur de premier plan utilisée dans l’ombrage. Le membre wShadingStyle spécifie les couleurs d’ombrage de premier plan et d’arrière-plan. La valeur 5 indique une couleur de trame composée de 5 % de couleur de premier plan et de 95 % de couleur d’arrière-plan. Pour utiliser ces membres, définissez l’indicateur PFM_SHADING dans le membre dwMask . Ce membre est inclus uniquement pour la compatibilité avec Word ; le contrôle d’édition enrichi stocke la valeur, mais ne l’utilise pas pour afficher le texte.
wShadingStyle
Type : WORD
Style et couleurs utilisés pour l’ombrage d’arrière-plan. Les bits 0 à 3 contiennent le style d’ombrage, les bits 4 à 7 contiennent l’index de couleur de premier plan et les bits 8 à 11 contiennent l’index de couleur d’arrière-plan. Pour utiliser ce membre, définissez l’indicateur PFM_SHADING dans le membre dwMask . Ce membre est inclus uniquement pour la compatibilité avec Word ; le contrôle d’édition enrichi stocke la valeur, mais ne l’utilise pas pour afficher le texte.
Le style d’ombrage peut être l’une des valeurs suivantes.
Les index de couleur de premier plan et d’arrière-plan peuvent être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Noir |
|
Bleu |
|
Cyan |
|
Vert |
|
Magenta |
|
Rouge |
|
Jaune |
|
White |
|
Bleu foncé |
|
Cyan foncé |
|
Vert foncé |
|
Magenta foncé |
|
Rouge foncé |
|
Jaune foncé |
|
Gris foncé |
|
Gris clair |
wNumberingStart
Type : WORD
Nombre de départ ou valeur Unicode utilisée pour les paragraphes numérotés. Utilisez ce membre conjointement avec le membre wNumbering . Ce membre est inclus uniquement pour la compatibilité avec les interfaces TOM ; le contrôle d’édition enrichi stocke la valeur, mais ne l’utilise pas pour afficher le texte ou les puces. Pour utiliser ce membre, définissez l’indicateur PFM_NUMBERINGSTART dans le membre dwMask .
wNumberingStyle
Type : WORD
Style de numérotation utilisé avec des paragraphes numérotés. Utilisez ce membre conjointement avec le membre wNumbering . Ce membre est inclus uniquement pour la compatibilité avec les interfaces TOM ; le contrôle d’édition enrichi stocke la valeur, mais les versions d’édition enrichie antérieures à 3.0 ne l’utilisent pas pour afficher le texte ou les puces. Pour utiliser ce membre, définissez l’indicateur PFM_NUMBERINGSTYLE dans le membre dwMask . Ce membre peut être l’une des valeurs suivantes.
wNumberingTab
Type : WORD
Espace minimal entre un numéro de paragraphe et le texte du paragraphe, en twips. Utilisez ce membre conjointement avec le membre wNumbering . Le membre wNumberingTab est inclus pour la compatibilité avec les interfaces TOM ; avant Microsoft Rich Edit 3.0, le contrôle d’édition enrichie stocke la valeur, mais ne l’utilise pas pour afficher du texte. Pour utiliser ce membre, définissez l’indicateur PFM_NUMBERINGTAB dans le membre dwMask .
wBorderSpace
Type : WORD
Espace entre la bordure et le texte du paragraphe, en twips. Le membre wBorderSpace est inclus pour la compatibilité avec Word ; le contrôle d’édition enrichi stocke les valeurs, mais ne les utilise pas pour afficher du texte. Pour utiliser ce membre, définissez l’indicateur PFM_BORDER dans le membre dwMask .
wBorderWidth
Type : WORD
Largeur de bordure, en twips. Pour utiliser ce membre, définissez l’indicateur PFM_BORDER dans le membre dwMask .
wBorders
Type : WORD
Emplacement, style et couleur de bordure. Les bits 0 à 7 spécifient les emplacements de bordure, les bits 8 à 11 spécifient le style de bordure et les bits 12 à 15 spécifient l’index de couleur de bordure. Pour utiliser ce membre, définissez l’indicateur PFM_BORDER dans le membre dwMask .
Spécifiez les emplacements de bordure à l’aide d’une combinaison des valeurs suivantes en bits 0 à 7.
Spécifiez le style de bordure à l’aide de l’une des valeurs suivantes pour les bits 8 à 11.
Spécifiez la couleur de bordure à l’aide de l’une des valeurs suivantes pour les bits 12 à 15. Cette valeur est ignorée si le bit de couleur automatique (bit 6) est défini.
| Valeur | Signification |
|---|---|
|
Noir |
|
Bleu |
|
Cyan |
|
Vert |
|
Magenta |
|
Rouge |
|
Jaune |
|
White |
|
Bleu foncé |
|
Cyan foncé |
|
Vert foncé |
|
Magenta foncé |
|
Rouge foncé |
|
Jaune foncé |
|
Gris foncé |
|
Gris clair |
Configuration requise
| 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