BeginTagEx2

PDF sa oznakama i pristupačnost

Opis

Otvara novi element strukture i stavlja ga na stek tagova, postavljajući sve glavne osobine elementa jednim pozivom. BeginTagEx2 je praktičan omotač za BeginTagEx pa SetStructElemTitle, SetStructElemID i SetStructElemExpansion. Prazan string za bilo koji od Title, ElemID ili Expansion preskače odgovarajući setter; ostali parametri rade identično kao u BeginTagEx

Koristite BeginTagEx2 kad već u trenutku otvaranja znate sve opisne osobine elementa, da izbegnete više uzastopnih poziva setera. Ako se neka osobina utvrđuje kasnije (na primer, AltText stiže asinhrono), koristite BeginTag ili BeginTagEx i pozovite pojedinačne setere posle

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 tipa strukturnog elementa, npr. `Figure`, `Table`, `Span`, `P`. Isti tipovi koje prihvata BeginTag
AltText	Alternativni tekst upisan u unos /Alt (ISO 32000-1 §14.9.3). Prosledite prazan string da ga izostavite.
ActualText	Stvarni tekst upisan u unos /ActualText (ISO 32000-1 §14.9.4). Prosledite prazan string da ga izostavite.
Lang	BCP 47 jezička oznaka upisana u unos /Lang (ISO 32000-1 §14.9.2), npr. `en-US`, `fr`, `zh-Hant-TW`. Prosledite prazan string da nasledi jezik dokumenta.
Title	Ljudima čitljiva oznaka upisana u unos /T (ISO 32000-1 §14.7.2). Prikazuje se u panelu navigacije oznaka. Prosledite prazan string da ga izostavite.
ElemID	Jedinstveni identifikator elementa upisan u unos /ID (ISO 32000-1 §14.7.4). Mora biti jedinstven u dokumentu ako je postavljen. Prosledite prazan string da ga izostavite.
Expansion	Razvijeni oblik skraćenice ili akronima upisan u unos /E (ISO 32000-1 §14.9.5). Prosledite prazan string da ga izostavite.

Povratna vrednost

Vraća 1 pri uspehu, 0 ako nije izabran dokument

Napomene

Pozovite EndTag jednom za svaki uspešan poziv BeginTagEx2 da skidnete element sa steka tagova. Elementi strukture mogu se ugneždavati: poziv BeginTagEx2 dok je drugi element otvoren pravi podelement

Interna implementacija je tačno ekvivalentna ovome:

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

Pojedinačni setter-i ostaju dostupni za svojstva koja se određuju nakon otvaranja elementa, ili za svojstva koja BeginTagEx2 ne pokriva (na primer AddTagAttribute za atribute ćelija tabele)

Primer

// 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đe

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion