Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.5   10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2    Statistic    FMM    Blog  

Printer.Print

Prints a document with options.

Component Version macOS Windows Linux Server iOS SDK
Printer 6.5 ❌ No ✅ Yes ❌ No ❌ No ❌ No
MBS( "Printer.Print"; Printer { ; CloseDialog; Number of Copies; Paper Format; Paper Orientation; Paper Source; Pages From; Pages To; Collate Pages; What } )   More

Parameters

Parameter Description Example Flags
Printer The printer name to set.
Must not match exactly, just the first letters.
If empty, we use current.
"Brother"
CloseDialog Whether to close print dialog.
Pass 1 to close or 0 to not close.
Pass 2 to press cancel button in case you just want to learn the options.
Pass 3 to leave dialog open.
1 Optional
Number of Copies The number of copies.
Leave empty to not change.
1 Optional
Paper Format The name of the paper format.
Leave empty to not change.
"A4" Optional
Paper Orientation The paper orientation.
Pass portrait or landscape. Empty value leaves setting as is.
"landscape" Optional
Paper Source The paper source.
Pass name of setting. Name doesn't need to match exactly, just first letters.
So you can pass "Man" für Manual (English) and Manuell (German).
"Man" Optional
Pages From The start number of page range.
Pass empty text for Pages From and To to select all pages.
1 Optional
Pages To The end number of page range.
Pass empty text for Pages From and To to select all pages.
1 Optional
Collate Pages Whether to collate pages.
Pass 1 to enable or 0 to disable.
Other values are ignored, so pass -1 to leave existing value.
1 Optional
What What to print:
Pass 0 for records being browsed.
Pass 1 for current record.
Pass 2 for Blank Record showing fields.
Default is empty (or -1) to keep current setting.
0 Optional

Result

Returns OK or error.

Description

Prints a document with options.
The plugin will show the print dialog from FileMaker, automatically set options and close dialog if requested. Sub dialog for paper is opened if paper format, paper orientation or source is passed.
The function returns before the dialog shows, so please do a script pause after calling this.

This function requires the permissions for current user to print and the print menu commands be available via menu as we trigger those to print.

You can later call Print.ErrorLog to detect errors. If Windows ever change dialogs, features may no longer work. FileMaker may not show the print dialog if there is no record available or when debugger is open.

For Mac, please check PrintDialog.Install function.
To print on a server, you can create a PDF document and send it to printer via DynaPDF.Print or PDFKit.Print functions.

After calling this method, you can call Printer.PaperFormats, Printer.PaperSources or Printer.PrinterNames to learn what was available.

Version 9.1 or newer allows you to pass 3 for CloseDialog parameter to leave dialog open while sub dialog is closed.

Original source code sponsored by schubec.com
http://www.schubec.com

Examples

Print:

Set Variable [$r; Value:MBS("Printer.Print"; Printer Dialog::Printer Name; Printer Dialog::Close Dialog; Printer Dialog::Number of Copies; Printer Dialog::Paper Format; Printer Dialog::Paper Orientation; Printer Dialog::Paper Source; Printer Dialog:…]
Pause/Resume Script [Duration (seconds): 2]
Show Custom Dialog ["Result"; MBS("Printer.ErrorLog")]

Install special print menu with print command:

# set a menu with print commands, so the print works
Install Menu Set [ “[Print]” ; Use as file default: Off ]
# now let the plugin print
Set Variable [ MBS ("Printer.Print") ]
# wait
Pause/Resume Script [Duration (seconds): 2]
# and restore custom menus
Install Menu Set [ “[Standard Menu]” ; Use as file default: On ]

See also

Release notes

Example Databases

Blog Entries

FileMaker Magazin

Created 14th November 2016, last changed 5th January 2021


Printer.PaperSources - Printer.PrinterCount

Feedback: Report problem or ask question.




Links
MBS FileMaker tutorial videos

Start Chat