AddInkAnnotation

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

Descrição

Adiciona uma anotação de marcação a tinta (PDF /Subtype /Ink) que representa um ou mais traços manuscritos, marcas livres ou esboços à mão livre desenhados na página. A entrada de dicionário /InkList contém uma matriz de traços; cada traço é uma matriz de coordenadas x/y alternadas que representam o caminho percorrido por um dispositivo apontador entre os eventos de baixar e levantar a caneta. 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 da anotação PDF 1.4, a biblioteca eleva documentos inferiores não bloqueados para PDF 1.4 antes de guardar; destinos inferiores bloqueados são rejeitados pela verificação de compatibilidade. Definido na norma ISO 32000-1 §12.5.6.13

Sintaxe

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parâmetros

InkPaths — Um ou mais traços codificados como uma única cadeia. Os traços são separados por '|' ou por uma nova linha (CR / LF / CRLF). Dentro de cada traço, os pares de coordenadas utilizam a mesma convenção de delimitadores de AddPolygonAnnotation: valores x/y alternados, separados por espaços, vírgulas, ponto e vírgula ou tabulações. Exemplo: "100 100 110 105 120 110 | 200 200 210 205" descreve dois traços separados. Cada traço tem de conter pelo menos dois pares de coordenadas (quatro números) e um número total par de valores, caso contrário a chamada devolve 0

BorderWidth — Largura do traço da tinta, nas unidades atuais

InkRed, InkGreen, InkBlue — Componentes RGB (0–1) da cor da tinta, escritos em /C

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 tinta falhar ao ser analisada para uma lista de traços válida, ou se a anotação não puder ser criada

Observações

O /Rect da anotação é calculado automaticamente a partir da extensão combinada de todos os traços, acrescida de um pequeno preenchimento proporcional à largura do contorno, para que os traços compostos permaneçam dentro da caixa delimitadora da anotação

Este ponto de entrada é adequado tanto para escrita manuscrita digitalizada capturada a partir de um dispositivo tátil/de caneta como para formas à mão livre programáticas, como assinaturas rabiscadas ou anotações importadas de outras ferramentas. Para substituir a cor da tinta, o contorno, o conteúdo ou o retângulo após a criação, utilize SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents e SetAnnotRect