Partager via

STRUCTURE PARAFORMAT (richedit.h)

  • Article

Contient des informations sur les attributs de mise en forme de paragraphe dans un contrôle d’édition enrichi. Cette structure est utilisée avec les messages EM_GETPARAFORMAT et EM_SETPARAFORMAT.

Dans Microsoft Rich Edit 2.0, la structure 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 EM_GETPARAFORMAT et EM_SETPARAFORMAT.

Syntaxe

typedef struct _paraformat {
  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];
} PARAFORMAT;

Membres

cbSize

Type : UINT

Taille de la structure, en octets. Le membre doit être rempli avant de passer au contrôle d’édition enrichi.

dwMask

Type : DWORD

Membres contenant des informations ou des attributs valides à définir. Ce paramètre ne peut être aucun ou une combinaison des valeurs suivantes. Si les PFM_STARTINDENT et les PFM_OFFSETINDENT sont spécifiés, PFM_STARTINDENT est prioritaire.

Valeur Signification
PFM_ALIGNMENT
 Le membre wAlignment est valide.
PFM_NUMBERING
 Le membre wNumbering est valide.
PFM_OFFSET
 Le membre dxOffset est valide.
PFM_OFFSETINDENT
 Le membre dxStartIndent est valide et spécifie une valeur relative.
PFM_RIGHTINDENT
 Le membre dxRightIndent est valide.
PFM_RTLPARA
 Rich Edit 2.0 : le membre wEffects est valide
PFM_STARTINDENT
 Le membre dxStartIndent est valide.
PFM_TABSTOPS
 Les cTabStobs et rgxTabStops membres sont valides.

wNumbering

Type : WORD

Valeur spécifiant les options de numérotation. Ce membre peut être égal à zéro ou PFN_BULLET.

wReserved

Type : WORD

Rich Edit 1.0 :: ce membre est nommé wReserved. Réservé; la valeur doit être égale à zéro.

Rich Edit 2.0 : Ce membre est nommé wEffects. Indicateur de bits qui spécifie un effet de paragraphe. Il 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. Ce paramètre peut être l’une des valeurs suivantes.

Valeur Signification
0
 Affiche du texte à l’aide de l’ordre de lecture de gauche à droite. Il s’agit de la valeur par défaut.
PFE_RLTPARA
 Affiche du texte à l’aide de l’ordre de lecture de droite à gauche.

wEffects

dxStartIndent

Type : LONG

Retrait de la première ligne du paragraphe, en twips. Si la mise en forme du paragraphe est définie et que PFM_OFFSETINDENT est spécifiée, ce membre est traité comme une valeur relative ajoutée au retrait de départ de chaque paragraphe concerné.

dxRightIndent

Type : LONG

Taille, de la mise en retrait droite par rapport à la marge droite, en twips.

dxOffset

Type : LONG

Retrait des deuxièmes lignes et suivantes d’un paragraphe par rapport à la mise en retrait initiale, en twips. La première ligne est mise en retrait si ce membre est négatif ou dépassé si ce membre est positif.

wAlignment

Type : WORD

Valeur spécifiant l’alignement du paragraphe. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
PFA_CENTER
 Les paragraphes sont centrés.
PFA_LEFT
 Les paragraphes sont alignés avec la marge gauche.
PFA_RIGHT
 Les paragraphes sont alignés avec la marge droite.

cTabCount

Type : SHORT

Nombre d’taquets de tabulation.

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
0
 Onglet ordinaire
1
 Onglet Centre
2
 Onglet aligné à droite
3
 Onglet décimal
4
 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
0
 Aucun leader
1
 Chef en pointillés
2
 Leader en pointillés
3
 Chef souligné
4
 Leader de ligne épais
5
 Leader de ligne double

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

PARAFORMAT2

de référence