AddPolygonAnnotation

Anotações e links de zona ativa

Descrição

Adiciona uma anotação de markup de polígono fechado (PDF /Subtype /Polygon) à página selecionada com a lista de vértices fornecida. O polígono é fechado implicitamente — os readers ligam o último vértice de volta ao primeiro ao renderizar. A forma pode opcionalmente ser preenchida com uma cor interna sólida. Componentes de cor e opacidade são expressos em escala 0–1; Transparency é dada em escala 0–100 (0 = totalmente opaco, 100 = totalmente transparente). A biblioteca eleva a versão do documento para PDF 1.5 quando uma anotação Polygon é emitida sob uma trava de versão mínima menor. Definida 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 string de valores x/y alternados, separados por espaços, vírgulas, ponto e vírgula ou tabs. Exemplo: "100 100 200 100 200 200 100 200" define um quadrado. Exige ao menos dois pares (quatro números) e uma contagem total par de números; caso contrário, a chamada retorna 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, gravados em /C

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

FillRed, FillGreen, FillBlue — componentes RGB (0–1) da cor de preenchimento interior. 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, se a string de vértices não puder ser analisada ou se a anotação não pôde ser criada

Observações

O /Rect da anotação é calculado automaticamente a partir da extensão dos vértices mais um pequeno preenchimento proporcional à largura da borda, de modo que o traço do contorno permaneça dentro da bounding box da anotação

Os campos avançados opcionais descritos pela especificação PDF — /BE (efeito de borda, incluindo o estilo de contorno nublado), /IT (intent, incluindo PolygonCloud e PolygonDimension) 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, a borda, o conteúdo ou o retângulo do outline após a criação, use SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents e SetAnnotRect.