API reference › PDF/X & Prepress
pdfGetTrapped
Get/set the document /Info /Trapped flag (True/False,
BOOL32 __stdcall pdfGetTrapped(PPDF IPDF);
void __stdcall pdfSetTrapped(PPDF IPDF, BOOL32 Value);
function pdfGetTrapped(const IPDF: PPDF): LongBool; stdcall;
procedure pdfSetTrapped(const IPDF: PPDF; Value: LongBool); stdcall;
Purpose. Get/set the document /Info /Trapped flag (True/False, serialized as the PDF name /True//False) — signals to downstream prepress tooling and PDF/X validators whether color trapping has already been applied to this file.
Description. A plain boolean field (FIsTrapped); this SDK does not itself perform any trapping operation (no automatic trap-generation feature exists in this API surface) — this flag is purely a metadata declaration for external tooling to trust or verify, matching the PDF spec's own definition of /Trapped as an informational flag, not an instruction.
Parameters.
| Parameter | Description |
|---|---|
IPDF | Document handle. |
Value | *(Set only)* New trapped-state flag. |
Return value. pdfGetTrapped: the current flag state (False by default).
C# (P/Invoke)
[return: MarshalAs(UnmanagedType.Bool)]
Getters
pdfGetTrapped
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.