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 renseigné 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 peut être aucun ou une combinaison des valeurs suivantes. Si PFM_STARTINDENT et 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 membres cTabStobs et rgxTabStops 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és au; 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 prendre les valeurs suivantes.

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

wEffects

dxStartIndent

Type : LONG

Mise en 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é, ce membre est traité comme une valeur relative ajoutée à la mise en retrait de départ de chaque paragraphe affecté.

dxRightIndent

Type : LONG

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

dxOffset

Type : LONG

Retrait de la deuxième ligne et des lignes suivantes d’un paragraphe par rapport à la mise en retrait de départ, en twips. La première ligne est mise en retrait si ce membre est négatif ou outdented 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 sur la marge gauche.
PFA_RIGHT
 Les paragraphes sont alignés sur la marge droite.

cTabCount

Type : SHORT

Nombre de taquets de tabulation.

rgxTabs[MAX_TAB_STOPS]

Type : LONG

Tableau de positions de taquet de tabulation absolues. Chaque élément du tableau spécifie des informations sur un taquet de tabulation. Les 24 bits d’ordre inférieur 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 d’ordre élevé pour stocker des informations supplémentaires sur chaque tab-stop.

Les bits 24 à 27 peuvent spécifier l’une des valeurs suivantes pour indiquer l’alignement de la tabulation. 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
 Word onglet barre (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
 Meneur en pointillés
2
 Leader en pointillés
3
 Leader souligné
4
 Chef de ligne épais
5
 Tête de ligne double

Spécifications

   
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

PARAFORMAT2

Référence