SetAutoTagMode

Tagged PDF

Opis

Włącza znakowanie struktury wykonywane automatycznie przez zwykłe operacje rysowania

Składnia

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

Parametry

Mode	Maska bitowa: `1` znakuje tekst, `2` oznacza elementy stałe strony jako artefakty, `4` znakuje obrazy jako figury, `8` znakuje rysowane tabele, `15` wykonuje wszystkie cztery operacje, a `0` wyłącza ten tryb

Wartości zwracane

Mode	Tryb obowiązujący przed tym wywołaniem
0	Ta wartość jest zwracana również po podaniu trybu ujemnego, który zostaje odrzucony bez zmiany bieżącego trybu

Uwagi

Po włączeniu znakowania tekstu jest on znakowany jako akapit, a tekst narysowany bezpośrednio po wywołaniu RegisterHeading jest znakowany jako nagłówek danego poziomu. Po włączeniu oznaczania elementów stałych bieżące nagłówki i stopki są oznaczane jako artefakty, dzięki czemu czytnik je pomija zamiast odczytywać ten sam wiersz na każdej stronie

Po włączeniu znakowania figur narysowany obraz staje się figurą z opisem ustawionym przez RegisterFigure albo jest rysowany wewnątrz artefaktu układu, jeśli RegisterDecoration wskazuje, że nie niesie znaczenia

Po włączeniu znakowania tabel DrawTableRows przenosi tabelę, jej wiersze i komórki do drzewa struktury. Wiersze wskazane przez SetTableHeaderRowCount stają się komórkami nagłówkowymi

Włączenie tego trybu oznacza również dokument jako tagowany. Czytnik uznaje strukturę za nieobecną, dopóki nie ma tego oznaczenia, dlatego dokument z tagami, lecz bez oznaczenia, jest odczytywany tak, jakby w ogóle nie zawierał struktury

Automatyczne znakowanie nie działa wewnątrz tagu otwartego za pomocą BeginTag: gdy kod wywołujący sam opisuje strukturę, nic nie jest zagnieżdżane w otwartym przez niego elemencie. Znakowanie nigdy nie odbywa się również wewnątrz artefaktu, gdzie element struktury spowodowałby nieprawidłowość pliku, ani dla pustego tekstu, który czytnik odczytałby jako pustą pozycję

Tryb należy do instancji biblioteki, a nie do dokumentu

Przykład

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

Zobacz również

GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount