AddSquareAnnotation

Anotaciones y enlaces de zona activa

Descripción

Añade una anotación de marcado rectangular (PDF /Subtype /Square) a la página seleccionada. La anotación dibuja un rectángulo trazado inscrito en el rectángulo delimitador indicado y puede rellenarse opcionalmente con un color interior sólido. Los componentes de color y la opacidad se expresan en una escala de 0–1; Transparency se expresa en una escala de 0–100 (0 = totalmente opaco, 100 = totalmente transparente). Como este punto de entrada emite la clave de opacidad /CA de anotación PDF 1.4, la biblioteca eleva los documentos inferiores desbloqueados a PDF 1.4 antes de guardarlos; la puerta de compatibilidad rechaza los destinos inferiores bloqueados. Se define en ISO 32000-1 §12.5.6.8

Sintaxis

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: 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

BorderWidth — Anchura del trazo del borde del rectángulo, en las unidades actuales. Se escribe tanto en el campo heredado /Border como en el diccionario de estilo de borde /BS

BorderRed, BorderGreen, BorderBlue — Componentes RGB (0–1) del color de trazo, escritos en /C

Filled — 1 para emitir un color de relleno interior (/IC), 0 para dejar el rectángulo sin rellenar

FillRed, FillGreen, FillBlue — componentes RGB (0–1) del color de relleno interior. Se omiten cuando Filled es 0

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 un conjunto estándar de campos de marcado: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (cuando Filled), /BS, /Border, /CA, /F = 4 (imprimible), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Esto coincide con lo que producen Adobe Acrobat y Foxit para sus herramientas de revisión de rectángulos, por lo que los flujos de revisión externos pueden localizar, editar, comentar y responder a la anotación resultante

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