gtkPrintOperationRun {RGtk2} | R Documentation |
Runs the print operation, by first letting the user modify print settings in the print dialog, and then print the document.
gtkPrintOperationRun(object, action, parent = NULL, .errwarn = TRUE)
|
[GtkPrintOperation ] a GtkPrintOperation |
|
[GtkPrintOperationAction ] the action to start |
|
[GtkWindow ] Transient parent of the dialog, or NULL |
.errwarn |
Whether to issue a warning on error or fail silently |
Normally that this function does not return until the rendering of all
pages is complete. You can connect to the
::status-changed
signal on op
to obtain some
information about the progress of the print operation.
Furthermore, it may use a recursive mainloop to show the print dialog.
If you call gtkPrintOperationSetAllowAsync
or set the allow-async
property the operation will run asyncronously if this is supported on the
platform. The ::done
signal will be emitted with the
operation results when the operation is done (i.e. when the dialog is
canceled, or when the print succeeds or fails).
if (!is.null(settings)) op$setPrintSettings(settings) if (!is.null(page_setup)) op$setDefaultPageSetup(page_setup) gSignalConnect(op, "begin-print", begin_print) gSignalConnect(op, "draw-page", draw_page) res <- op$run("print-dialog", parent) if (res[[1]] == "error") { error_dialog = gtkMessageDialog(parent, "destroy-with-parent", "error", "close", "Error printing file: ", res$error$message) gSignalConnect(error_dialog, "response", gtkWidgetDestroy) error_dialog$show() } else if (res[[1]] == "apply") settings = op$getPrintSettings()
Note that gtkPrintOperationRun
can only be called once on a
given GtkPrintOperation
.
Since 2.10
A list containing the following elements:
retval |
[GtkPrintOperationResult ] the result of the print operation. A return value of
GTK_PRINT_OPERATION_RESULT_APPLY indicates that the printing was
completed successfully. In this case, it is a good idea to obtain
the used print settings with gtkPrintOperationGetPrintSettings
and store them for reuse with the next print operation. A value of
GTK_PRINT_OPERATION_RESULT_IN_PROGRESS means the operation is running
asynchronously, and will emit the ::done signal when done. |
|
[GError ] Return location for errors, or NULL |
Derived by RGtkGen from GTK+ documentation