AddPolyLineAnnotation

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

Descrição

Adiciona à página selecionada uma anotação de marcação de polilinha aberta (PDF /Subtype /PolyLine) com a lista de vértices fornecida. A polilinha é aberta — os leitores não ligam o último vértice novamente ao primeiro — e pode ter estilos de fim de linha diferentes em cada extremidade terminal. As decorações finais com interior (ClosedArrow, Square, Circle, Diamond) podem opcionalmente ser preenchidas. Os componentes de cor e a opacidade são expressos numa escala de 0–1; Transparency é indicada numa escala de 0–100 (0 = totalmente opaco, 100 = totalmente transparente). A biblioteca eleva a versão do documento para PDF 1.5 quando é emitida uma anotação PolyLine sob um bloqueio de versão mínima inferior. Definido em ISO 32000-1 §12.5.6.9

Sintaxe

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parâmetros

VertexCoords — Coordenadas dos vértices como uma única cadeia de valores x/y alternados, separados por espaços, vírgulas, pontos e vírgulas ou tabulações. Exemplo: "100 100 200 150 300 100" define uma forma em V. Exige pelo menos dois pares (quatro números) e uma contagem total par de números; caso contrário, a chamada devolve 0

BorderWidth — Largura do traço da polilinha e das respetivas decorações finais, nas unidades atuais

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

StartStyle, EndStyle — Estilos de fim de linha para o primeiro e o último vértice, 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, se a string de vértices falhar ao ser analisada, ou se a anotação não puder ser criada

Observações

O /Rect da anotação é calculado automaticamente a partir da extensão dos vértices e dum espaçamento proporcional à largura do contorno, para que as decorações finais permaneçam dentro da caixa delimitadora da anotação

Os campos avançados opcionais descritos pela especificação PDF — /IT (intenção, incluindo PolyLineDimension) 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 da anotação

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