AddAnnotationState

Anotações e links de zona ativa

Descrição

Esta página descreve AddAnnotationState em PDF Library for Delphi, no tópico "Anotações e links de zona ativa". Nomes de API, parâmetros, nomes de classes, nomes de arquivos e literais são mantidos exatamente como aparecem na biblioteca Delphi e nos pontos de entrada da DLL

AddAnnotationState registra uma alteração de status de revisão para uma anotação existente na página selecionada (ISO 32000-1 §12.5.6.3). Ele anexa uma anotação oculta de Texto cuja entrada /IRT referencia a anotação alvo e cujas entradas /State e /StateModel carregam o status de revisão, correspondendo ao fluxo de trabalho de revisão usado pelo painel de comentários do Acrobat.

Sintaxe

Delphi

Function TPDFlib.AddAnnotationState(TargetAnnot: Integer; Const Author: WideString; State, StateModel: Integer): Integer;

Parâmetros

TargetAnnot é o índice baseado em 1 da anotação na página selecionada cujo status está sendo definido. Author é o nome do revisor armazenado na entrada /T. StateModel seleciona o modelo de estado: 0 = Review, 1 = Marked. State seleciona o estado dentro do modelo. Para o modelo Review: 0 = None, 1 = Accepted, 2 = Rejected, 3 = Cancelled, 4 = Completed. Para o modelo Marked: 0 = Unmarked, 1 = Marked.

Valores retornados

Retorna o índice, com base 1, da anotação de estado recém-anexada na lista de anotações da página, ou 0 quando o seletor de estado ou modelo é desconhecido, quando TargetAnnot não existe, ou quando a anotação alvo não está armazenada como um indirect object.

Observações

A anotação de estado é gravada com o flag Hidden definido, então não é renderizada na página; visualizadores de PDF com suporte a revisão a expõem no painel de comentários. Use GetAnnotState e GetAnnotStateModel para ler o status registrado de volta. Exige PDF 1.5; a versão do documento é elevada automaticamente quando necessário.