struktur PARAFORMAT2 (richedit.h)

Berisi informasi tentang atribut pemformatan paragraf dalam kontrol edit yang kaya. PARAFORMAT2 adalah ekstensi Microsoft Rich Edit 2.0 dari struktur PARAFORMAT. Microsoft Rich Edit 2.0 memungkinkan Anda menggunakan salah satu struktur dengan pesan EM_GETPARAFORMAT dan EM_SETPARAFORMAT.

Sintaksis

struct PARAFORMAT2 : _paraformat {
  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;
};

Warisan

Struktur PARAFORMAT2 mengimplementasikan _paraformat.

Anggota

dySpaceBefore

Jenis: LONG

Ukuran penspasian di atas paragraf, dalam twips. Untuk menggunakan anggota ini, atur bendera PFM_SPACEBEFORE di anggota dwMask. Nilai harus lebih besar dari atau sama dengan nol.

dySpaceAfter

Jenis: LONG

Menentukan ukuran penspasian di bawah paragraf, dalam twips. Untuk menggunakan anggota ini, atur bendera PFM_SPACEAFTER di dwMask anggota. Nilai harus lebih besar dari atau sama dengan nol.

dyLineSpacing

Jenis: LONG

Penspasian antarbaris. Untuk deskripsi tentang bagaimana nilai ini ditafsirkan, lihat anggota bLineSpacingRule. Untuk menggunakan anggota ini, atur bendera PFM_LINESPACING di dwMask anggota.

sStyle

Jenis: SHORT

Gaya teks. Untuk menggunakan anggota ini, atur bendera PFM_STYLE di dwMask anggota. Anggota ini hanya disertakan untuk kompatibilitas dengan antarmuka TOM dan Word; kontrol edit kaya menyimpan nilai tetapi tidak menggunakannya untuk menampilkan teks.

bLineSpacingRule

Jenis: BYTE

Jenis penspasian baris. Untuk menggunakan anggota ini, atur bendera PFM_LINESPACING di dwMask anggota. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
0	Penspasian tunggal. Anggota dyLineSpacing diabaikan.
1	Penspasian satu setengah. Anggota dyLineSpacing diabaikan.
2	Penspasian ganda. Anggota dyLineSpacing diabaikan.
3	Anggota dyLineSpacing menentukan spasidari satu baris ke baris berikutnya, dalam twips. Namun, jika dyLineSpacing menentukan nilai yang kurang dari spasi tunggal, kontrol akan menampilkan teks berspasi tunggal.
4	Anggota dyLineSpacing menentukan penspasian dari satu baris ke baris berikutnya, dalam twips. Kontrol menggunakan penspasian yang tepat yang ditentukan, bahkan jika dyLineSpacing menentukan nilai yang kurang dari spasi tunggal.
5	Nilai dyLineSpacing / 20 adalah penspasian, dalam baris, dari satu baris ke baris berikutnya. Dengan demikian, pengaturan dyLineSpacing ke 20 menghasilkan teks spasi tunggal, 40 di-spasi ganda, 60 berjarak tiga kali lipat, dan sebagainya.

bOutlineLevel

Jenis: BYTE

Dipesan; harus nol.

wShadingWeight

Jenis: WORD

Persentase warna latar depan yang digunakan dalam bayangan. Anggota wShadingStyle menentukan warna bayangan latar depan dan latar belakang. Nilai 5 menunjukkan warna bayangan yang terdiri dari 5 persen warna latar depan dan warna latar belakang 95 persen. Untuk menggunakan anggota ini, atur bendera PFM_SHADING di anggota dwMask . Anggota ini hanya disertakan untuk kompatibilitas dengan Word; kontrol edit kaya menyimpan nilai tetapi tidak menggunakannya untuk menampilkan teks.

wShadingStyle

Jenis: WORD

Gaya dan warna yang digunakan untuk bayangan latar belakang. Bit 0 hingga 3 berisi gaya bayangan, bit 4 hingga 7 berisi indeks warna latar depan, dan bit 8 hingga 11 berisi indeks warna latar belakang. Untuk menggunakan anggota ini, atur bendera PFM_SHADING di dwMask anggota. Anggota ini hanya disertakan untuk kompatibilitas dengan Word; kontrol edit kaya menyimpan nilai tetapi tidak menggunakannya untuk menampilkan teks.

Gaya bayangan bisa menjadi salah satu nilai berikut.

Nilai	Arti
0	Tidak
1	Horizontal gelap
2	Vertikal gelap
3	Diagonal gelap
4	Diagonal gelap
5	Kisi gelap
6	Terali gelap
7	Horizontal terang
8	Vertikal terang
9	Diagonal ringan
10	Menerangi diagonal
11	Kisi cahaya
12	Teralis cahaya

 

Indeks warna latar depan dan latar belakang bisa menjadi salah satu nilai berikut.

