gi-gtk-4.0.10: Gtk bindings
CopyrightWill Thompson and Iñaki García Etxebarria
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellNone
LanguageHaskell2010

GI.Gtk.Interfaces.PrintOperationPreview

Description

GtkPrintOperationPreview is the interface that is used to implement print preview.

A GtkPrintOperationPreview object is passed to the PrintOperation::preview signal by PrintOperation.

Synopsis

Exported types

class (GObject o, IsDescendantOf PrintOperationPreview o) => IsPrintOperationPreview o Source #

Type class for types which can be safely cast to PrintOperationPreview, for instance with toPrintOperationPreview.

toPrintOperationPreview :: (MonadIO m, IsPrintOperationPreview o) => o -> m PrintOperationPreview Source #

Cast to PrintOperationPreview, for types for which this is known to be safe. For general casts, use castTo.

Methods

endPreview

printOperationPreviewEndPreview Source #

Arguments

:: (HasCallStack, MonadIO m, IsPrintOperationPreview a) 
=> a

preview: a GtkPrintOperationPreview

-> m () 

Ends a preview.

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

isSelected

printOperationPreviewIsSelected Source #

Arguments

:: (HasCallStack, MonadIO m, IsPrintOperationPreview a) 
=> a

preview: a GtkPrintOperationPreview

-> Int32

pageNr: a page number

-> m Bool

Returns: True if the page has been selected for printing

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

renderPage

printOperationPreviewRenderPage Source #

Arguments

:: (HasCallStack, MonadIO m, IsPrintOperationPreview a) 
=> a

preview: a GtkPrintOperationPreview

-> Int32

pageNr: the page to render

-> m () 

Renders a page to the preview.

This is using the print context that was passed to the PrintOperation::preview handler together with preview.

A custom print preview should use this function to render the currently selected page.

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

Signals

gotPageSize

type PrintOperationPreviewGotPageSizeCallback Source #

Arguments

 = PrintContext

context: the current GtkPrintContext

-> PageSetup

pageSetup: the GtkPageSetup for the current page

-> IO () 

Emitted once for each page that gets rendered to the preview.

A handler for this signal should update the context according to pageSetup and set up a suitable cairo context, using printContextSetCairoContext.

afterPrintOperationPreviewGotPageSize :: (IsPrintOperationPreview a, MonadIO m) => a -> ((?self :: a) => PrintOperationPreviewGotPageSizeCallback) -> m SignalHandlerId Source #

Connect a signal handler for the gotPageSize signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after printOperationPreview #gotPageSize callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onPrintOperationPreviewGotPageSize :: (IsPrintOperationPreview a, MonadIO m) => a -> ((?self :: a) => PrintOperationPreviewGotPageSizeCallback) -> m SignalHandlerId Source #

Connect a signal handler for the gotPageSize signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on printOperationPreview #gotPageSize callback

ready

type PrintOperationPreviewReadyCallback Source #

Arguments

 = PrintContext

context: the current GtkPrintContext

-> IO () 

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.

afterPrintOperationPreviewReady :: (IsPrintOperationPreview a, MonadIO m) => a -> ((?self :: a) => PrintOperationPreviewReadyCallback) -> m SignalHandlerId Source #

Connect a signal handler for the ready signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after printOperationPreview #ready callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onPrintOperationPreviewReady :: (IsPrintOperationPreview a, MonadIO m) => a -> ((?self :: a) => PrintOperationPreviewReadyCallback) -> m SignalHandlerId Source #

Connect a signal handler for the ready signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on printOperationPreview #ready callback