SetAutoTagMode

標籤式 PDF

描述

開啟結構標記，讓一般繪圖呼叫自動攜帶標記。

語法

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

參數

Mode	位元遮罩：1 標記文字，2 把頁面裝飾元素標為 artifact，4 把影像標記為 figure，8 標記繪製的表格，15 四項全做，0 關閉。

傳回值

Mode	此呼叫之前生效的模式。
0	傳入負的 mode 時也會傳回，此時請求被拒、模式保持不變。

備註

文字標記開啟時，文字會標記為段落；緊接在 RegisterHeading 之後繪製的文字，則標記為該登錄層級的標題。

figure 標記開啟時，繪製的影像會變成帶有 RegisterFigure 所留描述的 figure；沒有待用描述時，則畫進 layout artifact 裡

表格標記開啟時，DrawTableRows 會把表格及其列與儲存格帶進結構樹。SetTableHeaderRowCount 指定的列會標記為表頭列。

開啟此模式也會把文件標記為標籤式。閱讀器在看到該標記之前會把結構當成不存在——有標籤卻沒有標記的文件，讀起來就像完全沒有結構。

在以 BeginTag 開啟的標籤內，自動標記會退讓：呼叫端自己描述結構時，不會在它開啟的元素裡再巢狀任何東西。自動標記也絕不在 artifact 內加標籤——那會讓結構元素把檔案弄成無效——也不會為空文字開元素，免得閱讀器朗讀成一個空白

此模式屬於程式庫實例，不屬於文件

範例

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

另見

GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount