BeginArtifactEx

Tagged PDF, Barrierefreiheit

Beschreibung

Öffnet eine Artefakt-Marked-Content-Sequenz mit explizitem Artefakttyp und optionalem Pagination-Subtyp in einem Aufruf, unter Verwendung des von ISO 32000-2 §14.8.2.2.1 Tabelle 363 geforderten Eigenschafts-Dictionary und BDC-OperatorsVerwenden Sie diese Funktion für Artefakte vom Typ

Pagination, Layout, Page oder PDF 2.0 Background; jedem erfolgreichen Aufruf muss ein zugehöriger EndArtifact-Aufruf folgen

Syntax

Delphi

Function TPDFlib.BeginArtifactEx(Const ArtifactType, ArtifactSubtype: WideString): Integer;

ActiveX

Function PDFlib::BeginArtifactEx(ArtifactType As String, ArtifactSubtype As String) As Long

DLL

int DLBeginArtifactEx(int InstanceID, const wchar_t * ArtifactType, const wchar_t * ArtifactSubtype);

Parameter

ArtifactType	Übergeben Sie `Pagination`, `Layout`, `Page` oder `Background` oder einen leeren String, um `/Type` wegzulassen
ArtifactSubtype	Optionaler Pagination-Subtyp, üblicherweise `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` oder `Bates`

Ausgegebener Operator

Beide nicht leer	`/Artifact << /Type /T /Subtype /S >> BDC`
Nur Typ	`/Artifact << /Type /T >> BDC`
Nur Subtyp	`/Artifact << /Subtype /S >> BDC`
Beide leer	`/Artifact BMC`

PDF-Version

Background, PageNum, LineNum, Redaction und Bates erfordern PDF 2.0 und heben die Ausgabefunktionsversion automatisch an

Rückgabewerte

0	Fehlgeschlagen (kein Dokument geöffnet)
1	Artefaktsequenz erfolgreich geöffnet

Beispiel

// Mark a running header as a Pagination artifact with subtype Header
PDF.BeginArtifactEx('Pagination', 'Header');
PDF.PrintText(50, 780, 'Chapter 3 - Results');
PDF.EndArtifact;

// Mark a page background using the PDF 2.0 artifact type
PDF.BeginArtifactEx('Background', '');
PDF.DrawImage(BackgroundImage, 0, 0, PDF.PageWidth, PDF.PageHeight);
PDF.EndArtifact;