IPrint::SetInitialPageNum

Sets the number of the first page of a document.

HRESULT SetInitialPageNum(
  LONG nFirstPage  //Number of first page
);
 

Parameters

nFirstPage
[in] The desired first page number

Return Value

This method supports the standard return values E_FAIL and E_UNEXPECTED, as well as the following:

S_OK
The number of the first page was set as requested.

Remarks

Setting the first page to a negative number is valid. This may be useful in printing a portion of the document with page numbers that specify an offset from the usual pagination.

Not all implementations permit the initial page number to be set, as some implementations simply lack the information as to how the page number should be presented in the final output.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in docobj.h.