BeginTagEx2

PDF etichetat & Accesibilitate

Descriere

Deschide un element de structură nou și îl pune pe stiva de tag-uri, setând toate proprietățile principale ale elementului într-un singur apel. BeginTagEx2 este un wrapper de conveniență pentru BeginTagEx urmat de SetStructElemTitle, SetStructElemID și SetStructElemExpansion. Pasarea unui șir gol pentru oricare dintre Title, ElemID sau Expansion sare setter-ul corespunzător; ceilalți parametri se comportă identic cu BeginTagEx

Folosiți BeginTagEx2 când cunoașteți deja toate proprietățile descriptive ale unui element în momentul deschiderii lui, pentru a evita mai multe apeluri consecutive de setter. Dacă vreo proprietate este stabilită mai târziu (de exemplu, AltText-ul sosește asincron), folosiți BeginTag sau BeginTagEx și apelați setter-ii individuali după

Sintaxă

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	Numele tipului de element de structură, de exemplu `Figure`, `Table`, `Span`, `P`. Aceleași tipuri acceptate de BeginTag
AltText	Textul alternativ scris în intrarea /Alt (ISO 32000-1 §14.9.3). Transmiteți un șir vid pentru a o omite
ActualText	Textul efectiv scris în intrarea /ActualText (ISO 32000-1 §14.9.4). Transmiteți un șir vid pentru a o omite
Lang	Tag de limbă BCP 47 scris în intrarea /Lang (ISO 32000-1 §14.9.2), de ex. `en-US`, `fr`, `zh-Hant-TW`. Transmiteți un șir vid pentru a moșteni limba documentului
Title	Etichetă lizibilă scrisă în intrarea /T (ISO 32000-1 §14.7.2). Afișată în panoul de navigare Tags. Transmiteți un șir vid pentru a o omite
ElemID	Identificator unic de element scris în intrarea /ID (ISO 32000-1 §14.7.4). Trebuie să fie unic în document dacă este setat. Transmiteți un șir vid pentru a-l omite
Expansion	Expansiunea unei abrevieri sau acronime scrise în intrarea /E (ISO 32000-1 §14.9.5). Transmiteți un șir vid pentru a o omite

Valoare returnată

Returnează 1 în caz de succes, 0 dacă niciun document nu este selectat

Observații

Apelați EndTag o dată pentru fiecare apel reușit BeginTagEx2 pentru a scoate elementul din stiva de tag-uri. Elementele de structură pot fi imbricate: apelarea BeginTagEx2 cât timp alt element este deschis creează un element copil

Implementarea internă este exact echivalentă cu:

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

Setter-ii individuali rămân disponibili pentru proprietăți stabilite după deschiderea elementului sau pentru proprietăți neacoperite de BeginTagEx2 (precum AddTagAttribute pentru atributele celulelor de tabel)

Exemplu

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

Consultați și

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion