AddLineAnnotation

Anotaciones y enlaces de zona activa

Descripción

Añade una anotación de línea entre dos extremos con estilos distintos (flecha, cuadrado, círculo, rombo, …), RGB, opacidad y relleno opcional. Al emitir /CA, eleva documentos desbloqueados a PDF 1.4; los inferiores bloqueados fallan. 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 extremo inicial 'Start' de la línea, en las unidades actuales

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

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

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

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

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash

Los valores fuera del intervalo se limitan a 0 (None)

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

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

El valor /Rect de la anotación se calcula automáticamente a partir de los dos extremos más un relleno proporcional a la anchura 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 todo el dibujo visible; de lo contrario, las decoraciones de los extremos pueden recortarse

Este punto de entrada no emite los campos avanzados opcionales descritos por la especificación PDF — /LL (longitud de guía), /LLE, /LLO, /Cap, /CP, /CO y /Measure —. Se pueden añadir después de la creación escribiéndolos directamente en el diccionario de anotaciones

Para sobrescribir el color de la línea, el borde, el contenido o el rectángulo después de la creación, utilice SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents y SetAnnotRect