BeginArtifactExA

PDF etiquetado, acessibilidade

Descrição

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

Abre, numa única chamada, uma sequência de conteúdo marcado de artefacto PDF com tipo de artefacto explícito e subtipo Pagination opcional. Expande BeginArtifact para suportar todo o dicionário de propriedades de artefactos definido na ISO 32000-1 §14.8.2.2.1, Tabela 330

Utilize esta função quando precisar de expressar tanto um tipo de artefacto (Pagination, Layout ou Page) como um subtipo de Pagination (Header, Footer, Watermark, PageNum ou LineNum) num único operador. Nos casos em que seja necessária apenas uma dimensão, BeginArtifact é suficiente

Cada chamada de BeginArtifactEx tem de ser seguida por uma chamada correspondente de 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 artefacto escrito como propriedade /Type. Valores válidos segundo a norma ISO 32000-1 §14.8.2.2.1:
  • Pagination — cabeçalho, rodapé, número de página ou outro elemento de paginação
  • Layout — conteúdo determinado pela disposição, como separadores de colunas ou decoração de fundo
  • Page — conteúdo intrínseco da página não associado a qualquer estrutura lógica
Passe uma cadeia vazia para omitir /Type (o operador recorre apenas a /Subtype ou a /Artifact BMC simples)
ArtifactSubtypeSubtipo Pagination escrito como propriedade /Subtype. Só tem significado quando ArtifactType é Pagination. Valores comuns: Header, Footer, Watermark, PageNum, LineNum. Passe uma cadeia vazia para omitir /Subtype

Operador escrito

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 devolvidos

0Falha (nenhum documento aberto)
1Sequência de artefacto aberta com êxito

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;