BeginArtifactExA

PDF con tag, accessibilità

Descrizione

Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a BeginArtifactEx e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode

Apre una sequenza di contenuto contrassegnato come artefatto PDF con tipo esplicito e sottotipo Pagination facoltativo. Estende BeginArtifact per il dizionario completo di ISO 32000-1 §14.8.2.2.1 Tabella 330

Usare questa funzione quando occorre esprimere in un unico operatore sia un tipo di artefatto (Pagination, Layout o Page) sia un sottotipo Pagination (Header, Footer, Watermark, PageNum o LineNum). Nei casi in cui è necessaria una sola dimensione, è sufficiente BeginArtifact

Ogni chiamata BeginArtifactEx deve essere seguita da una chiamata corrispondente a EndArtifact.

Sintassi

Delphi

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

DLL

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

Parametri

ArtifactTypeNome del tipo di artefatto scritto come proprietà /Type. Valori validi secondo ISO 32000-1 §14.8.2.2.1:
  • Pagination — intestazione, piè di pagina, numero di pagina o altro elemento di impaginazione
  • Layout — contenuto determinato dal layout, come separatori di colonna e decorazioni dello sfondo
  • Page — contenuto intrinseco della pagina non associato ad alcuna struttura logica
Passare una stringa vuota per omettere /Type; l'operatore usa soltanto /Subtype oppure /Artifact BMC senza proprietà
ArtifactSubtypeSottotipo Pagination scritto in /Subtype, significativo solo con ArtifactType Pagination. Valori: Header, Footer, Watermark, PageNum, LineNum. Stringa vuota omette /Subtype

Operatore scritto

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

Valori restituiti

0Operazione non riuscita (nessun documento aperto)
1Sequenza Artifact aperta correttamente

Esempio

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