BeginArtifactExA

PDF marcado, Acessibilidade

Descrição

O A final indica o ponto de entrada DLL ANSI (char); a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de BeginArtifactEx e os argumentos string são interpretados usando a página de código atual de SetAnsiMode

Abre uma sequência de conteúdo marcado de artifact com tipo de artifact explícito e subtipo Pagination opcional em uma única chamada. Estende BeginArtifact para suportar o dicionário completo de propriedades de artifact definido na ISO 32000-1 §14.8.2.2.1 Tabela 330.

Use esta função quando precisar expressar em um único operator tanto um tipo de artifact (Pagination, Layout ou Page) quanto um subtipo Pagination (Header, Footer, Watermark, PageNum ou LineNum). Para casos em que só uma dimensão é necessária, BeginArtifact basta.

Toda chamada a BeginArtifactEx deve ser seguida por uma chamada correspondente a EndArtifact.

Sintaxe

Delphi

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

DLL

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

Parâmetros

ArtifactTypeNome do tipo de artifact gravado como propriedade /Type. Valores válidos conforme ISO 32000-1 §14.8.2.2.1:
  • Pagination — cabeçalho de página, rodapé, número de página ou outro elemento de paginação
  • Layout — conteúdo dirigido por layout, como filetes de coluna e decoração de fundo
  • Page — conteúdo intrínseco da página não ligado a nenhuma estrutura lógica
Passe uma string vazia para omitir /Type (o operador cai para apenas /Subtype ou um /Artifact BMC puro).
ArtifactSubtypeSubtipo de Pagination gravado como propriedade /Subtype. Faz sentido apenas quando ArtifactType é Pagination. Valores comuns: Header, Footer, Watermark, PageNum, LineNum. Passe uma string vazia para omitir /Subtype.

Operador gravado

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

Valores retornados

0Failed (no document is open)
1Artifact sequence opened successfully

Exemplo

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