AddAnnotationState

Anotações e links hotspot

Descrição

Esta página descreve AddAnnotationState no PDFlibPas no tópico "Anotações e links hotspot". Nomes de API, parâmetros, nomes de classe, nomes de ficheiros e literais são mantidos exatamente como aparecem na biblioteca Delphi e nos pontos de entrada DLL.

AddAnnotationState records a review status change for an existing annotation on the selected page (ISO 32000-1 §12.5.6.3). It appends a hidden Text annotation whose /IRT entry references the target annotation and whose /State and /StateModel entries carry the review status, matching the review workflow used by Acrobat's comment panel.

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 guardado 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 de Retorno

Devolve 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 de modelo é desconhecido, quando TargetAnnot não existe, ou quando a anotação destino não está guardada como um objeto indireto.

Observações

A anotação de estado é escrita com a flag Oculto (Hidden) ativada, para que não seja renderizada na página; os visualizadores de PDF com suporte para revisão revelam-na no painel de comentários em vez disso. Use GetAnnotState e GetAnnotStateModel para ler de volta o status registado. Requer PDF 1.5; a versão do documento é incrementada automaticamente quando necessário.