API referenceCore SDK

pdfGetPageObject

Obtain the opaque page object handle (IPGE) for a page, for

Exported namespdfGetPageObject
Calling conventionstdcall
Thread safetyOne PPDF/handle per thread; see V18 §Threading
IntroducedLumasPDF 1.0

Purpose — Obtain the opaque page object handle (IPGE) for a page, for use with the page-object APIs.

Description — Looks the page up by its 1-based number in the document's page list and returns a pointer-sized handle identifying that page object. The handle stays valid for the life of the page (it is invalidated by deleting the page or the document) and is what the IPGE-taking functions such as pdfGetPageOrientation operate on. No state is changed by this call.

Declarations

C
IPGE __stdcall pdfGetPageObject(PPDF IPDF, uint32_t PageNum);
Delphi
function pdfGetPageObject(const IPDF: PPDF; PageNum: Cardinal): IPGE; stdcall; external 'LumasPdf.dll';

Parameters

ParameterTypeIn/OutDescription
IPDFPPDFinInstance handle with an open document.
PageNumCardinalin1-based page number.

Return value — The page's IPGE handle, or NULL when the instance handle is invalid or PageNum is out of range (less than 1 or greater than the page count).

See alsopdfDeletePage, pdfDeletePageLGIDict, pdfDeletePageLabels, pdfGetPageBBox, pdfGetPageLGIDictContent, pdfGetPageLGIDictCount, pdfGetPageMetricsToString, pdfSetPageThumbnail

C# (P/Invoke)

wrappers/dotnet/LumasPdf.cs
public static extern IntPtr pdfGetPageObject(IntPtr IPDF, uint PageNum);
Area
Core SDK
Category

Getters

Exported names

pdfGetPageObject

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.