Struktur PARAFORMAT (richedit.h)

Berisi informasi tentang atribut pemformatan paragraf dalam kontrol edit yang kaya. Struktur ini digunakan dengan pesan EM_GETPARAFORMAT dan EM_SETPARAFORMAT.

Di Microsoft Rich Edit 2.0, struktur PARAFORMAT2 adalah ekstensi Microsoft Rich Edit 2.0 dari struktur PARAFORMAT. Microsoft Rich Edit 2.0 memungkinkan Anda menggunakan salah satu struktur dengan EM_GETPARAFORMAT dan EM_SETPARAFORMAT.

Sintaksis

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;

Anggota

cbSize

Jenis: UINT

Ukuran struktur, dalam byte. Anggota harus diisi sebelum meneruskan ke kontrol edit kaya.

dwMask

Jenis: DWORD

Anggota yang berisi informasi atau atribut yang valid untuk diatur. Parameter ini tidak boleh ada atau kombinasi dari nilai berikut. Jika PFM_STARTINDENT dan PFM_OFFSETINDENT ditentukan, PFM_STARTINDENT diutamakan.

Nilai	Arti
PFM_ALIGNMENT	Anggota wAlignment valid.
PFM_NUMBERING	Anggota wNumbering valid.
PFM_OFFSET	Anggota dxOffset valid.
PFM_OFFSETINDENT	Anggota dxStartIndent valid dan menentukan nilai relatif.
PFM_RIGHTINDENT	Anggota dxRightIndent valid.
PFM_RTLPARA	Rich Edit 2.0: Anggota wEffects valid
PFM_STARTINDENT	Anggota dxStartIndent valid.
PFM_TABSTOPS	cTabStobs dan rgxTabStops anggota valid.

wNumbering

Jenis: WORD

Nilai yang menentukan opsi penomoran. Anggota ini bisa nol atau PFN_BULLET.

wReserved

Jenis: WORD

Rich Edit 1.0:: Anggota ini bernama wReserved. Dipesan; nilainya harus nol.

Rich Edit 2.0: Anggota ini diberi nama wEffects. Bendera bit yang menentukan efek paragraf. Ini hanya disertakan untuk kompatibilitas dengan antarmuka TOM; kontrol edit kaya menyimpan nilai tetapi tidak menggunakannya untuk menampilkan teks. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
0	Menampilkan teks menggunakan urutan baca kiri-ke-kanan. Ini adalah default.
PFE_RLTPARA	Menampilkan teks menggunakan urutan baca kanan-ke-kiri.

wEffects

dxStartIndent

Jenis: LONG

Indentasi baris pertama dalam paragraf, dalam twips. Jika pemformatan paragraf sedang diatur dan PFM_OFFSETINDENT ditentukan, anggota ini diperlakukan sebagai nilai relatif yang ditambahkan ke indentasi awal setiap paragraf yang terpengaruh.

dxRightIndent

Jenis: LONG

Ukuran, dari indentasi kanan relatif terhadap margin kanan, dalam twips.

dxOffset

Jenis: LONG

Indentasi baris kedua dan berikutnya dari paragraf yang relatif terhadap indentasi awal, dalam twips. Baris pertama diindentasi jika anggota ini negatif atau outdented jika anggota ini positif.

wAlignment

Jenis: WORD

Nilai yang menentukan perataan paragraf. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
PFA_CENTER	Paragraf dipusatkan.
PFA_LEFT	Paragraf diratakan dengan margin kiri.
PFA_RIGHT	Paragraf diratakan dengan margin kanan.

cTabCount

Jenis: SHORT

Jumlah perhentian tab.

rgxTabs[MAX_TAB_STOPS]

Jenis: LONG

Array posisi berhenti tab absolut. Setiap elemen dalam array menentukan informasi tentang perhentian tab. 24 bit berurutan rendah menentukan offset absolut, dalam twips. Untuk menggunakan anggota ini, atur bendera PFM_TABSTOPS di dwMask anggota.

Rich Edit 2.0: Untuk kompatibilitas dengan antarmuka TOM, Anda dapat menggunakan delapan bit berurutan tinggi untuk menyimpan informasi tambahan tentang setiap perhentian tab.

Bit 24-27 dapat menentukan salah satu nilai berikut untuk menunjukkan perataan tab. Bit ini tidak memengaruhi tampilan kontrol edit kaya untuk versi yang lebih lama dari Microsoft Rich Edit 3.0.

Nilai	Arti
0	Tab biasa
1	Tab Tengah
2	Tab rata kanan
3	Tab Desimal
4	Tab bilah kata (bilah vertikal)

 

Bit 28-31 dapat menentukan salah satu nilai berikut untuk menunjukkan jenis pemandu tab. Bit ini tidak mempengaruhi tampilan kontrol edit yang kaya.

Nilai	Arti
0	Tidak ada pemimpin
1	Pemandu bertitik
2	Pemimpin putus-putus
3	Pemimpin bergaris bawah
4	Pemandu garis tebal
5	Pemandu garis ganda

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	richedit.h

Lihat juga

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT2

Referensi