struttura PARAFORMAT2 (Rich Edit 2.0)
Contiene informazioni sugli attributi di formattazione dei paragrafi in un controllo di modifica avanzato.
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
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
dwMask
Membri della struttura PARAFORMAT2 che contengono informazioni valide. Il membro dwMask
Impostare i valori seguenti per indicare i membri della struttura validi.
Impostare i valori seguenti per indicare gli attributi validi del membro wEffects.
wNumbering
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.
| Valore | Significato |
|---|---|
|
Nessun punto elenco o numerazione di paragrafo. |
|
Inserire un punto elenco all'inizio di ogni paragrafo selezionato. |
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
wReserved
wEffects
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
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
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
Allineamento paragrafo. Per utilizzare questo membro, impostare il flag PFM_ALIGNMENT nel membro dwMask. Questo membro può essere uno dei valori seguenti.
cTabCount
Numero di tabulazioni definite nella matrice
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.
| Valore | Significato |
|---|---|
|
Scheda normale |
|
Scheda Al centro |
|
Scheda allineata a destra |
|
Scheda Decimal |
|
Scheda Barra delle parole (barra verticale) |
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.
| Valore | Significato |
|---|---|
|
Nessun leader |
|
Leader punteggiato |
|
Leader tratteggiato |
|
Leader sottolineato |
|
Linea linea spessa |
|
Linea doppia |
dySpaceBefore
Tipo: LONG
Dimensione della spaziatura sopra il paragrafo, in twip. Per utilizzare questo membro, impostare il flag di PFM_SPACEBEFORE nel membro dwMask
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
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 di spaziatura linea. Per usare questo membro, impostare il flag PFM_LINESPACING nel membro dwMask. Questo membro può essere uno dei valori seguenti.
bOutlineLevel
Riservato; deve essere zero.
wShadingWeight
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
wShadingStyle
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
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
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
wNumberingTab
Spazio minimo tra un numero di paragrafo e il testo del paragrafo, in twip. Utilizzare questo membro insieme al membro wNumbering. Il membro
wBorderSpace
Spazio tra il bordo e il testo del paragrafo, espresso in twip. Il membro wBorderSpace
wBorderWidth
Larghezza bordo, in twip. Per utilizzare questo membro, impostare il flag di PFM_BORDER nel membro dwMask
wBorders
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
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| intestazione |
richedit.h |