SetStructElemTitleA

標籤式 PDF 與無障礙

描述

結尾的 A 表示 ANSI（char）DLL 進入點，ActiveX/COM 介面僅公開 Unicode 形式。其行為與 SetStructElemTitle 相同，字串引數會依據目前的 SetAnsiMode 字碼頁進行解譯

在標籤堆疊目前建構中的結構元素上設定 /T（標題）項目。標題是描述該特定元素、供人閱讀的標籤 — 例如 第 1 章、彙總表 或 圖 3：季度銷售 — 而不是只是重複元素類型。

語法

Delphi

Function DLSetStructElemTitleA(InstanceID: Integer; Title: PAnsiChar): Integer;

DLL

int DLSetStructElemTitleA(int InstanceID, const char * Title);

參數

Title	識別此元素實例的人類可讀文字字串。傳入空字串可清除先前設定。

傳回值

成功傳回 1；目前沒有開啟中的結構元素或未選取文件時傳回 0

備註

/T 項目定義於 ISO 32000-1 §14.7.2 表 324，以 PDF 文字字串寫入結構元素字典。

Title 的用途與結構元素上其他文字屬性不同：

/T (Title) — 元素的描述性標籤，用於導覽與標籤面板。適合章節標題、表格標題與圖表說明。
/Alt（見 SetStructElemAltText）— 元素無法呈現時，供輔助技術使用的完整文字替代。
/ActualText (see SetStructElemActualText) — An exact Unicode replacement for glyph sequences whose extracted text would be incorrect.

PDF 檢視器用 /T 在 Tags 導覽面板標示元素。無障礙工具與修復軟體把它當作文件導覽的地標標題。標題元素（H1–H6）的內容本身就是標題文字；/T 對需要描述性標籤的非文字元素（Table、Figure、Form）或容器（Sect、Div）比較有用。

範例

// Tag a data table with a title for navigation and accessibility tools
PDFlib.BeginTag('Table', '', '');
PDFlib.SetStructElemTitle('Table 2: Annual Revenue by Region');
// ... table rows and cells
PDFlib.EndTag;

// Tag a document section
PDFlib.BeginTag('Sect', '', '');
PDFlib.SetStructElemTitle('Chapter 3: Implementation');
// ... section content
PDFlib.EndTag;

另見

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics