GI.WebKit2.Objects.PrintOperation

No description available in the introspection data.

Exported types

newtype PrintOperation

Memory-managed wrapper type.

Constructors

PrintOperation (ManagedPtr PrintOperation)

Instances

GObject PrintOperation

Methods

gobjectType :: PrintOperation -> IO GType

IsObject PrintOperation

IsPrintOperation PrintOperation

class GObject o => IsPrintOperation o

Type class for types which can be safely cast to PrintOperation, for instance with toPrintOperation.

Instances

(GObject a, (UnknownAncestorError PrintOperation a :: Constraint)) => IsPrintOperation a

IsPrintOperation PrintOperation

toPrintOperation :: (MonadIO m, IsPrintOperation o) => o -> m PrintOperation

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

noPrintOperation :: Maybe PrintOperation

A convenience alias for Nothing :: Maybe PrintOperation.

Methods

getPageSetup

printOperationGetPageSetup

Arguments

:: (HasCallStack, MonadIO m, IsPrintOperation a)

=> a

printOperation: a PrintOperation

-> m PageSetup

Returns: the current PageSetup of printOperation.

Return the current page setup of printOperation. It returns Nothing until either printOperationSetPageSetup or printOperationRunDialog have been called.

getPrintSettings

printOperationGetPrintSettings

Arguments

:: (HasCallStack, MonadIO m, IsPrintOperation a)

=> a

printOperation: a PrintOperation

-> m PrintSettings

Returns: the current PrintSettings of printOperation.

Return the current print settings of printOperation. It returns Nothing until either printOperationSetPrintSettings or printOperationRunDialog have been called.

new

printOperationNew

Arguments

:: (HasCallStack, MonadIO m, IsWebView a)

=> a

webView: a WebView

-> m PrintOperation

Returns: a new PrintOperation.

Create a new PrintOperation to print webView contents.

print

printOperationPrint

Arguments

:: (HasCallStack, MonadIO m, IsPrintOperation a)

=> a

printOperation: a PrintOperation

-> m ()

Start a print operation using current print settings and page setup without showing the print dialog. If either print settings or page setup are not set with printOperationSetPrintSettings and printOperationSetPageSetup, the default options will be used and the print job will be sent to the default printer. The PrintOperation::finished signal is emitted when the printing operation finishes. If an error occurs while printing the signal PrintOperation::failed is emitted before PrintOperation::finished.

runDialog

printOperationRunDialog

Arguments

:: (HasCallStack, MonadIO m, IsPrintOperation a, IsWindow b)

=> a

printOperation: a PrintOperation

-> Maybe b

parent: transient parent of the print dialog

-> m PrintOperationResponse

Returns: the PrintOperationResponse of the print dialog

Run the print dialog and start printing using the options selected by the user. This method returns when the print dialog is closed. If the print dialog is cancelled PrintOperationResponseCancel is returned. If the user clicks on the print button, PrintOperationResponsePrint is returned and the print operation starts. In this case, the PrintOperation::finished signal is emitted when the operation finishes. If an error occurs while printing, the signal PrintOperation::failed is emitted before PrintOperation::finished. If the print dialog is not cancelled current print settings and page setup of printOperation are updated with options selected by the user when Print button is pressed in print dialog. You can get the updated print settings and page setup by calling printOperationGetPrintSettings and printOperationGetPageSetup after this method.

setPageSetup

printOperationSetPageSetup

Arguments

:: (HasCallStack, MonadIO m, IsPrintOperation a, IsPageSetup b)

=> a

printOperation: a PrintOperation

-> b

pageSetup: a PageSetup to set

-> m ()

Set the current page setup of printOperation. Current page setup is used for the initial values of the print dialog when printOperationRunDialog is called.

setPrintSettings

printOperationSetPrintSettings

Arguments

:: (HasCallStack, MonadIO m, IsPrintOperation a, IsPrintSettings b)

=> a

printOperation: a PrintOperation

-> b

printSettings: a PrintSettings to set

-> m ()

Set the current print settings of printOperation. Current print settings are used for the initial values of the print dialog when printOperationRunDialog is called.

Properties

pageSetup

The initial PageSetup for the print operation.

constructPrintOperationPageSetup :: (IsPrintOperation o, IsPageSetup a) => a -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “page-setup” property. This is rarely needed directly, but it is used by new.

getPrintOperationPageSetup :: (MonadIO m, IsPrintOperation o) => o -> m PageSetup

Get the value of the “page-setup” property. When overloading is enabled, this is equivalent to

get printOperation #pageSetup

setPrintOperationPageSetup :: (MonadIO m, IsPrintOperation o, IsPageSetup a) => o -> a -> m ()

Set the value of the “page-setup” property. When overloading is enabled, this is equivalent to

