AddPolyLineAnnotation

Anotações e links de zona ativa

Descrição

Adiciona uma anotação de markup de polilinha aberta (PDF /Subtype /PolyLine) à página selecionada com a lista de vértices fornecida. A polilinha é aberta — os readers não ligam o último vértice de volta ao primeiro — e pode ter estilos de terminação diferentes em cada extremidade final. Decorações de extremidade com interior (ClosedArrow, Square, Circle, Diamond) podem opcionalmente ser preenchidas. 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 PolyLine é emitida sob uma trava de versão mínima menor. Definida na 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 string de valores x/y alternados, separados por espaços, vírgulas, ponto e vírgula ou tabs. Exemplo: "100 100 200 150 300 100" define um V. 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 da polilinha 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 o primeiro e o último vértice, 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, 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 preenchimento proporcional à largura da borda, de modo que as decorações de extremidade permaneçam dentro da bounding box da anotação

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