AddPolygonAnnotation
Anotaciones y enlaces de zona activa
Descripción
Añade una anotación poligonal cerrada (PDF /Subtype /Polygon) — los lectores unen el último vértice con el primero. Puede rellenarse; color y opacidad usan 0–1 y Transparency 0–100. Eleva a PDF 1.5 bajo un bloqueo inferior. 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 alternas x/y separadas por espacios, comas, punto y coma o tabuladores. "100 100 200 100 200 200 100 200" define un cuadrado. Requiere al menos dos pares y total par; si no, devuelve 0
BorderWidth — Anchura del trazo del contorno del polígono, en las unidades actuales
BorderRed, BorderGreen, BorderBlue — Componentes RGB (0–1) del color del contorno, escritos en /C
Filled — 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. 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 si se completa correctamente, 0 si no hay ningún documento seleccionado, no se puede analizar la cadena de vértices o 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 margen proporcional a la anchura del borde, de modo que el trazo del contorno permanezca dentro del cuadro delimitador de la anotación
Este punto de entrada no emite los campos avanzados opcionales descritos por la especificación PDF — /BE (efecto de borde, incluido el estilo de contorno nuboso), /IT (intención, incluidos PolygonCloud y PolygonDimension) y /Measure —. Se pueden añadir después de la creación escribiéndolos directamente en el diccionario de anotaciones
Para sobrescribir el color del contorno, el borde, el contenido o el rectángulo después de crearlos, utilice SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents y SetAnnotRect