AddAnnotationState

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

Descrição

Esta página descreve AddAnnotationState na PDF Library for Delphi, no tópico "Anotações e ligações de zonas interativas". Os nomes de API, parâmetros, classes e ficheiros, bem como os literais, são mantidos exatamente como aparecem na biblioteca Delphi e nos pontos de entrada da DLL

AddAnnotationState regista uma alteração do estado de revisão de uma anotação existente na página selecionada (ISO 32000-1 §12.5.6.3). Acrescenta uma anotação Text oculta cuja entrada /IRT referencia a anotação de destino e cujas entradas /State e /StateModel contêm o estado da revisão, correspondendo ao fluxo de revisão utilizado 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 com base 1 da anotação na página selecionada cujo estado está a ser definido. Author é o nome do revisor armazenado na entrada /T. StateModel seleciona o modelo de estado: 0 = Review, 1 = Marked. State seleciona o estado no modelo. Para o modelo Review: 0 = None, 1 = Accepted, 2 = Rejected, 3 = Cancelled, 4 = Completed. Para o modelo Marked: 0 = Unmarked, 1 = Marked

Valores devolvidos

Devolve o índice baseado em 1 da nova anotação de estado acrescentada à 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 de destino não está armazenada como objeto indireto

Observações

A anotação de estado é escrita com o indicador Hidden definido, pelo que não é composta na página; em alternativa, os visualizadores de PDF com suporte de revisão apresentam-na no painel de comentários. Utilize GetAnnotState e GetAnnotStateModel para voltar a ler o estado registado. Requer PDF 1.5; a versão do documento é elevada automaticamente quando necessário