Starts a new page in a page-based graphics context.
- iOS 2.0+
- macOS 10.0+
- Mac Catalyst 13.0+Beta
- tvOS 9.0+
- watchOS 2.0+
- Core Graphics
A page-based graphics context such as a PDF context. If you specify a context that does not support multiple pages, this function does nothing.
A rectangle defining the bounds of the new page, expressed in units of the default user space, or
NULL. These bounds supersede any supplied for the media box when you created the context. If you pass
NULL, Core Graphics uses the rectangle you supplied for the media box when the graphics context was created.
When using a graphics context that supports multiple pages, you should call this function together with
CGContext to delineate the page boundaries in the output. In other words, each page should be bracketed by calls to
CGContext. Core Graphics ignores all drawing operations performed outside a page boundary in a page-based context.