| 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