struttura PARAFORMAT2 (Rich Edit 2.0)

Contiene informazioni sugli attributi di formattazione dei paragrafi in un controllo di modifica avanzato. PARAFORMAT2 è un'estensione di Microsoft Rich Edit 2.0 della struttura PARAFORMAT . Microsoft Rich Edit 2.0 consente di usare una delle due strutture con i messaggi EM_GETPARAFORMAT e EM_SETPARAFORMAT.

Sintassi

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;

Membri

cbSize

Tipo: UINT

Dimensioni della struttura, in byte. Prima di passare questa struttura a un controllo di modifica avanzato, impostare cbSize sulle dimensioni della struttura PARAFORMAT o PARAFORMAT2. Se cbSize è uguale alla dimensione di una struttura PARAFORMAT , il controllo utilizza solo i membri PARAFORMAT.

dwMask

Tipo: DWORD

Membri della struttura PARAFORMAT2 che contengono informazioni valide. Il membro dwMask può essere una combinazione dei valori di due set di flag di bit. Un set indica i membri della struttura validi; un altro set indica gli attributi validi nel membro wEffects.

Impostare i valori seguenti per indicare i membri della struttura validi.

Impostare i valori seguenti per indicare gli attributi validi del membro wEffects.

wNumbering

Tipo: WORD

Opzioni utilizzate per i paragrafi puntati o numerati. Per utilizzare questo membro, impostare il flag PFM_NUMBERING nel membro dwMask.

Questo membro può essere uno dei valori seguenti.

Le versioni rich Edit precedenti alla versione 3.0 non visualizzano i numeri di paragrafo. Tuttavia, per la compatibilità con le interfacce (TOM) di Microsoft Text Object Model, wNumbering può specificare uno dei valori seguenti. Il controllo rich edit archivia il valore ma non lo usa per visualizzare il testo.

wReserved

wEffects

Tipo: WORD

Questo membro è noto anche come wReserved per Microsoft Rich Edit 1.0 perché era riservato.

Rich Edit 1.0: riservato; il valore deve essere zero.

Rich Edit 2.0: Set di flag di bit che specificano gli effetti di paragrafo. Questi flag sono inclusi solo per compatibilità con le interfacce TOM; Il controllo rich edit archivia il valore, ma non lo usa per visualizzare il testo.

Questo membro può essere una combinazione dei valori seguenti.

dxStartIndent

Tipo: LONG

Rientro della prima riga del paragrafo, in twip. Il rientro delle righe successive dipende dal membro dxOffset . Per usare il membro dxStartIndent, impostare il flag PFM_STARTINDENT o PFM_OFFSETINDENT nel membro dwMask. Se si imposta il rientro, usare il flag PFM_STARTINDENT per specificare un rientro assoluto dal margine sinistro; oppure utilizzare il flag PFM_OFFSETINDENT per specificare un rientro relativo al rientro corrente del paragrafo. Utilizzare entrambi i flag per recuperare il rientro corrente.

dxRightIndent

Tipo: LONG

Rientro del lato destro del paragrafo, rispetto al margine destro, in twip. Per usare questo membro, impostare il flag di PFM_RIGHTINDENT nel membro dwMask.

dxOffset

Tipo: LONG

Rientro della seconda e delle righe successive, rispetto al rientro della prima riga, in twip. La prima riga viene rientrata se questo membro è negativo o rientrato se questo membro è positivo. Per utilizzare questo membro, impostare il flag di PFM_OFFSET nel membro dwMask.

wAlignment

Tipo: WORD

Allineamento paragrafo. Per utilizzare questo membro, impostare il flag PFM_ALIGNMENT nel membro dwMask. Questo membro può essere uno dei valori seguenti.

cTabCount

Tipo: SHORT

Numero di tabulazioni definite nella matrice rgxTabs.

rgxTabs[MAX_TAB_STOPS]

Tipo: LONG

Matrice di posizioni di tabulazione assolute. Ogni elemento nella matrice specifica le informazioni relative a una tabulazione. I 24 bit a basso ordine specificano l'offset assoluto, espresso in twip. Per utilizzare questo membro, impostare il flag di PFM_TABSTOPS nel membro dwMask .

Rich Edit 2.0: Per compatibilità con le interfacce TOM, è possibile usare gli otto bit di ordine elevato per archiviare informazioni aggiuntive su ogni tabulazione.

I bit da 24 a 27 possono specificare uno dei valori seguenti per indicare l'allineamento delle schede. Questi bit non influiscono sulla visualizzazione rich edit control per le versioni precedenti a Microsoft Rich Edit 3.0.

I bit da 28 a 31 possono specificare uno dei valori seguenti per indicare il tipo di tabulazione. Questi bit non influiscono sulla visualizzazione del controllo di modifica rtf.

dySpaceBefore

Tipo: LONG

Dimensione della spaziatura sopra il paragrafo, in twip. Per utilizzare questo membro, impostare il flag di PFM_SPACEBEFORE nel membro dwMask . Il valore deve essere maggiore o uguale a zero.

dySpaceAfter

Tipo: LONG

Specifica la dimensione della spaziatura sotto il paragrafo, espressa in twip. Per utilizzare questo membro, impostare il flag di PFM_SPACEAFTER nel membro dwMask. Il valore deve essere maggiore o uguale a zero.

dyLineSpacing

Tipo: LONG

Spaziatura tra le linee. Per una descrizione della modalità di interpretazione di questo valore, vedere il membro bLineSpacingRule. Per usare questo membro, impostare il flag PFM_LINESPACING nel membro dwMask.

sStyle

Tipo: SHORT

Stile testo. Per utilizzare questo membro, impostare il flag di PFM_STYLE nel membro dwMask. Questo membro è incluso solo per la compatibilità con le interfacce TOM e Word; Il controllo rich edit archivia il valore, ma non lo usa per visualizzare il testo.

bLineSpacingRule

Tipo: BYTE

Tipo di spaziatura linea. Per usare questo membro, impostare il flag PFM_LINESPACING nel membro dwMask. Questo membro può essere uno dei valori seguenti.

bOutlineLevel

Tipo: BYTE

Riservato; deve essere zero.

wShadingWeight

Tipo: WORD

Colore di primo piano percentuale utilizzato nell'ombreggiatura. Il membro wShadingStyle specifica i colori di sfondo e sfondo in primo piano. Il valore 5 indica un colore di ombreggiatura costituito dal colore di primo piano del 5% e dal colore di sfondo del 95%. Per usare questi membri, impostare il flag di PFM_SHADING nel membro dwMask. Questo membro è incluso solo per la compatibilità con Word; Il controllo rich edit archivia il valore, ma non lo usa per visualizzare il testo.

wShadingStyle

Tipo: WORD

Stile e colori utilizzati per l'ombreggiatura dello sfondo. I bit da 0 a 3 contengono lo stile di ombreggiatura, i bit da 4 a 7 contengono l'indice dei colori di primo piano e i bit da 8 a 11 contengono l'indice dei colori di sfondo. Per usare questo membro, impostare il flag di PFM_SHADING nel membro dwMask. Questo membro è incluso solo per la compatibilità con Word; Il controllo rich edit archivia il valore, ma non lo usa per visualizzare il testo.

Lo stile di ombreggiatura può essere uno dei valori seguenti.

Gli indici di colore di primo piano e di sfondo possono essere uno dei valori seguenti.

wNumberingStart

Tipo: WORD

Numero iniziale o valore Unicode utilizzato per i paragrafi numerati. Utilizzare questo membro insieme al membro wNumbering. Questo membro è incluso solo per compatibilità con le interfacce TOM; Il controllo rich edit archivia il valore, ma non lo usa per visualizzare il testo o i punti elenco. Per utilizzare questo membro, impostare il flag di PFM_NUMBERINGSTART nel membro dwMask.

wNumberingStyle

Tipo: WORD

Stile di numerazione utilizzato con paragrafi numerati. Utilizzare questo membro insieme al membro wNumbering. Questo membro è incluso solo per compatibilità con le interfacce TOM; Il controllo rich edit archivia il valore, ma le versioni di modifica avanzate precedenti alla 3.0 non lo usano per visualizzare il testo o i punti elenco. Per usare questo membro, impostare il flag di PFM_NUMBERINGSTYLE nel membro dwMask . Questo membro può essere uno dei valori seguenti.

wNumberingTab

Tipo: WORD

Spazio minimo tra un numero di paragrafo e il testo del paragrafo, in twip. Utilizzare questo membro insieme al membro wNumbering. Il membro wNumberingTab è incluso per la compatibilità con le interfacce TOM; precedentemente a Microsoft Rich Edit 3.0, il controllo rich edit archivia il valore ma non lo usa per visualizzare il testo. Per utilizzare questo membro, impostare il flag di PFM_NUMBERINGTAB nel membro dwMask .

wBorderSpace

Tipo: WORD

Spazio tra il bordo e il testo del paragrafo, espresso in twip. Il membro wBorderSpace è incluso per la compatibilità con Word; Il controllo rich edit archivia i valori, ma non li usa per visualizzare il testo. Per utilizzare questo membro, impostare il flag di PFM_BORDER nel membro dwMask .

wBorderWidth

Tipo: WORD

Larghezza bordo, in twip. Per utilizzare questo membro, impostare il flag di PFM_BORDER nel membro dwMask .

wBorders

Tipo: WORD

Posizione, stile e colore del bordo. I bit da 0 a 7 specificano le posizioni dei bordi, i bit da 8 a 11 specificano lo stile del bordo e i bit da 12 a 15 specificano l'indice dei colori del bordo. Per utilizzare questo membro, impostare il flag di PFM_BORDER nel membro dwMask .

Specificare le posizioni dei bordi usando una combinazione dei valori seguenti in bit da 0 a 7.

Specificare lo stile del bordo utilizzando uno dei valori seguenti per i bit da 8 a 11.

Specificare il colore del bordo usando uno dei valori seguenti per i bit da 12 a 15. Questo valore viene ignorato se è impostato il bit autocolor (bit 6).

Fabbisogno

Vedere anche

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT