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
| 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 | La anchura 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 archivo adjunto que muestra el visor PDF |
| Contents | Texto mostrado en la ventana emergente de la anotación |
| IconType | Icono 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 |
| Transparency | El porcentaje de transparencia de 0 a 100. Cero es totalmente opaco; 100 hace invisible el icono |
Valores devueltos
| 0 | El EmbeddedFileID no es válido, no hay ninguna página seleccionada o ningún documento activo |
|---|---|
| 1 | La anotación FileAttachment se creó correctamente |
Véase también
AddEmbeddedFile, AddFileAttachment, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount