SetStructElemColor

Tagged PDF, Dostępność

Opis

Ustawia atrybut /Color (właściciel atrybutów Layout) w elemencie struktury aktualnie otwartym na stosie tagów. Wartość określa kolor pierwszego planu (tekstu lub obrysu) zawartości elementu jako trójkę RGB. Odpowiada wywołaniu AddTagAttribute z Owner=Layout, Name=Color i rozdzielonym spacjami ciągiem R G B

Składnia

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

Parametry

R	Składowa czerwona koloru w zakresie od 0.0 (bez czerwieni) do 1.0 (pełna czerwień)
G	Składowa zielona koloru w zakresie od 0.0 do 1.0
B	Składowa niebieska koloru w zakresie od 0.0 do 1.0

Wartość zwracana

Zwraca 1 w przypadku powodzenia. Zwraca 0, jeżeli żaden dokument nie jest otwarty albo stos znaczników nie zawiera obecnie otwartego znacznika

Uwagi

Wywołaj tę funkcję po BeginTag lub BeginTagEx, a przed EndTag. Atrybut /Color zdefiniowano w ISO 32000-1 §14.8.5.4.2 (właściciel atrybutów Layout, tabela 340) i jest przechowywany jako trzyelementowa tablica liczb PDF

Ten atrybut opisuje kolor pierwszego planu elementu postrzegany przez technologię asystującą lub mechanizm zmiany układu. Ma charakter informacyjny — kolor wizualny renderowany w pliku PDF jest kontrolowany przez stan grafiki, a nie przez ten atrybut. Podanie dokładnych informacji o kolorze umożliwia jednak narzędziom końcowym sprawdzanie współczynników kontrastu kolorów (kryterium sukcesu WCAG 2.x 1.4.3) i zachowanie wierności podczas zmiany układu zawartości

Typowe wartości kolorów: czarny = (0.0, 0.0, 0.0); biały = (1.0, 1.0, 1.0); czerwony = (1.0, 0.0, 0.0)

Przykład

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

Zobacz również

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag