BeginTagEx2

Označeni PDF, Dostopnost

Opis

Odpre nov strukturni element in ga potisne na sklad oznak, v enem klicu pa nastavi vse glavne lastnosti elementa. BeginTagEx2 je priročno ovitko za BeginTagEx, ki mu sledita SetStructElemTitle, SetStructElemID in SetStructElemExpansion. Prazen niz za kateri koli od Title, ElemID ali Expansion preskoči pripadajoči nastavljalnik; ostali parametri se obnašajo enako kot pri BeginTagEx

BeginTagEx2 uporabite, kadar ob odpiranju elementa že poznate vse njegove opisne lastnosti, da se izognete več zaporednim klicem nastavljalnikov. Če je katera koli lastnost določena pozneje (npr. AltText prispe asinhrono), uporabite BeginTag ali BeginTagEx in posamezne nastavljalnike pokličite pozneje

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	Ime vrste strukturnega elementa, npr. `Figure`, `Table`, `Span`, `P`. Iste vrste, ki jih sprejme BeginTag
AltText	nadomestno besedilo, zapisano v vnos /Alt (ISO 32000-1 §14.9.3). Za izpustitev podajte prazen niz
ActualText	dejansko besedilo, zapisano v vnos /ActualText (ISO 32000-1 §14.9.4). Za izpustitev podajte prazen niz
Lang	jezična oznaka BCP 47, zapisana v vnos /Lang (ISO 32000-1 §14.9.2), npr. `en-US`, `fr`, `zh-Hant-TW`. Za prevzem jezika dokumenta podajte prazen niz
Title	človeku razumljiva oznaka, zapisana v vnos /T (ISO 32000-1 §14.7.2). Prikazana v navigacijskem panelu Oznake. Za izpustitev podajte prazen niz
ElemID	enoznačni identifikator elementa, zapisan v vnos /ID (ISO 32000-1 §14.7.4). Če je nastavljen, mora biti znotraj dokumenta enoznačen. Za izpustitev podajte prazen niz
Expansion	razširitev okrajšave ali akronima, zapisana v vnos /E (ISO 32000-1 §14.9.5). Za izpustitev podajte prazen niz

Vrnjena vrednost

Vrne 1 ob uspehu, 0, kadar ni izbran dokument

Opombe

Za vsak uspešen klic BeginTagEx2 enkrat pokličite EndTag, da element vzamete s sklada oznak. Strukturni elementi se lahko gnezdijo: klic BeginTagEx2, medtem ko je odprt drug element, ustvari podrejeni element

Notranja izvedba je točno enakovredna:

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

Posamezni nastavljalniki ostanejo na voljo za lastnosti, določene šele potem, ko je element odprt, ali za lastnosti, ki jih BeginTagEx2 ne pokriva (npr. AddTagAttribute za atribute celic 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;

Glejte tudi

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion