BeginTagExA

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 BeginTagEx, 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 z jawnym atrybutem języka naturalnego. Działa identycznie jak BeginTag, lecz dodaje parametr Lang zapisywany w atrybucie /Lang elementu struktury.

Użyj tej funkcji dla zawartości w języku innym niż domyślny język dokumentu (ustawiony przez SetPDFUAMode lub SetDocumentLanguage). ISO 14289-1 §7.2 wymaga ustawienia atrybutu /Lang w każdym segmencie tekstu, który nie jest w podstawowym języku dokumentu.

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

Składnia

Delphi

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

DLL

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

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 (atrybut `/Alt`). Jeśli nie jest wymagany, przekaż pusty ciąg.
ActualText	Tekst zastępczy dla zawartości, której postać wizualna różni się od znaczenia logicznego (atrybut `/ActualText`). Jeśli nie jest wymagany, przekaż pusty ciąg.
Lang	Znacznik języka BCP 47 dla zawartości tego elementu, np. `en-US`, `fr-FR`, `zh-Hans`. Przekaż pusty ciąg, aby odziedziczyć język dokumentu. Wartość niepusta zastępuje język dokumentu dla tego elementu i wszystkich jego elementów potomnych.

Wartości zwracane

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

Przykład

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;