BeginTagA

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 BeginTag, a argumenty ciągów są interpretowane przy użyciu bieżącej strony kodowej SetAnsiMode

Otwiera element struktury tagowanego pliku PDF na bieżącej stronie. Zapisuje operator BDC (Begin Marked Content with Dictionary) do strumienia zawartości i rejestruje element w drzewie struktury logicznej dokumentu. Drzewo struktury jest automatycznie finalizowane podczas zapisywania dokumentu.

Tagi muszą być zrównoważone: po każdym wywołaniu BeginTag musi nastąpić odpowiadające mu wywołanie EndTag. Tagi można zagnieżdżać.

Składnia

Delphi

Function DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;

DLL

int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText);

Parametry

TagType	Standardowy typ struktury PDF: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` itd. (zob. ISO 32000-1 §14.8.4).
AltText	Tekst alternatywny dla obrazów i innej zawartości nietekstowej (odwzorowywany na atrybut PDF `/Alt`). Jeśli nie jest wymagany, przekaż pusty ciąg.
ActualText	Tekst zastępczy dla zawartości, której reprezentacja wizualna różni się od znaczenia logicznego (odwzorowywany na atrybut PDF `/ActualText`). Jeśli nie jest wymagany, przekaż pusty ciąg.

Wartości zwracane

0	Niepowodzenie (żaden dokument nie jest otwarty)
1	Znacznik został pomyślnie otwarty

Przykład

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

Uwagi

Do zawartości dekoracyjnej (nagłówków i stopek stron, elementów tła), której czytniki ekranu nie powinny odczytywać, użyj BeginArtifact/EndArtifact.

Dokument musi być w trybie zapisu (utworzony lub otwarty do modyfikacji). Aby spełnić wymagania PDF/UA-1, przed tagowaniem wywołaj SetPDFUAMode.