BeginArtifactExA

Tagged PDF, Tilgængelighed

Beskrivelse

Det afsluttende A angiver DLL-indgangspunktet for ANSI (char); ActiveX/COM-grænsefladen eksponerer kun Unicode-formen. Funktionsmåden er identisk med BeginArtifactEx, og strengargumenter fortolkes med den aktuelle SetAnsiMode-tegntabel

Åbner en PDF-artifact-marked-content-sekvens med eksplicit artefakttype og valgfri Pagination-undertype i ét kald. Udvider BeginArtifact med understøttelse af hele artefaktegenskabsordbogen defineret i ISO 32000-1 §14.8.2.2.1 Table 330.

Brug denne funktion, når du skal udtrykke både en artefakttype (Pagination, Layout eller Page) og en Pagination-undertype (Header, Footer, Watermark, PageNum eller LineNum) i én operator. Når der kun kræves én dimension, er BeginArtifact tilstrækkelig

Hvert kald til BeginArtifactEx skal efterfølges af et tilsvarende kald til EndArtifact.

Syntaks

Delphi

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

DLL

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

Parametre

ArtifactTypeArtefakttypenavn, der skrives som egenskaben /Type. Gyldige værdier i henhold til ISO 32000-1 §14.8.2.2.1:
  • Pagination — sidehoved, sidefod, sidenummer eller andet pagineringselement
  • Layout — layoutstyret indhold såsom kolonnelinjer og baggrundsdekoration
  • Page — indbygget sideindhold, der ikke er knyttet til nogen logisk struktur
Angiv en tom streng for at udelade /Type (operatoren falder tilbage til kun /Subtype eller den rene /Artifact BMC)
ArtifactSubtypePagineringsundertype skrevet som egenskaben /Subtype. Har kun betydning, når ArtifactType er Pagination. Almindelige værdier: Header, Footer, Watermark, PageNum, LineNum. Angiv en tom streng for at udelade /Subtype.

Skrevet operator

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

Returværdier

0Mislykkedes (intet dokument er åbent)
1Artefaktsekvensen blev åbnet korrekt

Eksempel

// 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;