BeginArtifactExA

Tagged PDF, Barrierefreiheit

Beschreibung

Das abschließende A bezeichnet den ANSI-DLL-Einstiegspunkt (char); die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten ist identisch mit BeginArtifactEx, und Zeichenfolgenargumente werden anhand der aktuellen Codepage von SetAnsiMode interpretiert

Öffnet in einem einzigen Aufruf eine als PDF-Artefakt markierte Inhaltssequenz mit explizitem Artefakttyp und optionalem Pagination-Untertyp. Erweitert BeginArtifact um Unterstützung für das vollständige Artefakteigenschaftswörterbuch aus ISO 32000-1 §14.8.2.2.1, Tabelle 330

Diese Funktion verwenden, wenn sowohl ein Artefakttyp (Pagination, Layout oder Page) als auch ein Pagination-Subtyp (Header, Footer, Watermark, PageNum oder LineNum) in einem Operator ausgedrückt werden müssen. Wenn nur eine Dimension benötigt wird, genügt BeginArtifact.

Auf jeden Aufruf von BeginArtifactEx muss ein passender Aufruf von EndArtifact folgen

Syntax

Delphi

Function DLBeginArtifactExA(InstanceID: Integer; ArtifactType, ArtifactSubtype: PAnsiChar): Integer;

DLL

int DLBeginArtifactExA(int InstanceID, const char * ArtifactType, const char * ArtifactSubtype);

Parameter

ArtifactTypeName des Artefakttyps, der als Eigenschaft /Type geschrieben wird. Gültige Werte gemäß ISO 32000-1 §14.8.2.2.1:
  • Pagination — Seitenkopf, Seitenfuß, Seitennummer oder anderes Paginierungselement
  • Layout — layoutbedingter Inhalt wie Spaltentrennlinien oder Hintergrunddekoration
  • Page — eigentlicher Seiteninhalt ohne Zuordnung zu einer logischen Struktur
Übergeben Sie eine leere Zeichenfolge, um /Type wegzulassen (der Operator fällt auf nur /Subtype oder ein bloßes /Artifact BMC zurück).
ArtifactSubtypeAls Eigenschaft /Subtype geschriebener Pagination-Untertyp. Nur von Bedeutung, wenn ArtifactType den Wert Pagination hat. Übliche Werte: Header, Footer, Watermark, PageNum, LineNum. Eine leere Zeichenfolge übergeben, um /Subtype auszulassen

Operator geschrieben

Both non-empty/Artifact << /Type /T /Subtype /S >> BMC
Type only/Artifact << /Type /T >> BMC
Subtype only/Artifact << /Subtype /S >> BMC
Both empty/Artifact BMC

Rückgabewerte

0Fehlgeschlagen (kein Dokument ist geöffnet)
1Artefaktsequenz 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 column rule as a Layout artifact (no subtype needed)
PDF.BeginArtifactEx('Layout', '');
PDF.DrawLine(300, 50, 300, 750);
PDF.EndArtifact;