AddCaretAnnotation

Anotaciones y enlaces de zona activa

Descripción

Añade una anotación de marcado de intercalación (PDF /Subtype /Caret) a la página seleccionada. Una anotación de intercalación es un símbolo visual que, por convención, marca una posición de la página donde se ha insertado u omitido texto o contenido, o que requiere de algún otro modo la atención del revisor. Hay disponibles dos formas de símbolo: una marca de intercalación sencilla (None) o una marca de párrafo (Paragraph). Los componentes de color y la opacidad se expresan en una escala de 0–1; Transparency se indica en una escala de 0–100 (0 = totalmente opaco, 100 = totalmente transparente). La biblioteca eleva la versión del documento a PDF 1.5 cuando se emite una anotación Caret con un bloqueo de versión mínima inferior. Se define en ISO 32000-1 §12.5.6.11

Sintaxis

Delphi

Function TPDFlib.AddCaretAnnotation(Left, Top, Width, Height: Double; SymbolType: Integer; ColorRed, ColorGreen, ColorBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parámetros

Left — Coordenada horizontal de la esquina inferior izquierda del rectángulo's de anotación, en las unidades actuales

Top — Coordenada vertical de la esquina inferior izquierda del rectángulo de anotación (‘esquina inferior izquierda del rectángulo de anotación'), en las unidades actuales

Width — Anchura del rectángulo de anotación

Height — Altura del rectángulo de anotación

SymbolType — Estilo del símbolo Caret:

0 = Ninguno (signo de intercalación sencillo "^")

1 = Párrafo (calderón "¶")

Cualquier otro valor se trata como 0 (Ninguno)

ColorRed, ColorGreen, ColorBlue — Componentes RGB (0–1) del color del signo de intercalación, escritos en /C

Title — Nombre del autor escrito en la entrada /T de la anotación (‘entrada /T de la anotación'). Pase una cadena vacía para omitirlo

Contents — Cuerpo de la ventana emergente asociada a la anotación. Pase una cadena vacía para omitirlo

Transparency — Opacidad expresada como porcentaje de transparencia (0–100). La biblioteca la convierte en PDF /CA = 1 - Transparency/100 y la limita al intervalo

Valor devuelto

1 en caso de éxito, 0 si no hay ningún documento seleccionado o no se ha podido crear la anotación

Observaciones

La anotación se emite con /Type /Annot, /Subtype /Caret, /Rect, /Sy (el nombre del símbolo), /C, /CA, /F = 4 (imprimible), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Caret" y /P. El campo /RD opcional (desplazamiento del signo de intercalación dentro de /Rect) no se emite; los lectores utilizan de forma predeterminada todo ceros para que el signo ocupe todo el rectángulo de anotación

Para sobrescribir rectángulo, color o contenido, use SetAnnotRect, SetAnnotBorderColor y SetAnnotContents