BeginArtifactExA

PDF balisé, accessibilité

Description

Le A final indique le point d’entrée de DLL ANSI (char); l’interface ActiveX/COM n’expose que la forme Unicode. Le comportement est identique à BeginArtifactEx et les arguments de chaîne sont interprétés selon la page de codes SetAnsiMode actuelle

Ouvre en un seul appel une séquence de contenu marqué d’artefact PDF avec un type explicite et un sous-type Pagination facultatif. Étend BeginArtifact pour prendre en charge le dictionnaire complet des propriétés d’artefact défini dans ISO 32000-1 §14.8.2.2.1, tableau 330

Utilisez cette fonction pour exprimer dans un opérateur un type d’artefact (Pagination, Layout ou Page) et un sous-type Pagination (Header, Footer, Watermark, PageNum ou LineNum). Si une seule dimension est nécessaire, BeginArtifact suffit

Chaque appel à BeginArtifactEx doit être suivi d'un appel correspondant à EndArtifact

Syntaxe

Delphi

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

DLL

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

Paramètres

ArtifactTypeNom du type d’artefact écrit dans la propriété /Type. Valeurs valides selon ISO 32000-1 §14.8.2.2.1 :
  • Pagination — en-tête, pied de page, numéro de page ou autre élément de pagination
  • Layout — contenu lié à la mise en page, notamment filets de colonne et décoration d’arrière-plan
  • Page — contenu intrinsèque de page sans lien avec une structure logique
Transmettez une chaîne vide pour omettre /Type (l’opérateur revient à /Subtype seul ou à /Artifact BMC sans propriété)
ArtifactSubtypeSous-type Pagination écrit comme propriété /Subtype. Significatif uniquement si ArtifactType vaut Pagination. Valeurs courantes : Header, Footer, Watermark, PageNum, LineNum. Transmettez une chaîne vide pour omettre /Subtype

Opérateur écrit

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

Valeurs de retour

0Échec (aucun document n’est ouvert)
1La séquence d’artefact a été ouverte

Exemple

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