AddPolygonAnnotation

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

Descrição

Adiciona à página selecionada uma anotação de marcação poligonal fechada (PDF /Subtype /Polygon) com a lista de vértices fornecida. O polígono é implicitamente fechado — os leitores ligam o último vértice ao primeiro durante a composição. Opcionalmente, a forma pode ser preenchida com uma cor interior sólida. 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 Polygon sob um bloqueio de versão mínima inferior. Definido na ISO 32000-1 §12.5.6.9

Sintaxe

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; 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 100 200 200 100 200" define um quadrado. 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 do contorno do polígono, nas unidades atuais

BorderRed, BorderGreen, BorderBlue — Componentes RGB (0–1) da cor do contorno, escritos em /C

Filled — 1 para emitir uma cor de preenchimento interior (/IC) para o corpo do polígono, 0 para o deixar sem preenchimento

FillRed, FillGreen, FillBlue — Componentes RGB (0–1) da cor de preenchimento interior. Ignorados 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, acrescida de um pequeno preenchimento proporcional à largura do contorno, para que o traço do contorno permaneça dentro da caixa delimitadora da anotação

Os campos avançados opcionais descritos pela especificação PDF — /BE (efeito do contorno, incluindo o estilo de contorno nublado), /IT (intenção, incluindo PolygonCloud e PolygonDimension) 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 anotação após a criação, utilize SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents e SetAnnotRect