BeginTagEx2

PDF Terlabeli & Aksesibilitas

Deskripsi

Membuka structure element baru dan mendorongnya ke tag stack, mengeset semua property utama elemen dalam satu panggilan. BeginTagEx2 adalah wrapper praktis untuk BeginTagEx diikuti SetStructElemTitle, SetStructElemID, dan SetStructElemExpansion. Memberikan string kosong untuk salah satu Title, ElemID, atau Expansion melewati setter terkait; parameter lain berperilaku identik dengan BeginTagEx

Gunakan BeginTagEx2 saat Anda sudah mengetahui semua property deskriptif elemen pada saat membukanya, untuk menghindari beberapa panggilan setter beruntun. Jika ada property yang ditentukan belakangan (misalnya AltText datang secara asinkron), gunakan BeginTag atau BeginTagEx dan panggil setter terpisahnya setelahnya

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

Parameter

TagType	Nama tipe structure element, mis. `Figure`, `Table`, `Span`, `P`. Tipe yang sama yang diterima BeginTag
AltText	Teks alternatif yang ditulis ke entri /Alt (ISO 32000-1 §14.9.3). Berikan string kosong untuk menghilangkannya
ActualText	Teks aktual yang ditulis ke entri /ActualText (ISO 32000-1 §14.9.4). Berikan string kosong untuk menghilangkannya
Lang	Language tag BCP 47 yang ditulis ke entri /Lang (ISO 32000-1 §14.9.2), mis. `en-US`, `fr`, `zh-Hant-TW`. Berikan string kosong untuk mewarisi bahasa dokumen
Title	Label yang mudah dibaca manusia dan ditulis ke entri /T (ISO 32000-1 §14.7.2). Ditampilkan di panel navigasi Tags. Berikan string kosong untuk menghilangkannya
ElemID	Identifier elemen unik yang ditulis ke entri /ID (ISO 32000-1 §14.7.4). Harus unik di dalam dokumen bila diset. Berikan string kosong untuk menghilangkannya
Expansion	Ekspansi singkatan atau akronim yang ditulis ke entri /E (ISO 32000-1 §14.9.5). Berikan string kosong untuk menghilangkannya

Nilai kembali

Mengembalikan 1 jika sukses, 0 jika tidak ada dokumen terpilih

Catatan

Panggil EndTag sekali untuk setiap panggilan BeginTagEx2 yang berhasil untuk meng-pop elemen dari tag stack. Structure element boleh bersarang: memanggil BeginTagEx2 saat elemen lain terbuka membuat elemen anak

Implementasi internalnya persis sama dengan:

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

Setter terpisah tetap tersedia untuk property yang ditentukan setelah elemen dibuka, atau untuk property yang tidak tercakup BeginTagEx2 (seperti AddTagAttribute untuk attribute cell tabel)

Contoh

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

Lihat juga

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion