STRUCTURE PARAFORMAT (richedit.h)

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.

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.

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.

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.

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.

Exigences

Voir aussi

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT2

de référence