AddSquareAnnotation

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

Descrição

Adiciona uma anotação de marcação retangular (PDF /Subtype /Square) à página selecionada. A anotação desenha um retângulo contornado inscrito no retângulo delimitador indicado e pode, opcionalmente, 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). Uma vez que este ponto de entrada emite a chave de opacidade /CA das anotações PDF 1.4, a biblioteca eleva os documentos desbloqueados de versão inferior para PDF 1.4 antes de guardar; os destinos bloqueados de versão inferior são rejeitados pela barreira de compatibilidade. Definido na norma ISO 32000-1 §12.5.6.8

Sintaxe

Delphi

Function TPDFlib.AddSquareAnnotation(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

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

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

Largura — Largura do retângulo da anotação

Altura — Altura do retângulo da anotação

BorderWidth — Largura do traço do contorno do retângulo, 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 o retângulo 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 /Square, /Rect, /C, /IC (quando Filled), /BS, /Border, /CA, /F = 4 (imprimível), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Isto corresponde ao que Adobe Acrobat e Foxit produzem para as respetivas ferramentas de revisão de retângulos, pelo que os fluxos de trabalho externos de revisão podem localizar, editar, comentar e responder à anotação resultante

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