SetStructElemSpaceBefore

PDF marcado, Acessibilidade

Descrição

Define o atributo /SpaceBefore (Layout attribute owner) no elemento de estrutura aberto no topo da pilha de tags. O valor especifica o espaço a adicionar antes do elemento de bloco — análogo a margin-top ou padding-top do CSS. Equivale a chamar AddTagAttribute com Owner=Layout, Name=SpaceBefore e o valor numérico como string.

Sintaxe

Delphi

Function TPDFlib.SetStructElemSpaceBefore(Space: Double): Integer;

ActiveX

Function PDFlib::SetStructElemSpaceBefore(Space As Double) As Long

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

Parâmetros

Space	Espaço antes do elemento, em unidades de user space padrão (pontos, 1/72 de polegada). Deve ser um valor não negativo. O valor 0 significa nenhum espaço extra antes do elemento.

Valor de retorno

Retorna 1 em caso de sucesso. Retorna 0 se nenhum documento estiver aberto ou nenhuma tag estiver aberta na pilha de tags

Observações

Chame esta função depois de BeginTag ou BeginTagEx e antes de EndTag. O atributo /SpaceBefore é definido na ISO 32000-1 §14.8.5.4.2 (Layout attribute owner, Tabela 340).

Os atributos de layout (SpaceBefore, SpaceAfter, StartIndent, EndIndent) são indicativos: descrevem o layout visual pretendido para motores de re-flow e de exportação (por exemplo, quando um PDF é refluído para HTML ou EPUB) Eles não afetam a aparência renderizada do próprio PDF Fornecer atributos de layout precisos melhora a qualidade da saída refluída das ferramentas de acessibilidade

Exemplo

// Tag a heading with extra space above it
PDFlib.BeginTag('H1', '', '', '');
PDFlib.SetStructElemSpaceBefore(12.0);  // 12 pt above the heading
PDFlib.DrawText('Introduction', 72, 700);
PDFlib.EndTag;

Veja também

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute