SetStructElemSpaceBefore

PDF etiquetado, acessibilidade

Descrição

Define o atributo /SpaceBefore (proprietário de atributos Layout) no elemento de estrutura atualmente aberto na pilha de etiquetas. O valor especifica o espaço a adicionar antes do elemento ao nível do bloco — semelhante a margin-top ou padding-top em CSS. Equivale a invocar AddTagAttribute com Owner=Layout, Name=SpaceBefore e o valor numérico como cadeia

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 predefinidas do espaço do utilizador (pontos, 1/72 polegada). Tem de ser um valor não negativo. Um valor de 0 significa que não há espaço adicional antes do elemento

Valor devolvido

Devolve 1 em caso de êxito. Devolve 0 se não houver nenhum documento aberto ou nenhuma etiqueta atualmente aberta na pilha de etiquetas

Observações

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

Os atributos de disposição (SpaceBefore, SpaceAfter, StartIndent, EndIndent) são indicativos: descrevem a disposição visual pretendida para motores de redisposição e exportação (por exemplo, quando um PDF é redisposto para HTML ou EPUB). Não afetam a aparência composta do próprio PDF. Fornecer atributos de disposição exatos melhora a qualidade da saída redisposta por 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;

Consulte também

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute