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.
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
dwMask
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 valides ; un autre jeu indique les attributs valides dans le wEffects membre.
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 |
|---|---|
|
Aucune numérotation ou puce de paragraphe. |
|
Insérez une puce au début de chaque paragraphe sélectionné. |
Les versions rich Edit antérieures à la version 3.0 n’affichent pas de numéros de paragraphe. Toutefois, pour la compatibilité avec les interfaces MICROSOFT Text Object Model (TOM), wNumbering pouvez spécifier l’une des valeurs suivantes. (Le contrôle d’édition enrichi stocke la valeur, mais ne l’utilise pas pour afficher le texte.)
wReserved
wEffects
Type : WORD
Ce membre est également appelé wReserved pour Microsoft Rich Edit 1.0, car il était réservé.
Rich Edit 1.0 : réservé ; 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
dxRightIndent
Type : LONG
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 des secondes 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 dépassé 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 de PFM_ALIGNMENT dans le membre dwMask
cTabCount
Type : SHORT
Nombre de taquets de tabulation définis dans le tableau rgxTabs.
rgxTabs[MAX_TAB_STOPS]
Type : LONG
Tableau de positions absolues de taquets de tabulation. Chaque élément du tableau spécifie des informations sur un taquet de tabulation. Les 24 bits de faible ordre 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 de commande élevée pour stocker des informations supplémentaires sur chaque taquet de tabulation.
Les bits 24-27 peuvent spécifier l’une des valeurs suivantes pour indiquer l’alignement des onglets. 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 |
|
Onglet barre Word (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 |
|
Chef en pointillés |
|
Leader en pointillés |
|
Chef souligné |
|
Leader de ligne épais |
|
Leader 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 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
bLineSpacingRule
Type d’espacement de ligne. Pour utiliser ce membre, définissez l’indicateur de PFM_LINESPACING dans le membre dwMask
bOutlineLevel
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
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.
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 |
|
Blanc |
|
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 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
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
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.
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 |
|
Blanc |
|
Bleu foncé |
|
Cyan foncé |
|
Vert foncé |
|
Magenta foncé |
|
Rouge foncé |
|
Jaune foncé |
|
Gris foncé |
|
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 |