wxErlang

Reference Manual

Version 2.1

Table of Contents

wxPrinter

Module

wxPrinter

Module Summary

Functions for wxPrinter class

Description

This class represents the Windows or PostScript printer, and is the vehicle through which printing may be launched by an application.

Printing can also be achieved through using of lower functions and classes, but this and associated classes provide a more convenient and general method of printing.

See: Overview printing, wxPrinterDC (not implemented in wx), wxPrintDialog, wxPrintout, wxPrintPreview

wxWidgets docs: wxPrinter

Data Types

wxPrinter() = wx:wx_object()

Exports

new() -> wxPrinter()
new(Options :: [Option]) -> wxPrinter()

Types

Option = {data, wxPrintDialogData:wxPrintDialogData()}

Constructor.

Pass an optional pointer to a block of print dialog data, which will be copied to the printer object's local data.

See: wxPrintDialogData, wxPrintData

createAbortWindow(This, Parent, Printout) -> wxDialog:wxDialog()

Types

This = wxPrinter()
Parent = wxWindow:wxWindow()
Printout = wxPrintout:wxPrintout()

Creates the default printing abort window, with a cancel button.

getAbort(This) -> boolean()

Types

This = wxPrinter()

Returns true if the user has aborted the print job.

getLastError() -> wx:wx_enum()

Return last error.

Valid after calling print/4, printDialog/2 or wxPrintPreview:print/2.

These functions set last error to wxPRINTER_NO_ERROR if no error happened.

Returned value is one of the following:

getPrintDialogData(This) -> wxPrintDialogData:wxPrintDialogData()

Types

This = wxPrinter()

Returns the print data associated with the printer object.

print(This, Parent, Printout) -> boolean()

Types

This = wxPrinter()
Parent = wxWindow:wxWindow()
Printout = wxPrintout:wxPrintout()
print(This, Parent, Printout, Options :: [Option]) -> boolean()

Types

This = wxPrinter()
Parent = wxWindow:wxWindow()
Printout = wxPrintout:wxPrintout()
Option = {prompt, boolean()}

Starts the printing process.

Provide a parent window, a user-defined wxPrintout object which controls the printing of a document, and whether the print dialog should be invoked first.

print/4 could return false if there was a problem initializing the printer device context (current printer not set, for example) or the user cancelled printing. Call getLastError/0 to get detailed information about the kind of the error.

printDialog(This, Parent) -> wxDC:wxDC()

Types

This = wxPrinter()
Parent = wxWindow:wxWindow()

Invokes the print dialog.

If successful (the user did not press Cancel and no error occurred), a suitable device context will be returned; otherwise NULL is returned; call getLastError/0 to get detailed information about the kind of the error.

Remark: The application must delete this device context to avoid a memory leak.

reportError(This, Parent, Printout, Message) -> ok

Types

This = wxPrinter()
Parent = wxWindow:wxWindow()
Printout = wxPrintout:wxPrintout()
Message = unicode:chardata()

Default error-reporting function.

setup(This, Parent) -> boolean()

Types

This = wxPrinter()
Parent = wxWindow:wxWindow()

Invokes the print setup dialog.

Deprecated: The setup dialog is obsolete, though retained for backward compatibility.

destroy(This :: wxPrinter()) -> ok

Destroys the object.

Copyright © 2009-2021 Ericsson AB. All Rights Reserved.