Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Sets the tray name the plugin should select.

Component Version macOS Windows Linux Server iOS SDK
PrintDialog 6.1 ✅ Yes ❌ No ❌ No ❌ No ❌ No
MBS( "PrintDialog.SetTray"; Value )   More


Parameter Description Example
Value The name of the tray to use. "Tray1"


Returns OK or error.


Sets the tray name the plugin should select.
Value may be Tray1, Tray2, tray-1, tray-2, auto, Left, Right, Lower, Middle, Upper and depends on the printer driver. This is not the name displayed in dialog, but the internal value which is the same for all localization.
Same as using PrintDialog.SetOption with "InputSlot" as key and tray name as value.

Please print once with dialog to pick a tray and then query PrintDialog.GetLastSettings to lookup the internal tray name. Usually named InputSlot in the settings.

Warning: For some users the dialog loads last settings and overwrite this settings, so you may need to not show dialog.


Set Tray-2 as the tray for paper:

MBS("PrintDialog.SetTray"; "Tray-2")

See also

Blog Entries

This function checks for a license.

Created 10th February 2016, last changed 8th December 2022

PrintDialog.SetReverseOrder - Printer.CurrentNumberOfCopies