pdfCreateMovieAction
Create a movie-control action (play/stop/pause/resume).
| Note | Lumas extension |
|---|
Purpose — Create a movie-control action (play/stop/pause/resume).
Description — Lumas extension, not part of the reference ABI: the reference API exposes a movie-action *getter* (pdfGetMovieAction) but no creator, so this engine adds one to give the getter real state to read. Registers action kind 13 with Operation in a and Title (the target movie annotation's title, used to identify which movie to control) in Text.
Declarations
int32_t __stdcall pdfCreateMovieAction(PPDF IPDF, const char* Title, int32_t Operation);
function pdfCreateMovieAction(const IPDF: PPDF; const Title: PAnsiChar; Operation: Integer): Integer; stdcall; external 'LumasPdf.dll';
Parameters
| Parameter | Type | Description |
|---|---|---|
IPDF | PPDF | Instance handle. |
Title | PAnsiChar | Title of the target movie annotation. |
Operation | Integer | 0=Play, 1=Stop, 2=Pause, 3=Resume. |
Return value — 1-based action handle (> 0), or 0 on an invalid handle.
Remarks — Because this is an engine addition rather than a LumasPDF-ABI function, do not assume a third-party binary exports it by this name; it is specific to LumasPDF.
C# (P/Invoke)
public static extern int pdfCreateMovieAction(IntPtr IPDF, [MarshalAs(UnmanagedType.LPStr)] string Title, int Operation);
Object Creation
pdfCreateMovieAction
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.