BeginMarkedContent
PDF z tagami, dostępność
Opis
Otwiera zakres zawartości oznaczonej w bieżącym strumieniu zawartości przez zapisanie operatora BDC (Begin Marked Content with Property List). Służy zwykle do tworzenia ustrukturyzowanych plików PDF (z tagami), spełniających wymagania dostępności (takie jak PDF/UA)Zakresy zawartości oznaczonej muszą być prawidłowo zrównoważone: każde wywołanie
BeginMarkedContent musi zostać zamknięte odpowiadającym wywołaniem EndMarkedContent. Zakresy zawartości oznaczonej mogą być zagnieżdżane
Składnia
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;Parametry
| TagType | Nazwa tagu strukturalnego, np. /Span, /P, /Figure itd. |
|---|---|
| AltText | Alternatywny tekst opisowy dla dostępności (mapowany na klucz /Alt w liście właściwości). Przekaż pusty łańcuch, jeśli niepotrzebny. |
| ActualText | Tekst rzeczywisty zastępujący reprezentację glifów dla czytników ekranu (mapowany na klucz /ActualText). Przekaż pusty łańcuch, jeśli niepotrzebny. |
| Lang | Kod języka naturalnego dla zawartości oznaczonej (np. en-US, mapowany na klucz /Lang). Przekaż pusty łańcuch, jeśli niepotrzebny. |
| Expansion | Tekst rozwinięcia dla skrótów lub akronimów (mapowany na klucz /E). Przekaż pusty łańcuch, jeśli niepotrzebny. |
Wartości zwracane
| 0 | Brak otwartego dokumentu albo nie udało się zapisać zawartości oznaczonej. |
|---|---|
| 1 | Zakres zawartości oznaczonej otwarty pomyślnie. |
Uwagi
Aby budować zgodne pliki Tagged PDF/UA, upewnij się, że tagi struktury logicznej obejmują cały widoczny tekst i grafikę. W porównaniu z BeginTag ta funkcja oferuje szczegółowe mapowanie właściwości
Przykład
// Heading, then a paragraph with marked content span
PDF.NewDocument;
PDF.AddPage;
PDF.BeginMarkedContent('/Span', 'Logo description', '', 'en-US', '');
// Draw graphics or print text here
PDF.EndMarkedContent;