BeginTagEx
標籤式 PDF、無障礙
描述
在目前頁面開啟標籤式 PDF 結構元素，並帶明確的自然語言屬性。與 BeginTag 相同，但多了 Lang 參數，會寫入結構元素的 /Lang 屬性。
內容語言與文件預設語言（由 SetPDFUAMode 或 SetDocumentLanguage 設定）不同時，請使用此函式。ISO 14289-1 §7.2 要求任何不在文件主要語言內的文字區段，都要設定 /Lang 屬性。
標籤必須配對：每次 BeginTagEx 之後都要有對應的 EndTag。標籤可以巢狀。
語法
Delphi
Function TPDFlib.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;ActiveX
Function PDFlib::BeginTagEx(TagType As String, AltText As String, ActualText As String, Lang As String) As LongDLL
int DLBeginTagEx(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang);參數
| TagType | PDF standard structure type: P, H1–H6, Figure, Table, TR, TH, TD, L, LI, LBody, Span, Link, Note, etc. (see ISO 32000-1 §14.8.4). |
|---|---|
| AltText | 影像與其他非文字內容的替代文字（/Alt 屬性）。不需要時傳入空字串。 |
| ActualText | 視覺形式與邏輯語義不同之內容的替代文字（/ActualText 屬性）。不需要時傳入空字串。 |
| Lang | 此元素內容的 BCP 47 語言標籤，例如 en-US、fr-FR、zh-Hans。傳入空字串表示繼承文件語言；非空時會為此元素及其所有後代覆蓋文件層級語言。 |
傳回值
| 0 | 失敗（沒有開啟的文件） |
|---|---|
| 1 | Tag opened successfully |
範例
// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;