API referenceCore SDK

pdfGetObjEvent

Read one node of a per-object action-event linked list

C
BOOL32 __stdcall pdfGetObjEvent(IEVT IEvent, TPDFObjEvent* Event);
Delphi
function pdfGetObjEvent(const IEvent: IEVT; var Event: TPDFObjEvent): LongBool; stdcall;

Purpose. Read one node of a per-object action-event linked list (IEVT, the event-node handle minted by pdfGetObjActions, Action Getters) — Action/ActionType/Event/Next (the next node's handle, for walking the list).

Description. Note the significant caveat documented in Action Getters: pdfGetObjActions — the only function in this SDK that mints IEVT handles for this getter to consume — has a verified unbounded memory leak: every extra attached action produces one heap-allocated PLumasObjEvtNode, and there is no Dispose call anywhere in the codebase to free them. This getter itself is a simple, correct field readback; the leak is entirely on the minting side.

Parameters.

ParameterDescription
IEventAn event-node handle from pdfGetObjActions.
EventOutput: the node's Action/ActionType/Event/Next fields.

Return value. True if IEvent is non-null; False if it is nil.

See also. pdfGetObjActions (the leaking minting side).

C# (P/Invoke)

wrappers/dotnet/LumasPdf.cs
[return: MarshalAs(UnmanagedType.Bool)]
Area
Core SDK
Category

Getters

Exported names

pdfGetObjEvent

String variants

The …A form takes UTF-8, …W takes UTF-16; a bare name aliases the ANSI form.

See working code

Worked examples — complete programs in ten languages.