BeginTagEx

Taggad PDF, tillgänglighet

Beskrivning

Öppnar ett taggat-PDF-strukturelement på den aktuella sidan, med ett explicit naturligt-språk-attribut. Identiskt med BeginTag men lägger till en Lang-parameter som skrivs till strukturelementets /Lang-attribut

Använd den här funktionen för innehåll vars språk skiljer sig från dokumentets standardspråk (satt av SetPDFUAMode eller SetDocumentLanguage). ISO 14289-1 §7.2 kräver att attributet /Lang sätts på varje textsegment som inte är på dokumentets primärspråk

Taggar måste balanseras: varje BeginTagEx-anrop måste följas av ett matchande EndTag-anrop. Taggar får nästlas

Syntax

Delphi

Function TPDFlib.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx(TagType As String, AltText As String, ActualText As String, Lang As String) As Long

DLL

int DLBeginTagEx(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang);

Parametrar

TagType	PDF standard structure type: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (see ISO 32000-1 §14.8.4).
AltText	Alternativ text för bilder och annat icke-textinnehåll (`/Alt`-attributet). Ange en tom sträng om den inte behövs
ActualText	Ersättningstext för innehåll vars visuella form skiljer sig från dess logiska betydelse (`/ActualText`-attributet). Ange en tom sträng om den inte behövs
Lang	BCP 47-språktagg för innehållet i det här elementet, t.ex. `en-US`, `fr-FR`, `zh-Hans`. Ange en tom sträng för att ärva dokumentspråket. När den inte är tom åsidosätter den dokumentnivåspråket för det här elementet och alla dess ättlingar

Returvärden

0	Misslyckades (inget dokument är öppet)
1	Tag opened successfully

Exempel

// 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;