AddCircleAnnotation

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

Descrição

Adiciona uma anotação de marcação elíptica (PDF /Subtype /Circle) inscrita no retângulo indicado. Apesar do nome, a anotação é uma elipse completa e só é composta como um círculo verdadeiro quando Width é igual a Height. Opcionalmente, a anotação 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). Como este ponto de entrada emite a chave de opacidade /CA de anotações PDF 1.4, a biblioteca eleva os documentos inferiores desbloqueados para PDF 1.4 antes de guardar; os destinos inferiores bloqueados são rejeitados pela barreira de compatibilidade. Definido na norma ISO 32000-1 §12.5.6.8

Sintaxe

Delphi

Function TPDFlib.AddCircleAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parâmetros

Esquerda — Coordenada horizontal do canto inferior esquerdo do retângulo delimitador's, nas unidades atuais

Top — Coordenada vertical do canto inferior esquerdo do retângulo delimitador d'a anotação, nas unidades atuais

Width — Largura do retângulo delimitador

Altura — Altura do retângulo delimitador

BorderWidth — Largura do traço do contorno da elipse, nas unidades atuais. Escrita tanto no campo antigo /Border como no dicionário de estilos de contorno /BS

BorderRed, BorderGreen, BorderBlue — componentes RGB (0–1) da cor do traço, escritos em /C

Filled — 1 para emitir uma cor de preenchimento interior (/IC), 0 para deixar a elipse 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 ou se a anotação não puder ser criada

Observações

A anotação é emitida com um conjunto padrão de campos de marcação: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (quando Filled), /BS, /Border, /CA, /F = 4 (imprimível), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Isto corresponde ao que Adobe Acrobat e Foxit produzem para as respetivas ferramentas de revisão de elipses, permitindo que fluxos de trabalho de revisão externos localizem, editem e comentem a anotação resultante, bem como respondam à mesma

Para substituir o retângulo delimitador, a cor, o conteúdo ou o contorno após a criação, utilize SetAnnotRect, SetAnnotBorderColor, SetAnnotContents e SetAnnotBorderStyle