AddCircleAnnotation

Anotaciones y enlaces de zonas interactivas

Descripción

Agrega una anotación de marcado de elipse (PDF /Subtype /Circle) inscrita en el rectángulo dado. A pesar del nombre, la anotación es una elipse completa y solo se representa como un círculo verdadero cuando Width es igual a Height. La anotación se puede rellenar opcionalmente con un color interior sólido. Los componentes de color y la opacidad se expresan en una escala de 0–1; la transparencia se da 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 PDF 1.4, la biblioteca eleva los documentos inferiores desbloqueados a PDF 1.4 antes de guardar; los destinos inferiores bloqueados se rechazan mediante la puerta de compatibilidad. Definido en ISO 32000-1 §12.5.6.8

Sintaxis

Delphi

Function TPDFlib.AddCircleAnnotation(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

Izquierda — Coordenada horizontal de la esquina inferior izquierda del rectángulo delimitador's, en unidades actuales

Top — Coordenada vertical de la esquina inferior izquierda del rectángulo delimitador's, en las unidades actuales

Width — Ancho del rectángulo delimitador

Altura — Altura del rectángulo delimitador

BorderWidth — Ancho de trazo del borde de la elipse, 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 la elipse sin relleno

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

Para reemplazar el rectángulo delimitador, color, contenido o borde después de crearlo, use SetAnnotRect, SetAnnotBorderColor, SetAnnotContents y SetAnnotBorderStyle