AddAnnotationState

Anotaciones y enlaces activos (hotspots)

Descripción

Esta página describe AddAnnotationState en PDFlibPas bajo el tema "Anotaciones y enlaces activos". Los nombres de la API, los parámetros, los nombres de clase, los nombres de archivo y los literales se mantienen exactamente como aparecen en la biblioteca de Delphi y en los puntos de entrada de la DLL.

AddAnnotationState registra un cambio de estado de revisión para una anotación existente en la página seleccionada (ISO 32000-1 §12.5.6.3). Agrega una anotación oculta de Texto cuya entrada /IRT hace referencia a la anotación de destino y cuyas entradas /State y /StateModel contienen el estado de la revisión, coincidiendo con el flujo de trabajo de revisión utilizado por el panel de comentarios de Acrobat.

Sintaxis

Delphi

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

Parámetros

TargetAnnot es el índice de base 1 de la anotación en la página seleccionada cuyo estado se está estableciendo. Author es el nombre del revisor almacenado en la entrada /T. StateModel selecciona el modelo de estado: 0 = Review, 1 = Marked. State selecciona el estado dentro del modelo. Para el modelo Review (Revisión): 0 = None, 1 = Accepted, 2 = Rejected, 3 = Cancelled, 4 = Completed. Para el modelo Marked (Marcado): 0 = Unmarked, 1 = Marked.

Valores devueltos

Devuelve el índice de base 1 de la anotación de estado recién agregada en la lista de anotaciones de la página, o 0 cuando se desconoce el selector de estado o modelo, cuando TargetAnnot no existe, o cuando la anotación de destino no se almacena como un objeto indirecto.

Observaciones

La anotación de estado se escribe con el indicador Oculto (Hidden) configurado, por lo que no se muestra en la página; en su lugar, los visores de PDF con soporte de revisión lo exponen en el panel de comentarios. Use GetAnnotState y GetAnnotStateModel para leer el estado registrado. Requiere PDF 1.5; la versión del documento se eleva automáticamente cuando es necesario.