structure PARAFORMAT2 (richedit.h)

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 .

Syntax

struct PARAFORMAT2 : _paraformat {
  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;
};

Héritage

La structure PARAFORMAT2 implémente _paraformat.

Membres

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’espacement de ligne. Pour utiliser ce membre, définissez l’indicateur PFM_LINESPACING dans le membre dwMask . Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
0	Espacement unique. Le membre dyLineSpacing est ignoré.
1	Un espacement et demi. Le membre dyLineSpacing est ignoré.
2	Double espacement. Le membre dyLineSpacing est ignoré.
3	Le membre dyLineSpacing spécifie l’espacement d’une ligne à la suivante, en twips. Toutefois, si dyLineSpacing spécifie une valeur inférieure à un espacement unique, le contrôle affiche du texte à espace unique.
4	Le membre dyLineSpacing spécifie l’espacement d’une ligne à l’autre, en twips. Le contrôle utilise l’espacement exact spécifié, même si dyLineSpacing spécifie une valeur inférieure à l’espacement unique.
5	La valeur de dyLineSpacing /20 est l’espacement, en lignes, d’une ligne à l’autre. Ainsi, la définition de dyLineSpacing sur 20 produit du texte interligne simple, 40 est interligne double, 60 est triple interligne, et ainsi de suite.

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 d’ombrage 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 enrichie 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 enrichie stocke la valeur, mais ne l’utilise pas pour afficher le texte.

Le style de trame de fond peut être l’une des valeurs suivantes.

Valeur	Signification
0	None
1	Horizontale foncée
2	Verticale foncée
3	Diagonale sombre vers le bas
4	Assombrir la diagonale
5	Grille sombre
6	Treillis foncé
7	Horizontal clair
8	Vertical clair
9	Diagonale légère vers le bas
10	Allumer la diagonale
11	Grille lumineuse
12	Treillis clair

 

Les index de couleur de premier plan et d’arrière-plan peuvent être l’une des valeurs suivantes.

Valeur	Signification
0	Noir
1	Bleu
2	Cyan
3	Vert
4	Magenta
5	Rouge
6	Jaune
7	White
8	Bleu foncé
9	Cyan foncé
10	Vert foncé
11	Magenta foncé
12	Rouge foncé
13	Jaune foncé
14	Gris foncé
15	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 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 enrichie 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.

Valeur	Signification
PFNS_PAREN	Suit le nombre avec une parenthèse droite.
PFNS_PARENS	Place le nombre entre parenthèses.
PFNS_PERIOD	Suit le nombre avec un point.
PFNS_PLAIN	Affiche uniquement le nombre.
PFNS_NONUMBER	Continue une liste numérotée sans appliquer le numéro ou la puce suivante.
PFNS_NEWNUMBER	Démarre un nouveau nombre avec wNumberingStart.

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

Valeur	Signification
1	Bordure gauche.
2	Bordure droite.
4	Bordure supérieure.
8	Bordure inférieure.
16	Bordures intérieures.
32	Bordures extérieures.
64	Couleur automatique. Si ce bit est défini, l’index de couleur en bits 12 à 15 n’est pas utilisé.

 

Spécifiez le style de bordure à l’aide de l’une des valeurs suivantes pour les bits 8 à 11.

Valeur	Signification
0	None
1	3/4 points
2	11/2 points
3	21/4 points
4	3 points
5	41/2 points
6	6 points
7	3/Double 4 points
8	11/2 points double
9	21/4 points double
10	3/Gris à 4 points
11	3/4 points gris en pointillés

 

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 d’autocolorie (bit 6) est défini.

Valeur	Signification
0	Noir
1	Bleu
2	Cyan
3	Vert
4	Magenta
5	Rouge
6	Jaune
7	White
8	Bleu foncé
9	Cyan foncé
10	Vert foncé
11	Magenta foncé
12	Rouge foncé
13	Jaune foncé
14	Gris foncé
15	Gris clair

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

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT