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 une structure avec les messages EM_GETPARAFORMAT et EM_SETPARAFORMAT.

Syntaxe

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 de 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 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 de 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	Espacement un-et-demi. Le membre dyLineSpacing est ignoré.
2	Espacement double. Le membre dyLineSpacing est ignoré.
3	Le membre dyLineSpacing spécifie l’espacement d’une ligne à l’autre, en twips. Toutefois, si dyLineSpacing spécifie une valeur inférieure à un espacement unique, le contrôle affiche du texte à espacement unique.
4	Le dyLineSpacing membre 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. Par conséquent, définir dyLineSpacing à 20 produit du texte à espace unique, 40 est double espacement, 60 est triple espacé, et ainsi de suite.

bOutlineLevel

Type : BYTE

Réservé; 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 de trame 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 de 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 de 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.

Valeur	Signification
0	Aucun
1	Horizontal foncé
2	Vertical foncé
3	Diagonale sombre vers le bas
4	Diagonale foncée vers le haut
5	Grille sombre
6	Trellis foncés
7	Clair horizontal
8	Vertical clair
9	Diagonale légère vers le bas
10	Éclaircir la diagonale
11	Grille légère
12	Trellis lumineux

 

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	Blanc
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 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 enrichies antérieures à la version 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 une période.
PFNS_PLAIN	Affiche uniquement le nombre.
PFNS_NONUMBER	Poursuit une liste numérotée sans appliquer le numéro ou la puce suivant.
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 ; précédent à Microsoft Rich Edit 3.0, le contrôle de modification enrichi 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 de bordure, style et couleur. 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 dans les bits 0 à 7.

Valeur	Signification
1	Bordure gauche.
2	Bordure droite.
4	Bordure supérieure.
8	Bordure inférieure.
16	Bordures intérieures.
32	En dehors des frontières.
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	Aucun
1	3/4 points de
2	11 point de/2
3	21 point de/4
4	3 points
5	41/2 points de
6	6 points
7	3/ 4 points de point double
8	11/2 points double
9	21/4 points double
10	3/4 gris point
11	3/4 points gris pointillé

 

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

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	richedit.h

Voir aussi

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT