BeginArtifactExA

Taggad PDF, tillgänglighet

Beskrivning

Det avslutande A:et betecknar ANSI (char)-DLL-ingångspunkten; ActiveX/COM-ytan exponerar bara Unicode-formen. Beteendet är identiskt med BeginArtifactEx och strängargument tolkas med aktuell SetAnsiMode-kod sida

Öppnar en PDF-artefakt marked-content-sekvens med explicit artefakttyp och valfri Pagination-subtyp i ett enda anrop. Utökar BeginArtifact att stödja hela den artefaktegenskapsdictionary som definieras i ISO 32000-1 §14.8.2.2.1 tabell 330

Använd den här funktionen när du behöver uttrycka både en artefakttyp (Pagination, Layout eller Page) och en Pagination-subtyp (Header, Footer, Watermark, PageNum eller LineNum) i en enda operator. För fall där bara en dimension behövs räcker BeginArtifact

Varje BeginArtifactEx-anrop måste följas av ett matchande EndArtifact-anrop

Syntax

Delphi

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

DLL

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

Parametrar

ArtifactTypeArtefakttypsnamn skrivet som egenskapen /Type. Giltiga värden enligt ISO 32000-1 §14.8.2.2.1:
  • Pagination — sidhuvud, sidfot, sidnummer eller annat pagineringselement
  • Layout — layoutdrivet innehåll som kolumnlinjer, bakgrundsdekoration
  • Page — inneboende sidinnehåll inte knutet till någon logisk struktur
Ange en tom sträng för att utelämna /Type (operatorn faller tillbaka till enbart /Subtype eller bart /Artifact BMC)
ArtifactSubtypePagineringsundertyp skriven som egenskapen /Subtype. Meningsfull bara när ArtifactType är Pagination. Vanliga värden: Header, Footer, Watermark, PageNum, LineNum. Ange en tom sträng för att utelämna /Subtype

Skriven 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ärden

0Misslyckades (inget dokument är öppet)
1Artifact sequence opened successfully

Exempel

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