BeginTagEx2

pažymėtasis PDF ir prieinamumas

Aprašymas

Atveria naują struktūros elementą ir jį įstumia į žymų dėklį, vienu kvietimu nustatydamas visas pagrindines elemento savybes. BeginTagEx2 – patogusis BeginTagEx apvyniojimas, po kurio seka SetStructElemTitle, SetStructElemID ir SetStructElemExpansion. Perdavus tuščiąją eilutę bet kuriam iš Title, ElemID arba Expansion, atitinkamasis nustatytojas praleidžiamas; kiti parametrai elgiasi identiškai BeginTagEx

Naudokite BeginTagEx2, kai atverdami elementą jau žinote visas jo aprašomąsias savybes, kad išvengtumėte kelių iš eilės einančių nustatytojų kvietimų. Jei kuri nors savybė nustatoma vėliau (pavyzdžiui, AltText atkeliauja asinchroniškai), naudokite BeginTag arba BeginTagEx, o atskiruosius nustatytojus iškvieskite vėliau

Sintaksė

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

Parametrai

TagType	Struktūros elemento tipo pavadinimas, pvz., `Figure`, `Table`, `Span`, `P`. Tie patys tipai, kuriuos priima BeginTag
AltText	Alternatyvusis tekstas, įrašomas į /Alt elementą (ISO 32000-1 §14.9.3) Norėdami praleisti, perduokite tuščią eilutę
ActualText	Faktinis tekstas, įrašomas į /ActualText elementą (ISO 32000-1 §14.9.4) Norėdami praleisti, perduokite tuščią eilutę
Lang	BCP 47 kalbos žyma, rašoma į /Lang įrašą (ISO 32000-1 §14.9.2), pvz., `en-US`, `fr`, `zh-Hant-TW`. Norėdami paveldėti dokumento kalbą, perduokite tuščią eilutę.
Title	Žmogui skaitoma etiketė, rašoma į /T įrašą (ISO 32000-1 §14.7.2). Rodoma žymų naršymo skydelyje. Norėdami praleisti, perduokite tuščią eilutę.
ElemID	Unikalus elemento identifikatorius, rašomas į /ID įrašą (ISO 32000-1 §14.7.4). Jei nustatytas, turi būti unikalus dokumente. Norėdami praleisti, perduokite tuščią eilutę.
Expansion	Santrumpės ar akronimo išplėtimas, rašomas į /E įrašą (ISO 32000-1 §14.9.5). Norėdami praleisti, perduokite tuščią eilutę.

Grąžinama reikšmė

Grąžina 1 sėkmės atveju, 0, jei nepasirinktas joks dokumentas

Pastabos

Kiekvienam sėkmingam BeginTagEx2 kvietimui iškvieskite EndTag vienąkart, kad elementas būtų išimtas iš žymų dėkelio. Struktūros elementai gali būti įdėti: iškvietus BeginTagEx2, kol kitas elementas atviras, sukuriamas antrinis elementas

Vidinis įgyvendinimas visiškai atitinka:

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

Atskirieji nustatytojai lieka prieinami savybėms, nustatomoms po elemento atvėrimo, arba savybėms, kurių BeginTagEx2 nedengia (tokios kaip AddTagAttribute lentelės langelių atributams)

Pavyzdys

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

Taip pat žiūrėkite

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion