Platforms to show: All Mac Windows Linux Cross-Platform

Back to Graphics class.

Graphics.WinStartPageMBS as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Printing Windows MBS Win Plugin 12.1 ❌ No ✅ Yes ❌ No ❌ No Desktop only
The StartPage function prepares the printer driver to accept data.

Returns true on success.

This is a blocking or synchronous function and might not return immediately. How quickly this function returns depends on run-time factors such as network status, print server configuration, and printer driver implementation-factors that are difficult to predict when writing an application. Calling this function from a thread that manages interaction with the user interface could make the application appear to be unresponsive.

The system disables the WinApplyDevModeMBS function between calls to the StartPage and EndPage functions. This means that you cannot change the device mode except at page boundaries. After calling EndPage, you can call WinApplyDevModeMBS to change the device mode, if necessary. Note that a call to WinApplyDevModeMBS resets all device context attributes back to default values.

Neither EndPage nor StartPage resets the device context attributes. Device context attributes remain constant across subsequent pages. You do not need to re-select objects and set up the mapping mode again before printing the next page; however, doing so will produce the same results and reduce code differences between versions of Windows.

Does not work for Xojo 2016r4 and newer due to switch to DirectDraw for printing.

Some examples using this method:

Blog Entries

The items on this page are in the following plugins: MBS Win Plugin.


The biggest plugin in space...