SetStructElemColor

PDF Terlabeli, Aksesibilitas

Deskripsi

Menetapkan atribut /Color (pemilik atribut Layout) pada elemen struktur yang saat ini terbuka di tag stack. Nilainya menentukan warna latar depan (teks atau stroke) dari konten elemen sebagai triplet RGB. Setara dengan memanggil AddTagAttribute dengan Owner=Layout, Name=Color, dan string R G B yang dipisahkan spasi.

Sintaks

Delphi

Function TPDFlib.SetStructElemColor(R, G, B: Double): Integer;

ActiveX

Function PDFlib::SetStructElemColor(R As Double, G As Double, B As Double) As Long

DLL

int DLSetStructElemColor(int InstanceID, double R, double G, double B);

Parameter

R	Komponen merah dari warna, dalam rentang 0.0 (tanpa merah) sampai 1.0 (merah penuh)
G	Komponen hijau dari warna, dalam rentang 0.0 sampai 1.0
B	Komponen biru dari warna, dalam rentang 0.0 sampai 1.0

Nilai kembali

Mengembalikan 1 jika sukses. Mengembalikan 0 jika tidak ada dokumen yang terbuka atau tidak ada tag yang sedang terbuka di tag stack

Catatan

Panggil fungsi ini setelah BeginTag atau BeginTagEx dan sebelum EndTag. Attribute /Color didefinisikan di ISO 32000-1 §14.8.5.4.2 (owner attribute Layout, Table 340) dan disimpan sebagai PDF array tiga elemen berisi angka

Attribute ini mendeskripsikan warna foreground elemen sebagaimana dipersepsi teknologi assistive atau engine re-flow. Sifatnya saran — warna visual yang dirender di PDF dikendalikan graphics state, bukan oleh attribute ini. Namun menyediakan informasi warna yang akurat memungkinkan tool hilir memeriksa rasio kontras warna (WCAG 2.x Success Criterion 1.4.3) dan menjaga fidelitas saat me-reflow konten

Nilai warna yang umum: hitam = (0.0, 0.0, 0.0); putih = (1.0, 1.0, 1.0); merah = (1.0, 0.0, 0.0)

Contoh

// Tag a heading rendered in dark blue
PDFlib.BeginTag('H2', '', '', '');
PDFlib.SetStructElemColor(0.0, 0.18, 0.39);  // RGB for dark blue
PDFlib.DrawText('Section 2', 72, 700);
PDFlib.EndTag;

Lihat juga

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag