AddSWFAnnotationFromFileA
Vector graphics, Image handling, Annotations and hotspot links, Page layout
Description
The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to AddSWFAnnotationFromFile and string arguments are interpreted using the current SetAnsiMode code page
Adds a Flash SWF file as a screen annotation to the current page and wires it to a rendition action.
PDF version behaviour: this API writes the legacy PDF 1.5 multimedia model: a /Subtype /Screen annotation, a /S /Rendition action, media clip dictionaries, and an embedded file specification. If the current document version is lower and the save version is not locked, AddSWFAnnotationFromFile automatically raises the document to PDF 1.5 and records Screen/Rendition multimedia in AutoBumpedFeatures. It does not declare Adobe RichMedia extensions because it does not emit a /Subtype /RichMedia annotation. PDF/A modes reject this content before writing.
Syntax
Delphi
Function DLAddSWFAnnotationFromFileA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName, Title: PAnsiChar; Options: Integer): Integer;DLL
int DLAddSWFAnnotationFromFileA(int InstanceID, double Left, double Top, double Width, double Height, const char * FileName, const char * Title, int Options);Parameters
| Left | The horizontal co-ordinate of the left edge of the annotation rectangle |
|---|---|
| Top | The vertical co-ordinate of the top edge of the annotation rectangle |
| Width | The width of the annotation rectangle |
| Height | The height of the annotation rectangle. |
| FileName | The path and name of the SWF file. |
| Title | The annotation title |
| Options | Annotation event to activate SWF: 0 = Page visible 1 = Mouse enter 2 = Mouse button click |
Return values
| 0 | The specified file could not be found |
|---|---|
| 1 | The SWF was successfully added as an annotation |