AddPolygonAnnotation

Anotaciones y enlaces de zonas interactivas

Descripción

Agrega una anotación de marcado de polígono cerrado (PDF /Subtype /Polygon) a la página seleccionada con la lista de vértices proporcionada; el polígono se cierra implícitamente — los lectores conectan el último vértice con el primero al renderizar; la forma puede rellenarse 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); la biblioteca eleva la versión del documento a PDF 1.5 cuando se emite una anotación Polygon con un bloqueo de versión mínima inferior; definido en ISO 32000-1 §12.5.6.9

Sintaxis

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parámetros

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

BorderWidth — Ancho de trazo del contorno del polígono, en las unidades actuales

BorderRed, BorderGreen, BorderBlue — componentes RGB (0–1) del color de contorno, escritos en /C

Relleno — 1 para emitir un color de relleno interior (/IC) para el cuerpo del polígono, 0 para dejarlo 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, si no se puede analizar la cadena de vértices o si no se pudo crear la anotación

Observaciones

El /Rect de la anotación se calcula automáticamente a partir de la extensión de los vértices más un pequeño relleno proporcional al ancho del borde, de modo que el trazo del contorno permanezca dentro del cuadro delimitador de la anotación

Los campos avanzados opcionales descritos por la especificación PDF — /BE (efecto de borde, incluido el estilo de contorno nublado), /IT (intención, incluidos PolygonCloud y PolygonDimension) 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 sobrescribir el color del contorno, el borde, el contenido o el rectángulo después de crearlo, use SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents y SetAnnotRect