Struttura PARAFORMAT (richedit.h)

Contiene informazioni sugli attributi di formattazione dei paragrafi in un controllo di modifica avanzato. Questa struttura viene utilizzata con i messaggi EM_GETPARAFORMAT e EM_SETPARAFORMAT.

In Microsoft Rich Edit 2.0 la struttura PARAFORMAT2 è un'estensione di Microsoft Rich Edit 2.0 della struttura PARAFORMAT . Microsoft Rich Edit 2.0 consente di usare entrambe le strutture con EM_GETPARAFORMAT e EM_SETPARAFORMAT.

Sintassi

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;

Membri

cbSize

Tipo: UINT

Dimensioni della struttura, in byte. Il membro deve essere riempito prima di passare al controllo di modifica rtf.

dwMask

Tipo: DWORD

Membri contenenti informazioni o attributi validi da impostare. Questo parametro può essere none o una combinazione dei valori seguenti. Se vengono specificati sia PFM_STARTINDENT che PFM_OFFSETINDENT, PFM_STARTINDENT ha la precedenza.

Valore	Significato
PFM_ALIGNMENT	Il membro wAlignment è valido.
PFM_NUMBERING	Il membro wNumbering è valido.
PFM_OFFSET	Il membro dxOffset è valido.
PFM_OFFSETINDENT	Il membro dxStartIndent è valido e specifica un valore relativo.
PFM_RIGHTINDENT	Il membro dxRightIndent è valido.
PFM_RTLPARA	Rich Edit 2.0: Il membro wEffects è valido
PFM_STARTINDENT	Il membro dxStartIndent è valido.
PFM_TABSTOPS	I membri cTabStobs e rgxTabStops.

wNumbering

Tipo: WORD

Valore che specifica le opzioni di numerazione. Questo membro può essere zero o PFN_BULLET.

wReserved

Tipo: WORD

Rich Edit 1.0:: questo membro è denominato wReserved. Riservato; il valore deve essere zero.

Rich Edit 2.0: Questo membro è denominato wEffects. Flag di bit che specifica un effetto paragrafo. È incluso solo per compatibilità con le interfacce TOM; Il controllo rich edit archivia il valore, ma non lo usa per visualizzare il testo. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
0	Visualizza il testo usando l'ordine di lettura da sinistra a destra. Si tratta dell'impostazione predefinita.
PFE_RLTPARA	Visualizza il testo usando l'ordine di lettura da destra a sinistra.

wEffects

dxStartIndent

Tipo: LONG

Rientro della prima riga del paragrafo, in twip. Se viene impostata la formattazione del paragrafo e PFM_OFFSETINDENT viene specificato, questo membro viene considerato come un valore relativo aggiunto al rientro iniziale di ogni paragrafo interessato.

dxRightIndent

Tipo: LONG

Dimensione, del rientro destro rispetto al margine destro, in twip.

dxOffset

Tipo: LONG

Rientro delle seconde e successive righe di un paragrafo rispetto al rientro iniziale, in twip. La prima riga viene rientrata se questo membro è negativo o rientrato se questo membro è positivo.

wAlignment

Tipo: WORD

Valore che specifica l'allineamento del paragrafo. Questo membro può essere uno dei valori seguenti.

Valore	Significato
PFA_CENTER	I paragrafi sono centrati.
PFA_LEFT	I paragrafi sono allineati al margine sinistro.
PFA_RIGHT	I paragrafi sono allineati al margine destro.

cTabCount

Tipo: SHORT

Numero di tabulazioni.

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
0	Scheda normale
1	Scheda Al centro
2	Scheda allineata a destra
3	Scheda Decimal
4	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
0	Nessun leader
1	Leader punteggiato
2	Leader tratteggiato
3	Leader sottolineato
4	Linea linea spessa
5	Linea doppia

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

PARAFORMAT2

riferimento