AddLineAnnotation

Anotaciones y enlaces de zonas interactivas

Descripción

Agrega una anotación de marcado de línea (PDF /Subtype /Line) entre dos puntos finales de la página seleccionada Cada extremo puede tener un estilo de terminación distinto (flecha, cuadrado, círculo, diamante, …) y el cuerpo de la línea se puede dibujar en cualquier color RGB con opacidad configurable Las decoraciones de los extremos que tienen interior (ClosedArrow, Square, Circle, Diamond) se pueden rellenar opcionalmente Como este punto de entrada emite la clave de opacidad /CA de anotación PDF 1.4, la biblioteca eleva los documentos desbloqueados de menor versión a PDF 1.4 antes de guardar; los destinos bloqueados de menor versión son rechazados por la puerta de compatibilidad Definido en ISO 32000-1 §12.5.6.7

Sintaxis

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parámetros

StartLeft, StartTop — Coordenadas del punto inicial de la línea, en las unidades actuales'

EndLeft, EndTop — Coordenadas del punto final de la línea's, en las unidades actuales

BorderWidth — Grosor del trazo de la línea y sus decoraciones finales, en las unidades actuales

LineRed, LineGreen, LineBlue — Componentes RGB (0–1) del color de línea, escritos en /C

StartStyle, EndStyle — Estilos de terminación de línea para los extremos inicial y final respectivamente Use uno de los siguientes:

0 = Ninguno, 1 = Cuadrado, 2 = Círculo, 3 = Diamante, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash

Los valores fuera de rango se ajustan a 0 (None)

Relleno — 1 para emitir un color de relleno interior (/IC) para las decoraciones de extremo, 0 para dejarlas sin relleno

FillRed, FillGreen, FillBlue — componentes RGB (0–1) del color de relleno interior de la decoración final Se ignora 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

El /Rect de la anotación se calcula automáticamente a partir de los dos puntos finales más un relleno proporcional al ancho del borde, para que las decoraciones de los extremos permanezcan dentro del cuadro delimitador de la anotación Los lectores PDF requieren que el /Rect delimitador contenga la totalidad del dibujo visible o las decoraciones de los extremos pueden recortarse

Los campos avanzados opcionales descritos por la especificación PDF — /LL (longitud de guía), /LLE, /LLO, /Cap, /CP, /CO y /Measure — no se emiten mediante este punto de entrada. Pueden agregarse después de crearlos escribiéndolos directamente en el diccionario de anotaciones

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