SetStructElemColor

Etiketli PDF, Erişilebilirlik

Açıklama

Etiket yığınında o anda açık olan yapı öğesinde /Color özniteliğini (Layout öznitelik sahibi) ayarlar. Değer, öğe içeriğinin ön plan rengini (metin veya kontur) RGB üçlüsü olarak belirtir. AddTagAttribute işlevini Owner=Layout, Name=Color ve boşlukla ayrılmış R G B dizesiyle çağırmaya eşdeğerdir

Sözdizimi

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);

Parametreler

R	0.0 (kırmızı yok) ile 1.0 (tam kırmızı) aralığındaki kırmızı renk bileşeni
G	0.0 ile 1.0 aralığındaki rengin yeşil bileşeni
B	Rengin 0.0 ile 1.0 aralığındaki mavi bileşeni

Dönüş değeri

Başarıda 1 döndürür. Açık belge veya etiket yığınında açık etiket yoksa 0 döndürür

Açıklamalar

Bu işlevi BeginTag veya BeginTagEx çağrısından sonra ve EndTag çağrısından önce kullanın. /Color özniteliği ISO 32000-1 §14.8.5.4.2'de (Layout öznitelik sahibi, Table 340) tanımlanır ve üç öğeli bir PDF sayı dizisi olarak saklanır

Bu öznitelik, yardımcı teknoloji veya yeniden akış altyapısının algıladığı öğe ön plan rengini açıklar. Tavsiye niteliğindedir — PDF'de işlenen görsel renk bu öznitelikle değil grafik durumuyla denetlenir. Bununla birlikte doğru renk bilgisinin sağlanması, sonraki araçların renk karşıtlığı oranlarını denetlemesini (WCAG 2.x Başarı Ölçütü 1.4.3) ve içerik yeniden akıtılırken doğruluğu korumasını sağlar

Yaygın renk değerleri: siyah = (0.0, 0.0, 0.0); beyaz = (1.0, 1.0, 1.0); kırmızı = (1.0, 0.0, 0.0)

Örnek

// 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;

Ayrıca bkz

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag