Gtk.PrintOperationPreview¶

Implementations:: Gtk.PrintOperation

Methods¶

	`end_preview` ()
	`is_selected` (page_nr)
	`render_page` (page_nr)

Virtual Methods¶

	`do_end_preview` ()
	`do_got_page_size` (context, page_setup)
	`do_is_selected` (page_nr)
	`do_ready` (context)
	`do_render_page` (page_nr)

Properties¶

None

Signals¶

Name	Short Description
`got-page-size`	The `::got-page-size` signal is emitted once for each page that gets rendered to the preview.
`ready`	The `::ready` signal gets emitted once per preview operation, before the first page is rendered.

Fields¶

None

Class Details¶

class Gtk.PrintOperationPreview¶

Bases:: GObject.GInterface
Structure:: Gtk.PrintOperationPreviewIface

end_preview()[source]¶

Ends a preview.

This function must be called to finish a custom print preview.

New in version 2.10.

is_selected(page_nr)[source]¶

Parameters:: page_nr (int) – a page number
Returns:: True if the page has been selected for printing
Return type:: bool

Returns whether the given page is included in the set of pages that have been selected for printing.

New in version 2.10.

render_page(page_nr)[source]¶

Parameters:: page_nr (int) – the page to render

Renders a page to the preview, using the print context that was passed to the Gtk.PrintOperation ::preview handler together with self.

A custom iprint preview should use this function in its ::expose handler to render the currently selected page.

Note that this function requires a suitable cairo context to be associated with the print context.

New in version 2.10.

do_end_preview() virtual¶

Ends a preview.

This function must be called to finish a custom print preview.

New in version 2.10.

do_got_page_size(context, page_setup) virtual¶

Parameters:

context (Gtk.PrintContext) –
page_setup (Gtk.PageSetup) –

do_is_selected(page_nr) virtual¶

Parameters:: page_nr (int) – a page number
Returns:: True if the page has been selected for printing
Return type:: bool

Returns whether the given page is included in the set of pages that have been selected for printing.

New in version 2.10.

do_ready(context) virtual¶

Parameters:: context (Gtk.PrintContext) –

do_render_page(page_nr) virtual¶

Parameters:: page_nr (int) – the page to render

Renders a page to the preview, using the print context that was passed to the Gtk.PrintOperation ::preview handler together with preview.

A custom iprint preview should use this function in its ::expose handler to render the currently selected page.

Note that this function requires a suitable cairo context to be associated with the print context.

New in version 2.10.

Signal Details¶

Gtk.PrintOperationPreview.signals.got_page_size(print_operation_preview, context, page_setup)¶

Signal Name:

got-page-size

Flags:

RUN_LAST

Parameters:

print_operation_preview (Gtk.PrintOperationPreview) – The object which received the signal
context (Gtk.PrintContext) – the current Gtk.PrintContext
page_setup (Gtk.PageSetup) – the Gtk.PageSetup for the current page

The ::got-page-size signal is emitted once for each page that gets rendered to the preview.

A handler for this signal should update the context according to page_setup and set up a suitable cairo context, using Gtk.PrintContext.set_cairo_context().

Gtk.PrintOperationPreview.signals.ready(print_operation_preview, context)¶

Signal Name:

ready

Flags:

RUN_LAST

Parameters:

print_operation_preview (Gtk.PrintOperationPreview) – The object which received the signal
context (Gtk.PrintContext) – the current Gtk.PrintContext

The ::ready signal gets emitted once per preview operation, before the first page is rendered.

A handler for this signal can be used for setup tasks.