Struttura PARAFORMAT (richedit.h)

  • Articolo

Contiene informazioni sugli attributi di formattazione di paragrafo in un controllo di modifica rtf. Questa struttura viene usata con i messaggi EM_GETPARAFORMAT e EM_SETPARAFORMAT .

In Microsoft Rich Edit 2.0 la struttura PARAFORMAT2 è un'estensione 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;

Members

cbSize

Tipo: UINT

Dimensioni della struttura, in byte. Il membro deve essere compilato prima di passare al controllo rich edit.

dwMask

Tipo: DWORD

Membri contenenti informazioni o attributi validi da impostare. Questo parametro può essere nessuno 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 sono validi.

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. Riservati; il valore deve essere zero.

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

Valore Significato
0
 Visualizza il testo utilizzando l'ordine di lettura da sinistra a destra. Questo è il valore predefinito.
PFE_RLTPARA
 Visualizza il testo utilizzando 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

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

dxOffset

Tipo: LONG

Rientro della seconda e delle righe successive 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 su una tabulazione. I 24 bit di ordine basso specificano l'offset assoluto, espresso in twip. Per usare questo membro, impostare il flag PFM_TABSTOPS nel membro dwMask .

Rich Edit 2.0: Per la 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 avanzata del controllo di modifica 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 Word (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 rich edit.

Valore Significato
0
 Nessun leader
1
 Leader punteggiato
2
 Leader tratteggiato
3
 Leader sottolineato
4
 Capo linea spessa
5
 Capo linea doppia

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione richedit.h

Vedi anche

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT2

Riferimento