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

PrintDialog.SetOption

Sets an option.

Component Version macOS Windows Linux Server iOS SDK
PrintDialog 6.2 ✅ Yes ❌ No ❌ No ❌ No ❌ No
MBS( "PrintDialog.SetOption"; Key; Value { ; Type } )   More

Parameters

Parameter Description Example Flags
Key The key to use. "com_apple_print_PrintSettings_PMCopies"
Value The value to use.
Depending on data type, the plugin will pass a number or a text.
3
Type Available in MBS FileMaker Plugin 9.2 or newer.
The type of data to add.
Default is empty to use type of value passed. So text or number type would be picked automatically.
Valid values for type are text, number, integer and text.
Integer is for integer numbers while number is for floating numbers.
Optional

Result

Returns OK or error.

Description

Sets an option.
You can use PrintDialog.GetLastSettings after printing to query XML with all settings and pick keys and values.

When you are done after printing, you may use PrintDialog.ClearOptions to clear options for next print.

Examples

Set copies to 3 via options:

MBS("PrintDialog.SetOption"; "com_apple_print_PrintSettings_PMCopies"; 3)

Set border to double hairline:

MBS("PrintDialog.SetOption"; "com_apple_print_PrintSettings_PMBorderType"; 2)

Set border to single hairline:

MBS("PrintDialog.SetOption"; "com_apple_print_PrintSettings_PMBorderType"; 1)

Set duplex binding:

MBS("PrintDialog.SetOption"; "com_apple_print_PrintSettings_PMDuplexing"; 2) &
MBS("PrintDialog.SetOption"; "DuplexBindingEdge"; 2)

Set input slot and output bin:

MBS("PrintDialog.SetOption"; "InputSlot"; "4Tray") &
MBS("PrintDialog.SetOption"; "OutputBin"; "MailBoxBin7")
# those keys and values are print driver dependent and hand picked from configuration XML.

Set media type and quality for a HP printer:

// Set Variable [ $r ; Value: MBS( "PrintDialog.SetOption"; "MediaType"; "com.hp.rough") ]
// Set Variable [ $r ; Value: MBS( "PrintDialog.SetOption"; "cupsPrintQuality"; "Draft") ]

Set Variable [ $r ; Value: MBS( "PrintDialog.SetOption"; "MediaType"; "com.hp.recycled") ]
Set Variable [ $r ; Value: MBS( "PrintDialog.SetOption"; "cupsPrintQuality"; "Normal") ]

See also

Release notes

Blog Entries

This function checks for a license.

Created 30th April 2016, last changed 13th January 2024


PrintDialog.SetNoDialog - PrintDialog.SetPageNumberingOffset