BOOL32 __stdcall rasAppend(IPGC CachePtr);
function rasAppend(CachePtr: IPGC): LongBool; stdcall;
Purpose. Append a page slot to the cache's tracked page count.
Description. Minimal but genuinely real, per an inline comment ("Minimal but real: it resolves the cache and advances the appended-page counter (the tile renderer materialises page rasters lazily on demand)."): increments C.AppendedPages. There is no eager rendering or page-content creation here — the actual new page must already exist in the underlying document (e.g. via the document-level page-creation APIs); this call only updates the cache's own bookkeeping counter, which downstream tile/paint logic consults to know a new page slot exists.
Parameters.
| Parameter | Description |
|---|---|
CachePtr | Target page cache. |
Return value. True if CachePtr resolves; the NotImplLogB failure path otherwise (despite the function being real once a valid cache is supplied — the failure path is purely for the invalid-handle case).
C# (P/Invoke)
[return: MarshalAs(UnmanagedType.Bool)]
Rasterizer/Rendering
rasAppend
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.