AddSquareAnnotation

Anotaciones y enlaces de zonas interactivas

Descripción

Agrega una anotación de marcado rectangular (PDF /Subtype /Square) a la página seleccionada. La anotación dibuja un rectángulo con trazo inscrito en el rectángulo delimitador dado y, opcionalmente, puede rellenarse con un color interior sólido. 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 = completamente opaco, 100 = completamente transparente). Como este punto de entrada emite la clave de opacidad /CA de anotación de PDF 1.4, la biblioteca eleva a PDF 1.4 los documentos desbloqueados de nivel inferior antes de guardarlos; los objetivos inferiores bloqueados son rechazados por la puerta de compatibilidad. Definido 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 de anotación's, en unidades actuales

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

Ancho — Ancho del rectángulo de anotación

Altura — Altura del rectángulo de anotación

BorderWidth — Ancho 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

Relleno — 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 Ignorados cuando Filled es 0

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

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

Transparencia — Opacidad expresada como porcentaje transparente (0–100) La biblioteca convierte esto a PDF /CA = 1 - Transparencia/100 y lo limita al intervalo

Valor devuelto

1 si tiene éxito, 0 si no hay ningún documento seleccionado o no se pudo crear la anotación

Observaciones

La anotación se emite con un conjunto de campos de marcado estándar: /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 Adobe Acrobat y Foxit generan para sus herramientas de revisión de rectángulos, por lo que los flujos de trabajo de revisión externos pueden localizar, editar, comentar y responder a la anotación resultante

Para sobrescribir el rectángulo, color, contenido o borde de la anotación después de crearla, use SetAnnotRect, SetAnnotBorderColor, SetAnnotContents y SetAnnotBorderStyle