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
| Left | La coordenada horizontal del borde izquierdo del rectángulo de anotación |
|---|---|
| Top | La coordenada vertical del borde superior del rectángulo de anotación |
| Width | El ancho del rectángulo de anotación |
| Height | La altura del rectángulo de anotación |
| EmbeddedFileID | El valor devuelto por AddEmbeddedFile |
| Title | El título del adjunto que muestra el visor de PDF |
| Contents | El texto mostrado en la ventana emergente de la anotación |
| IconType | El 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 |
| Transparency | El porcentaje de transparencia de 0 a 100 Cero es completamente opaco; 100 vuelve invisible el icono |
Valores devueltos
| 0 | El EmbeddedFileID no es válido, no hay una página seleccionada o no hay un documento activo |
|---|---|
| 1 | La anotación FileAttachment se creó correctamente |
Véase también
AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount