struttura PARAFORMAT2 (richedit.h)

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

struct PARAFORMAT2 : _paraformat {
  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;
};

Eredità

La struttura PARAFORMAT2 implementa _paraformat.

Membri

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.

Valore Significato
0
Spaziatura singola. Il membro dyLineSpacing viene ignorato.
1
Spaziatura uno e mezzo. Il membro dyLineSpacing viene ignorato.
2
Spaziatura doppia. Il membro dyLineSpacing viene ignorato.
3
Il membro dyLineSpacing specifica la spaziatura da una riga alla successiva, in twip. Tuttavia, se dyLineSpacing specifica un valore minore della spaziatura singola, il controllo visualizza testo a spaziatura singola.
4
Il membro dyLineSpacing specifica la spaziatura da una riga alla successiva, in twip. Il controllo utilizza la spaziatura esatta specificata, anche se dyLineSpacing specifica un valore minore della spaziatura singola.
5
Il valore di dyLineSpacing / 20 è la spaziatura, espressa in righe, da una riga alla successiva. Pertanto, impostando dyLineSpacing su 20 produce testo a spaziatura singola, 40 è a spaziatura doppia, 60 è a tre spazi e così via.

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.

Valore Significato
0
Nessuno
1
Orizzontale scuro
2
Verticale scuro
3
Diagonale scura verso il basso
4
Diagonale scura su
5
Griglia scura
6
Trelli scuri
7
Orizzontale chiaro
8
Verticale chiaro
9
Diagonale chiaro verso il basso
10
Diagonale chiara
11
Griglia chiara
12
Trelli leggeri
 

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

Valore Significato
0
Nero
1
Blu
2
Ciano
3
Verde
4
Magenta
5
Rosso
6
Giallo
7
Bianco
8
Blu scuro
9
Ciano scuro
10
Verde scuro
11
Magenta scuro
12
Rosso scuro
13
Giallo scuro
14
Grigio scuro
15
Grigio chiaro

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.

Valore Significato
PFNS_PAREN
Segue il numero con una parentesi destra.
PFNS_PARENS
Racchiude il numero tra parentesi.
PFNS_PERIOD
Segue il numero con un punto.
PFNS_PLAIN
Visualizza solo il numero.
PFNS_NONUMBER
Continua un elenco numerato senza applicare il numero o il punto elenco successivo.
PFNS_NEWNUMBER
Avvia un nuovo numero con wNumberingStart.

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.

Valore Significato
1
Bordo sinistro.
2
Bordo destro.
4
Bordo superiore.
8
Bordo inferiore.
16
Bordi interni.
32
Bordi esterni.
64
Colore automatico. Se questo bit è impostato, l'indice dei colori in bit da 12 a 15 non viene utilizzato.
 

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

Valore Significato
0
Nessuno
1
3/4 punto
2
1 punto1/2
3
21/4 punto
4
3 punti
5
41 punto/2
6
6 punti
7
3/4 punto doppio
8
11/2 punto doppio
9
21/4 punto doppio
10
3/4 grigio
11
3/4 punto grigio tratteggiato
 

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).

Valore Significato
0
Nero
1
Blu
2
Ciano
3
Verde
4
Magenta
5
Rosso
6
Giallo
7
Bianco
8
Blu scuro
9
Ciano scuro
10
Verde scuro
11
Magenta scuro
12
Rosso scuro
13
Giallo scuro
14
Grigio scuro
15
Grigio chiaro

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
intestazione richedit.h

Vedere anche

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT