BeginTag

標記 PDF, 無障礙

說明

本頁介紹 PDFlibPas 中屬於「標記 PDF, 無障礙」主題的 BeginTag。API 名稱、參數、類別名稱、檔案名稱和字面值保持原樣，以便和 Delphi 函式庫及 DLL 進入點完全對應。

呼叫函式前請查看語法、參數和傳回值。程式碼區塊保留原始形式，便於範例直接複製使用。

呼叫函式前請查看語法、參數和傳回值。程式碼區塊保留原始形式，便於範例直接複製使用。 EndTag

語法

Delphi

Function TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

Function PDFlib::BeginTag(TagType As String, AltText As String, ActualText As String) As Long

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText);

參數

TagTypeTagType 是 BeginTag 的參數。請使用簽章中顯示的型別，並提供與目前 PDF 文件、所選頁面或作用中資源一致的值。
AltTextAltText 是 BeginTag 的參數。請使用簽章中顯示的型別，並提供與目前 PDF 文件、所選頁面或作用中資源一致的值。
ActualTextActualText 是 BeginTag 的參數。請使用簽章中顯示的型別，並提供與目前 PDF 文件、所選頁面或作用中資源一致的值。

傳回值

0此值說明 BeginTag 的呼叫結果。通常非零值表示成功，0 表示操作未完成。
1此值說明 BeginTag 的呼叫結果。通常非零值表示成功，0 表示操作未完成。

範例

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

備註

呼叫函式前請查看語法、參數和傳回值。程式碼區塊保留原始形式，便於範例直接複製使用。 BeginArtifact, EndArtifact

使用此 API 時，請注意 PDF/A 限制、所需最低 PDF 版本、外部資源以及目前選定的文件狀態。 SetPDFUAMode