AddLinkToEmbeddedFile

Propiedades del documento, anotaciones y enlaces de zona activa

Descripción

Añade 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 en el PDF y obtener el EmbeddedFileID. AddLinkToEmbeddedFile crea la anotación de página, escribe el título del archivo adjunto y el contenido emergente, y dirige la anotación a la especificación de ese archivo incrustado

Comportamiento de versión 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 mediante /CA y recursos de transparencia, que requieren PDF 1.4. Si la versión actual 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 el llamador bloquea una versión inferior, la puerta 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
WidthLa anchura del rectángulo de anotación
HeightLa altura del rectángulo de anotación
EmbeddedFileIDEl valor devuelto por AddEmbeddedFile
TitleEl título del archivo adjunto que muestra el visor PDF
ContentsTexto mostrado en la ventana emergente de la anotación
IconTypeIcono de anotación: 0 = PushPin, 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 totalmente opaco; 100 hace invisible el icono

Valores devueltos

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

Véase también

AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount