Gtk.PrintOperation::preview
Description: Reference for signal Gtk.PrintOperation::preview

### 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 `g_signal_connect()`.

#### 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.

  The argument can be `NULL`.
  The data is owned by the caller of the function.

#### Return value

Type: `gboolean`

`TRUE` if the listener wants to take over control of the preview.