BeginTagEx2

Tagget PDF & tilgjengelighet

Beskrivelse

Åpner et nytt strukturelement og skyver det på tag-stakken, og setter alle hovedelementegenskapene i ett kall. BeginTagEx2 er en bekvemmelighets-wrapper for BeginTagEx etterfulgt av SetStructElemTitle, SetStructElemID og SetStructElemExpansion. Å sende en tom streng for en av Title, ElemID eller Expansion hopper over den tilsvarende setteren; de andre parameterne oppfører seg identisk med BeginTagEx

Bruk BeginTagEx2 når du allerede kjenner alle de beskrivende egenskapene til et element når du åpner det, for å unngå flere etterfølgende setter-kall. Hvis en egenskap bestemmes senere (for eksempel at AltText kommer asynkront), bruk BeginTag eller BeginTagEx og kall de enkelte setterne etterpå

Syntaks

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

Parametere

TagType	Strukturelement-typenavnet, f.eks. `Figure`, `Table`, `Span`, `P`. De samme typene godtas av BeginTag
AltText	Alternativ tekst skrevet til /Alt-oppføringen (ISO 32000-1 §14.9.3). Oppgi en tom streng for å utelate
ActualText	Faktisk tekst skrevet til /ActualText-oppføringen (ISO 32000-1 §14.9.4). Oppgi en tom streng for å utelate
Lang	BCP 47-språktagg skrevet til /Lang-oppføringen (ISO 32000-1 §14.9.2), f.eks. `en-US`, `fr`, `zh-Hant-TW`. Oppgi en tom streng for å arve dokumentspråket
Title	Menneskelesbar etikett skrevet til /T-oppføringen (ISO 32000-1 §14.7.2). Vises i taggnavigasjonspanelet. Oppgi en tom streng for å utelate
ElemID	Unik elementidentifikator skrevet til /ID-oppføringen (ISO 32000-1 §14.7.4). Må være unik i dokumentet hvis den settes. Oppgi en tom streng for å utelate
Expansion	Utvidelse av en forkortelse eller et akronym skrevet til /E-oppføringen (ISO 32000-1 §14.9.5). Oppgi en tom streng for å utelate

Returverdi

Returnerer 1 ved suksess, 0 hvis ingen dokument er valgt

Merknader

Kall EndTag én gang for hvert vellykket BeginTagEx2-kall for å poppe elementet fra tag-stakken. Strukturelementer kan nestes: å kalle BeginTagEx2 mens et annet element står åpent, oppretter et underelement

Den interne implementasjonen er nøyaktig ekvivalent med:

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

Individuelle settere forblir tilgjengelige for egenskaper bestemt etter at elementet er åpnet, eller for egenskaper som ikke dekkes av BeginTagEx2 (slik som AddTagAttribute for tabellcelle-attributter)

Eksempel

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

Se også

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion