AddPolyLineAnnotation

Anotaciones y enlaces de zonas interactivas

Descripción

Agrega una anotación de marcado de polilínea abierta (PDF /Subtype /PolyLine) a la página seleccionada con la lista de vértices proporcionada. La polilínea está abierta — los lectores no conectan el último vértice con el primero — y puede tener estilos de extremo de línea distintos en cada punto terminal. Las decoraciones de extremo que tienen interior (ClosedArrow, Square, Circle, Diamond) se pueden rellenar opcionalmente. Los componentes de color y la opacidad se expresan en una escala de 0–1; la transparencia se indica en una escala de 0–100 (0 = completamente opaco, 100 = completamente transparente). La biblioteca eleva la versión del documento a PDF 1.5 cuando se emite una anotación PolyLine con un bloqueo de versión mínima inferior. Definido en ISO 32000-1 §12.5.6.9

Sintaxis

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parámetros

VertexCoords — Coordenadas de los vértices como una sola cadena de valores x/y alternados separados por espacios, comas, puntos y comas o tabulaciones. Ejemplo: "100 100 200 150 300 100" define una forma de V. Requiere al menos dos pares (cuatro números) y un total par de números, de lo contrario la llamada devuelve 0

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

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

StartStyle, EndStyle — Estilos de extremo de línea para el primer y último vértice 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, si no se puede analizar la cadena de vértices o si no se pudo crear la anotación

Observaciones

La anotación /Rect se calcula automáticamente a partir de la extensión de los vértices más un relleno proporcional al ancho de borde, para que las decoraciones finales permanezcan dentro del cuadro delimitador de la anotación

Los campos avanzados opcionales descritos por la especificación PDF — /IT (intención, incluido PolyLineDimension) y /Measure — no se emiten mediante este punto de entrada. Se pueden agregar después de la creación escribiéndolos directamente en el diccionario de anotación

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