AddLineAnnotation

Anotações e links de zona ativa

Descrição

Adiciona uma anotação de markup de linha (PDF /Subtype /Line) entre dois pontos finais na página selecionada. Cada extremidade pode ter um estilo de terminação diferente (seta, quadrado, círculo, losango, …) e o corpo da linha pode ser desenhado em qualquer cor RGB com opacidade configurável. Decorações de extremidade com interior (ClosedArrow, Square, Circle, Diamond) podem opcionalmente ser preenchidas. Como este ponto de entrada emite a chave de opacidade /CA de anotação do PDF 1.4, a biblioteca eleva documentos menores destravados para PDF 1.4 antes de salvar; alvos menores travados são rejeitados pelo gate de compatibilidade. Definida na 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 inicial da linha, nas unidades atuais

EndLeft, EndTop — Coordenadas do ponto final da linha, nas unidades atuais

BorderWidth — Largura do traço da linha e de suas decorações de extremidade, nas unidades atuais

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

StartStyle, EndStyle — estilos de extremidade para os pontos inicial e final, respectivamente. Use um de:

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

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

Filled — 1 para emitir uma cor de preenchimento interior (/IC) nas decorações de extremidade, 0 para deixá-las sem preenchimento

FillRed, FillGreen, FillBlue — componentes RGB (0–1) da cor de preenchimento interior das decorações de extremidade. Ignorado quando Filled é 0

Title — Nome do autor gravado na entrada /T da anotação. Passe uma string vazia para omitir

Contents — Corpo do popup associado à anotação. Passe uma string vazia para omitir

Transparency — Opacidade expressa como porcentagem transparente (0–100). A biblioteca converte isso para PDF /CA = 1 - Transparency/100 e limita ao intervalo

Valor de retorno

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

Observações

O /Rect da anotação é calculado automaticamente a partir dos dois pontos finais mais um preenchimento proporcional à largura da borda, de modo que as decorações de extremidade permaneçam dentro da bounding box da anotação. Os leitores de PDF exigem que o /Rect delimitador contenha todo o desenho visível, ou as decorações de extremidade podem ser recortadas

Os campos avançados opcionais descritos pela especificação PDF — /LL (comprimento da linha guia), /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 gravando-os diretamente no dicionário da anotação

Para sobrescrever a cor da linha, a borda, o conteúdo ou o retângulo após a criação, use SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents e SetAnnotRect.