Nilai	Arti
0	Hitam
1	Biru
2	Cyan
3	Hijau
4	Magenta
5	Merah
6	Kuning
7	Putih
8	Biru tua
9	Cyan gelap
10	Hijau tua
11	Magenta gelap
12	Merah tua
13	Kuning tua
14	Abu-abu tua
15	Abu-abu muda

wNumberingStart

Jenis: WORD

Nilai nomor awal atau Unicode yang digunakan untuk paragraf bernomor. Gunakan anggota ini bersama dengan anggota wNumbering. Anggota ini hanya disertakan untuk kompatibilitas dengan antarmuka TOM; kontrol edit kaya menyimpan nilai tetapi tidak menggunakannya untuk menampilkan teks atau poin. Untuk menggunakan anggota ini, atur bendera PFM_NUMBERINGSTART di anggota dwMask.

wNumberingStyle

Jenis: WORD

Gaya penomoran yang digunakan dengan paragraf bernomor. Gunakan anggota ini bersama dengan anggota wNumbering. Anggota ini hanya disertakan untuk kompatibilitas dengan antarmuka TOM; kontrol edit kaya menyimpan nilai tetapi versi edit kaya yang lebih lama dari 3.0 tidak menggunakannya untuk menampilkan teks atau poin. Untuk menggunakan anggota ini, atur bendera PFM_NUMBERINGSTYLE di anggota dwMask. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
PFNS_PAREN	Mengikuti angka dengan tanda kurung yang tepat.
PFNS_PARENS	Mengapit angka dalam tanda kurung.
PFNS_PERIOD	Mengikuti angka dengan titik.
PFNS_PLAIN	Hanya menampilkan angka.
PFNS_NONUMBER	Melanjutkan daftar bernomor tanpa menerapkan angka atau poin berikutnya.
PFNS_NEWNUMBER	Memulai nomor baru dengan wNumberingStart.

wNumberingTab

Jenis: WORD

Spasi minimum antara nomor paragraf dan teks paragraf, dalam twips. Gunakan anggota ini bersama dengan anggota wNumbering. Anggota wNumberingTab disertakan untuk kompatibilitas dengan antarmuka TOM; sebelumnya untuk Microsoft Rich Edit 3.0, kontrol edit kaya menyimpan nilai tetapi tidak menggunakannya untuk menampilkan teks. Untuk menggunakan anggota ini, atur bendera PFM_NUMBERINGTAB di anggota dwMask.

wBorderSpace

Jenis: WORD

Spasi antara batas dan teks paragraf, dalam twips. Anggota wBorderSpace disertakan untuk kompatibilitas dengan Word; kontrol edit kaya menyimpan nilai tetapi tidak menggunakannya untuk menampilkan teks. Untuk menggunakan anggota ini, atur bendera PFM_BORDER di anggota dwMask .

wBorderWidth

Jenis: WORD

Lebar batas, dalam twips. Untuk menggunakan anggota ini, atur bendera PFM_BORDER di anggota dwMask .

wBorders

Jenis: WORD

Lokasi, gaya, dan warna batas. Bit 0 hingga 7 menentukan lokasi batas, bit 8 hingga 11 menentukan gaya batas, dan bit 12 hingga 15 menentukan indeks warna batas. Untuk menggunakan anggota ini, atur bendera PFM_BORDER di anggota dwMask .

Tentukan lokasi batas menggunakan kombinasi nilai berikut dalam bit 0 hingga 7.

Nilai	Arti
1	Batas kiri.
2	Perbatasan kanan.
4	Batas atas.
8	Batas bawah.
16	Di dalam perbatasan.
32	Di luar perbatasan.
64	Warnai otomatis. Jika bit ini diatur, indeks warna dalam bit 12 hingga 15 tidak digunakan.

 

Tentukan gaya batas menggunakan salah satu nilai berikut untuk bit 8 hingga 11.

Nilai	Arti
0	Tidak
1	3/4 titik
2	1 titik 112
3	2 titik1/4
4	3 poin
5	41/2 titik
6	6 poin
7	3/4 titik ganda
8	11/2 titik ganda
9	21/4 titik ganda
10	3/4 titik abu-abu
11	3/4 titik garis putus-putus abu-abu

 

Tentukan warna batas menggunakan salah satu nilai berikut untuk bit 12 hingga 15. Nilai ini diabaikan jika bit autocolor (bit 6) diatur.

Nilai	Arti
0	Hitam
1	Biru
2	Cyan
3	Hijau
4	Magenta
5	Merah
6	Kuning
7	Putih
8	Biru tua
9	Cyan gelap
10	Hijau tua
11	Magenta gelap
12	Merah tua
13	Kuning tua
14	Abu-abu tua
15	Abu-abu muda

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

PARAFORMAT