BeginMarkedContent
PDF etiquetado, acessibilidade
Descrição
Abre um intervalo de conteúdo marcado no fluxo de conteúdo atual escrevendo um operador BDC (Begin Marked Content with Property List); isto é tipicamente usado para criar PDFs estruturados (etiquetados), satisfazendo requisitos de acessibilidade (como PDF/UA)Os intervalos de conteúdo marcado têm de estar devidamente equilibrados: cada chamada a
BeginMarkedContent tem de ser fechada com uma chamada correspondente a EndMarkedContent; os 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 etiqueta estrutural, por exemplo /Span, /P, /Figure, etc. |
|---|---|
| AltText | Texto de descrição alternativo para acessibilidade (mapeado para a chave /Alt na lista de propriedades); passe uma cadeia vazia se não for necessário |
| ActualText | Texto real que substitui a representação em glifos para leitores de ecrã (mapeado para a chave /ActualText); passe uma cadeia vazia se não for necessário |
| Lang | O código de língua natural do conteúdo marcado (por exemplo en-US, mapeado para a chave /Lang); passe uma cadeia vazia se não for necessário |
| Expansion | O texto de expansão para abreviaturas ou siglas (mapeado para a chave /E); passe uma cadeia vazia se não for necessário |
Valores devolvidos
| 0 | Nenhum documento está aberto ou falhou a escrita do conteúdo marcado |
|---|---|
| 1 | Intervalo de conteúdo marcado aberto com êxito |
Observações
Para construir ficheiros PDF etiquetados compatíveis com PDF/UA, certifique-se de que as etiquetas de estrutura lógica envolvem todo o texto e gráficos visíveis; esta função oferece um mapeamento de propriedades mais fino 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;