AddLineAnnotation

Anotações e ligações de áreas interativas

Descrição

Adiciona uma anotação de marcação de linha (PDF /Subtype /Line) entre dois pontos finais na página selecionada. Cada extremidade pode ter um estilo diferente (seta, quadrado, círculo, losango, …) e o corpo da linha pode ser desenhado em qualquer cor RGB com opacidade configurável. As decorações de extremidade com interior (ClosedArrow, Square, Circle, Diamond) podem ser opcionalmente preenchidas. Como este ponto de entrada emite a chave de opacidade /CA da anotação PDF 1.4, a biblioteca eleva os documentos desbloqueados de versão inferior para PDF 1.4 antes da gravação; destinos inferiores bloqueados são rejeitados pela barreira de compatibilidade. Definido em ISO 32000-1 §12.5.6.7

Sintaxe

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parâmetros

StartLeft, StartTop — coordenadas do ponto final inicial da linha's, nas unidades atuais

EndLeft, EndTop — coordenadas do ponto final da linha's, nas unidades atuais

BorderWidth — largura do traço da linha e das respetivas decorações de extremidade, nas unidades atuais

LineRed, LineGreen, LineBlue — Componentes RGB (0–1) da cor da linha, escritos em /C

StartStyle, EndStyle — Estilos de terminação de linha para os pontos inicial e final, respetivamente. Utilize um dos seguintes:

0 = Nenhum, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash

Os valores fora do intervalo são limitados a 0 (None)

Preenchido — 1 para emitir uma cor de preenchimento interior (/IC) para as decorações das extremidades, 0 para as deixar sem preenchimento

FillRed, FillGreen, FillBlue — componentes RGB (0–1) da cor de preenchimento interior da decoração final. Ignorado quando Filled é 0

Título — Nome do autor escrito na entrada /T da anotação's. Passe uma cadeia vazia para ignorar

Contents — corpo do pop-up associado à anotação. Passe uma cadeia vazia para omitir

Transparency — opacidade expressa como percentagem de transparência (0–100). A biblioteca converte-a em PDF /CA = 1 - Transparency/100 e limita-a ao intervalo

Valor devolvido

1 em caso de sucesso, 0 se nenhum documento estiver selecionado ou se a anotação não puder ser criada

Observações

O /Rect da anotação é calculado automaticamente a partir dos dois pontos finais, com um preenchimento proporcional à largura do limite para que as decorações das extremidades permaneçam dentro da caixa delimitadora da anotação. Os leitores de PDF exigem que o /Rect delimitador contenha todo o desenho visível; caso contrário, as decorações das extremidades podem ser recortadas

Os campos avançados opcionais descritos pela especificação PDF — /LL (comprimento da linha auxiliar), /LLE, /LLO, /Cap, /CP, /CO e /Measure — não são emitidos por este ponto de entrada. Podem ser acrescentados após a criação, escrevendo-os diretamente no dicionário de anotações

Para substituir a cor, o contorno, o conteúdo ou o retângulo da linha após a criação, utilize SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents e SetAnnotRect