AddLinkToEmbeddedFile

Propiedades del documento, anotaciones y enlaces de zona activa

Descripción

Agrega un rectángulo de anotación FileAttachment a la página seleccionada y lo vincula a un archivo incrustado ya almacenado en el documento

Llame primero a AddEmbeddedFile para copiar los bytes del archivo al PDF y obtener el EmbeddedFileID. AddLinkToEmbeddedFile crea la anotación de página, escribe el título del adjunto y el contenido emergente, y dirige la anotación a esa especificación de archivo incrustado

Comportamiento de la versión de PDF: las anotaciones FileAttachment y los flujos de archivos incrustados requieren PDF 1.3. La apariencia de anotación generada por esta función puede incluir opacidad de anotación mediante /CA y recursos de transparencia, que requieren PDF 1.4. Si la versión actual del documento es inferior y la versión de guardado no está bloqueada, AddLinkToEmbeddedFile eleva automáticamente el documento a PDF 1.4 y registra /CA annotation opacity en AutoBumpedFeatures. Si quien llama bloquea una versión de guardado inferior, la compuerta de compatibilidad rechaza el guardado con LastErrorCode 602

Sintaxis

Delphi

Function TPDFlib.AddLinkToEmbeddedFile(Left, Top, Width, Height: Double; EmbeddedFileID: Integer; Const Title, Contents: WideString; IconType, Transparency: Integer): Integer;

ActiveX

Function PDFlib::AddLinkToEmbeddedFile(Left As Double, Top As Double, Width As Double, Height As Double, EmbeddedFileID As Long, Title As String, Contents As String, IconType As Long, transpareny As Long) As Long

DLL

int DLAddLinkToEmbeddedFile(int InstanceID, double Left, double Top, double Width, double Height, int EmbeddedFileID, const wchar_t * Title, const wchar_t * Contents, int IconType, int transpareny);

Parámetros

LeftLa coordenada horizontal del borde izquierdo del rectángulo de anotación
TopLa coordenada vertical del borde superior del rectángulo de anotación
WidthEl ancho del rectángulo de anotación
HeightLa altura del rectángulo de anotación
EmbeddedFileIDEl valor devuelto por AddEmbeddedFile
TitleEl título del adjunto que muestra el visor de PDF
ContentsEl texto mostrado en la ventana emergente de la anotación
IconTypeEl icono de anotación: 0 = chincheta, 1 = imagen de disco, 2 = sin icono, 3 = gráfico, 4 = clip, 5 = etiqueta, 6 = rectángulo blanco sólido
TransparencyEl porcentaje de transparencia de 0 a 100 Cero es completamente opaco; 100 vuelve invisible el icono

Valores devueltos

0El EmbeddedFileID no es válido, no hay una página seleccionada o no hay un documento activo
1La anotación FileAttachment se creó correctamente

Véase también

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount