AddTagAttributeA

Tagged PDF, Dostępność

Opis

Końcowa litera A oznacza punkt wejścia DLL ANSI (char); powierzchnia ActiveX/COM udostępnia wyłącznie postać Unicode. Zachowanie jest identyczne jak w AddTagAttribute, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Dodaje nazwany atrybut do elementu struktury aktualnie tworzonego na stosie znaczników. Atrybut jest zapisywany jako słownik atrybutów PDF /A (lub tablica słowników) podczas zapisywania dokumentu. Wywołaj tę funkcję po BeginTag lub BeginTagEx, a przed EndTag.

Składnia

Delphi

Function DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;

DLL

int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * Value);

Parametry

Owner	Nazwa właściciela atrybutu zdefiniowana w ISO 32000-1, tabela 348 (np. `Layout`, `Table`, `List`, `PrintField`). Staje się kluczem `/O` w słowniku atrybutów.
Name	Nazwa atrybutu dla danego właściciela (np. `BBox` dla Layout, `Scope` dla Table). Nie może być pusta.
Value	Wartość atrybutu jako ciąg. Wartości zawierające wyłącznie liczby rozdzielone spacjami (np. `"0 0 200 100"`) są zapisywane jako tablica liczb rzeczywistych PDF. Każda inna wartość jest zapisywana jako obiekt nazwy PDF (bez początkowego `/`). Nie może być pusta.

Wartość zwracana

Zwraca 1 po powodzeniu. Zwraca 0, jeśli nie otwarto dokumentu, żaden znacznik nie jest obecnie otwarty albo Owner lub Name jest puste.

Uwagi

Wiele wywołań AddTagAttribute dla tego samego otwartego znacznika jest kumulowanych. Gdy atrybuty należą do jednego właściciela, biblioteka zapisuje pojedynczy słownik atrybutów /A. Gdy używanych jest wielu właścicieli, atrybuty są grupowane według właściciela i zapisywane jako tablica słowników atrybutów.

W przypadku typowych atrybutów wygodnych funkcji opakowujących SetStructElemScope i SetStructElemBBox można użyć zamiast bezpośredniego wywołania AddTagAttribute.

Atrybuty są resetowane po otwarciu nowego znacznika; elementy potomne ich nie dziedziczą

Przykład

// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;

// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;

Zobacz również

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox