Signal
GtkPrintOperation::preview
since: 2.10
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 |
Available since: 2.10 |
Parameters
preview
-
Type:
GtkPrintOperationPreview
The
GtkPrintOperationPreview
for the current operation.The data is owned by the caller of the function. context
-
Type:
GtkPrintContext
The
GtkPrintContext
that will be used.The data is owned by the caller of the function. parent
-
Type:
GtkWindow
The
GtkWindow
to use as window parent, orNULL
.The argument can be NULL
.The data is owned by the caller of the function.