BeginArtifactA

Tagged PDF, Barrierefreiheit

Beschreibung

Das nachgestellte A bezeichnet den ANSI-DLL-Einstiegspunkt (char); die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten entspricht BeginArtifact, und Zeichenfolgenargumente werden mit der aktuellen Codepage von SetAnsiMode interpretiert

Öffnet einen PDF-Artefaktbereich. Artefaktinhalt ist dekorativ oder strukturell (Kopfzeilen, Fußzeilen, Seitennummern, Hintergrundbilder, Trennlinien) und ausdrücklich aus der logischen Lesereihenfolge des Dokuments ausgeschlossen. Screenreader überspringen Artefaktbereiche vollständig.

Schreiben Sie Grafik oder Text des Artefakts zwischen BeginArtifact und den passenden Aufruf EndArtifact.

Syntax

Delphi

Function DLBeginArtifactA(InstanceID: Integer; SubType: PAnsiChar): Integer;

DLL

int DLBeginArtifactA(int InstanceID, const char * SubType);

Parameter

SubType	Optionaler Name des Artefaktuntertyps. Häufige Werte: `Header`, `Footer`, `Watermark`, `Background`. Übergeben Sie eine leere Zeichenfolge, um den Untertyp wegzulassen.

Rückgabewerte

0	Fehlgeschlagen (kein Dokument ist geöffnet)
1	Artefaktbereich erfolgreich geöffnet

Beispiel

// Page footer as artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 20, 'Page 1 of 10');
PDF.EndArtifact;