BeginMarkedContent
PDF marcado, Acessibilidade
Descrição
Abre um intervalo de conteúdo marcado no fluxo de conteúdo atual gravando um operador BDC (Begin Marked Content with Property List). Isso normalmente é usado para criar PDFs estruturados (marcados), atendendo a requisitos de acessibilidade (como PDF/UA)Os intervalos de conteúdo marcado devem estar devidamente balanceados: toda chamada a
BeginMarkedContent deve ser fechada com uma chamada correspondente a EndMarkedContent. Intervalos de conteúdo marcado podem ser aninhados
Sintaxe
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;Parâmetros
| TagType | O nome da tag estrutural, por exemplo /Span, /P, /Figure etc. |
|---|---|
| AltText | Texto de descrição alternativo para acessibilidade (mapeia para a chave /Alt na lista de propriedades). Passe uma string vazia se não for necessário. |
| ActualText | Texto real que substitui a representação de glifos para leitores de tela (mapeia para a chave /ActualText). Passe uma string vazia se não for necessário. |
| Lang | O código de idioma natural do conteúdo marcado (por exemplo en-US; mapeia para a chave /Lang). Passe uma string vazia se não for necessário. |
| Expansion | O texto de expansão para abreviações ou acrônimos (mapeia para a chave /E). Passe uma string vazia se não for necessário. |
Valores retornados
| 0 | Nenhum documento está aberto ou falha ao gravar o conteúdo marcado. |
|---|---|
| 1 | Intervalo de conteúdo marcado aberto com sucesso. |
Observações
Para construir arquivos Tagged PDF/UA em conformidade, certifique-se de que as tags de estrutura lógica envolvam todo o texto e todos os gráficos visíveis. Esta função oferece mapeamento de propriedades de granularidade fina em comparação com BeginTag
Exemplo
// Heading, then a paragraph with marked content span
PDF.NewDocument;
PDF.AddPage;
PDF.BeginMarkedContent('/Span', 'Logo description', '', 'en-US', '');
// Draw graphics or print text here
PDF.EndMarkedContent;