Signal
Gtk.PrintOperation::preview
Declaration
gboolean
preview (
GtkPrintOperation self,
GtkPrintOperationPreview* preview,
GtkPrintContext* context,
GtkWindow* parent,
gpointer user_data
)
Description [src]
Gets emitted when a preview is requested from the native dialog.
The default handler for this signal uses an external viewer application to preview.
To implement a custom print preview, an application must return
TRUE
from its handler for this signal. In order to use the
provided context
for the preview implementation, it must be
given a suitable cairo context with
gtk_print_context_set_cairo_context()
.
The custom preview implementation can use
gtk_print_operation_preview_is_selected()
and
gtk_print_operation_preview_render_page()
to find pages which
are selected for print and render them. The preview must be
finished by calling gtk_print_operation_preview_end_preview()
(typically in response to the user clicking a close button).
Default handler: | The default handler is called after the handlers added via |
Parameters
preview |
GtkPrintOperationPreview |
the |
|
Ownership is not transferred to the callee | |
context |
GtkPrintContext |
the |
|
Ownership is not transferred to the callee | |
parent |
GtkWindow |
the |
|
Can be NULL | |
Ownership is not transferred to the callee |