BeginTagEx2

Označeni PDF & pristupačnost

Opis

Otvara novi strukturni element i gura ga na stog oznaka, postavljajući sva glavna svojstva elementa jednim pozivom. BeginTagEx2 je zgodni omotač za BeginTagEx nakon kojega slijede SetStructElemTitle, SetStructElemID i SetStructElemExpansion. Prazan niz znakova za bilo koji od Title, ElemID ili Expansion preskače odgovarajući postavljač; ostali se parametri ponašaju identično kao u BeginTagEx

Upotrijebite SetActionURL za zamjenu URI-ja primarne akcije, a AddActionNextWeb kada URI mora raditi nakon primarne akcije

Sintaksa

Delphi

Function TPDFlib.BeginTagEx2(Const TagType, AltText, ActualText, Lang, Title, ElemID, Expansion: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx2(TagType As String, AltText As String, ActualText As String, Lang As String, Title As String, ElemID As String, Expansion As String) As Long

DLL

int DLBeginTagEx2(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang, const wchar_t * Title, const wchar_t * ElemID, const wchar_t * Expansion);

Parametri

TagType	Naziv vrste strukturnog elementa, npr. `Figure`, `Table`, `Span`, `P`. Iste vrste koje prihvaća BeginTag
AltText	Alternativni tekst koji se upisuje u unos /Alt (ISO 32000-1 §14.9.3). Da biste izostavili unos, proslijedite prazan niz znakova.
ActualText	Stvarni tekst koji se upisuje u unos /ActualText (ISO 32000-1 §14.9.4). Da biste izostavili unos, proslijedite prazan niz znakova.
Lang	Jezična oznaka BCP 47 koja se upisuje u unos /Lang (ISO 32000-1 §14.9.2), npr. `en-US`, `fr`, `zh-Hant-TW`. Da biste naslijedili jezik dokumenta, proslijedite prazan niz znakova.
Title	Ljudima čitljiva oznaka koja se upisuje u unos /T (ISO 32000-1 §14.7.2). Prikazuje se u navigacijskom panelu oznaka. Da biste izostavili unos, proslijedite prazan niz znakova.
ElemID	Jedinstveni identifikator elementa koji se upisuje u unos /ID (ISO 32000-1 §14.7.4). Ako je postavljen, mora biti jedinstven u dokumentu. Da biste izostavili unos, proslijedite prazan niz znakova.
Expansion	Proširenje kratice ili akronima zapisano u unos /E (ISO 32000-1 §14.9.5). Za izostavljanje proslijedite prazan niz.

Povratna vrijednost

Vraća 1 pri uspjehu, 0 ako nije odabran dokument

Napomene

Nakon svakog uspješnog poziva BeginTagEx2 pozovite jednom EndTag da skinite element sa stoga oznaka. Strukturni elementi mogu se ugnježđivati: poziv BeginTagEx2 dok je drugi element otvoren stvara podređeni element

Interna implementacija točno je istovjetna ovome:

BeginTagEx(TagType, AltText, ActualText, Lang);
if Title <> '' then SetStructElemTitle(Title);
if ElemID <> '' then SetStructElemID(ElemID);
if Expansion <> '' then SetStructElemExpansion(Expansion);

Pojedinačni postavljači ostaju dostupni za svojstva određena nakon otvaranja elementa ili za svojstva koja BeginTagEx2 ne pokriva (poput AddTagAttribute za atribute ćelija tablice)

Primjer

// Tag a figure with all descriptive properties in one call
PDFlib.BeginTagEx2(
  'Figure',                              // TagType
  'Bar chart: Q1 120, Q2 145, Q3 98',   // AltText
  '',                                    // ActualText (not needed for images)
  '',                                    // Lang (inherit document language)
  'Figure 3: Quarterly Sales',           // Title
  'fig-quarterly-sales',                 // ElemID
  ''                                     // Expansion (not an abbreviation)
);
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

// Tag an acronym span with its expansion
PDFlib.BeginTagEx2(
  'Span',
  '',                                          // AltText
  '',                                          // ActualText
  '',                                          // Lang
  '',                                          // Title
  '',                                          // ElemID
  'World Wide Web Consortium'                  // Expansion
);
PDFlib.WriteText('W3C');
PDFlib.EndTag;

Vidi također

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion