| Category | Extended color space (non-functional) |
|---|---|
| Availability | Non-functional (write-only) — see the chapter note above |
Purpose — Nominally: set the "current" extended color space handle.
Description — Stores Handle into FExtColorSpaceH and always returns TRUE, with no validation. That field is never read elsewhere in the codebase — this call has no effect on any drawing operation or serialized output.
Declarations
BOOL32 __stdcall pdfSetExtColorSpace(PPDF IPDF, uint32_t Handle);
function pdfSetExtColorSpace(const IPDF: PPDF; Handle: Cardinal): LongBool; stdcall; external 'LumasPdf.dll';
Parameters
| Parameter | Type | Description |
|---|---|---|
IPDF | PPDF | Instance handle. |
Handle | Cardinal | Accepted and stored; has no effect on output. |
Return value — Always TRUE on a valid handle; FALSE on an invalid IPDF. The success return gives no indication of the no-op behavior.
Remarks — For color spaces that actually affect output, use pdfSetFillColorSpace/pdfSetStrokeColorSpace (not in this chapter) or the concrete color-setting calls (pdfSetFillColor, pdfSetSeparationColor, etc.) that write real content-stream color operators.
See also — pdfSetExtFillColorSpace, pdfSetExtStrokeColorSpace
C# (P/Invoke)
[return: MarshalAs(UnmanagedType.Bool)]
Setters
pdfSetExtColorSpace
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.