set printOperation [ #pageSetup := value ]

printSettings

The initial PrintSettings for the print operation.

constructPrintOperationPrintSettings :: (IsPrintOperation o, IsPrintSettings a) => a -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “print-settings” property. This is rarely needed directly, but it is used by new.

getPrintOperationPrintSettings :: (MonadIO m, IsPrintOperation o) => o -> m PrintSettings

Get the value of the “print-settings” property. When overloading is enabled, this is equivalent to

get printOperation #printSettings

setPrintOperationPrintSettings :: (MonadIO m, IsPrintOperation o, IsPrintSettings a) => o -> a -> m ()

Set the value of the “print-settings” property. When overloading is enabled, this is equivalent to

set printOperation [ #printSettings := value ]

webView

The WebView that will be printed.

constructPrintOperationWebView :: (IsPrintOperation o, IsWebView a) => a -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “web-view” property. This is rarely needed directly, but it is used by new.

getPrintOperationWebView :: (MonadIO m, IsPrintOperation o) => o -> m (Maybe WebView)

Get the value of the “web-view” property. When overloading is enabled, this is equivalent to

get printOperation #webView

Signals

createCustomWidget

type C_PrintOperationCreateCustomWidgetCallback = Ptr () -> Ptr () -> IO (Ptr PrintCustomWidget)

Type for the callback on the (unwrapped) C side.

type PrintOperationCreateCustomWidgetCallback

Arguments

 = IO PrintCustomWidget

Returns: A PrintCustomWidget that will be embedded in the dialog.

Emitted when displaying the print dialog with printOperationRunDialog. The returned PrintCustomWidget will be added to the print dialog and it will be owned by the printOperation. However, the object is guaranteed to be alive until the PrintCustomWidget::apply is emitted.

Since: 2.16

afterPrintOperationCreateCustomWidget :: (IsPrintOperation a, MonadIO m) => a -> PrintOperationCreateCustomWidgetCallback -> m SignalHandlerId

Connect a signal handler for the “create-custom-widget” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after printOperation #createCustomWidget callback

genClosure_PrintOperationCreateCustomWidget :: PrintOperationCreateCustomWidgetCallback -> IO Closure

Wrap the callback into a Closure.

mk_PrintOperationCreateCustomWidgetCallback :: C_PrintOperationCreateCustomWidgetCallback -> IO (FunPtr C_PrintOperationCreateCustomWidgetCallback)

Generate a function pointer callable from C code, from a C_PrintOperationCreateCustomWidgetCallback.

noPrintOperationCreateCustomWidgetCallback :: Maybe PrintOperationCreateCustomWidgetCallback

A convenience synonym for Nothing :: Maybe PrintOperationCreateCustomWidgetCallback.

onPrintOperationCreateCustomWidget :: (IsPrintOperation a, MonadIO m) => a -> PrintOperationCreateCustomWidgetCallback -> m SignalHandlerId

Connect a signal handler for the “create-custom-widget” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on printOperation #createCustomWidget callback

wrap_PrintOperationCreateCustomWidgetCallback :: PrintOperationCreateCustomWidgetCallback -> C_PrintOperationCreateCustomWidgetCallback

Wrap a PrintOperationCreateCustomWidgetCallback into a C_PrintOperationCreateCustomWidgetCallback.

failed

type C_PrintOperationFailedCallback = Ptr () -> Ptr GError -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

type PrintOperationFailedCallback

Arguments

 = GError

error: the GError that was triggered

-> IO ()

Emitted when an error occurs while printing. The given error, of the domain WEBKIT_PRINT_ERROR, contains further details of the failure. The PrintOperation::finished signal is emitted after this one.

afterPrintOperationFailed :: (IsPrintOperation a, MonadIO m) => a -> PrintOperationFailedCallback -> m SignalHandlerId

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

after printOperation #failed callback

genClosure_PrintOperationFailed :: PrintOperationFailedCallback -> IO Closure

Wrap the callback into a Closure.

mk_PrintOperationFailedCallback :: C_PrintOperationFailedCallback -> IO (FunPtr C_PrintOperationFailedCallback)

Generate a function pointer callable from C code, from a C_PrintOperationFailedCallback.

noPrintOperationFailedCallback :: Maybe PrintOperationFailedCallback

A convenience synonym for Nothing :: Maybe PrintOperationFailedCallback.

onPrintOperationFailed :: (IsPrintOperation a, MonadIO m) => a -> PrintOperationFailedCallback -> m SignalHandlerId

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

on printOperation #failed callback

wrap_PrintOperationFailedCallback :: PrintOperationFailedCallback -> C_PrintOperationFailedCallback

Wrap a PrintOperationFailedCallback into a C_PrintOperationFailedCallback.

finished

type C_PrintOperationFinishedCallback = Ptr () -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

type PrintOperationFinishedCallback = IO ()

Emitted when the print operation has finished doing everything required for printing.

afterPrintOperationFinished :: (IsPrintOperation a, MonadIO m) => a -> PrintOperationFinishedCallback -> m SignalHandlerId

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

after printOperation #finished callback

genClosure_PrintOperationFinished :: PrintOperationFinishedCallback -> IO Closure

Wrap the callback into a Closure.

mk_PrintOperationFinishedCallback :: C_PrintOperationFinishedCallback -> IO (FunPtr C_PrintOperationFinishedCallback)

Generate a function pointer callable from C code, from a C_PrintOperationFinishedCallback.

noPrintOperationFinishedCallback :: Maybe PrintOperationFinishedCallback

A convenience synonym for Nothing :: Maybe PrintOperationFinishedCallback.

onPrintOperationFinished :: (IsPrintOperation a, MonadIO m) => a -> PrintOperationFinishedCallback -> m SignalHandlerId

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

on printOperation #finished callback

wrap_PrintOperationFinishedCallback :: PrintOperationFinishedCallback -> C_PrintOperationFinishedCallback

Wrap a PrintOperationFinishedCallback into a C_PrintOperationFinishedCallback.