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