Package org.eclipse.draw2d
Class PrintOperation
java.lang.Object
org.eclipse.draw2d.PrintOperation
- Direct Known Subclasses:
PrintFigureOperation
Implementation of draw2d's printing capabilities.
-
Constructor Summary
ConstructorsConstructorDescriptionCreates a new PrintOperationCreates a new PrintOperation on Printer p -
Method Summary
Modifier and TypeMethodDescriptionprotected void
cleanup()
Disposes the PrinterGraphics and GC objects associated with this PrintOperation.protected Graphics
createGraphics
(SWTGraphics g, Printer p) protected Graphics
Returns a new Graphics setup for the Printer associated with this PrintOperation.protected PrinterGraphics
Deprecated, for removal: This API element is subject to removal in a future version.Returns the printer.Returns a Rectangle that represents the region that can be printed to.protected void
This method contains all operations performed to sourceFigure prior to being printed.protected abstract void
This method is responsible for printing pages.protected void
This method contains all operations performed to sourceFigure after being printed.void
Sets the print job into motion.void
setPrinter
(Printer printer) Sets the printer.void
setPrintMargin
(Insets margin) Sets the page margin in pels (logical pixels) to the passed Insets.(72 pels == 1 inch)protected void
Manipulates the PrinterGraphics to position it to paint in the desired region of the page.protected void
Deprecated, for removal: This API element is subject to removal in a future version.UsesetupGraphicsForPage(Graphics)
instead.
-
Constructor Details
-
PrintOperation
public PrintOperation()Creates a new PrintOperation -
PrintOperation
Creates a new PrintOperation on Printer p- Parameters:
p
- The printer to print on
-
-
Method Details
-
cleanup
protected void cleanup()Disposes the PrinterGraphics and GC objects associated with this PrintOperation. -
getFreshPrinterGraphics
Deprecated, for removal: This API element is subject to removal in a future version.UsegetFreshGraphics()
instead. This method will be removed after the 2027-06 release.Returns a new PrinterGraphics setup for the Printer associated with this PrintOperation. This method will be removed after the 2027-06 release. Important: This method should not be called ifcreateGraphics(SWTGraphics, Printer)
has been subclasses.- Returns:
- PrinterGraphics The new PrinterGraphics
-
getFreshGraphics
Returns a new Graphics setup for the Printer associated with this PrintOperation.- Returns:
- Graphics The new Graphics
- Since:
- 3.20
-
createGraphics
Creates a newPrinterGraphics
with Graphicsg
, using Printerp
. May be overridden by subclasses if a differentGraphics
object is required.- Parameters:
g
- Graphics object to draw withp
- Printer to print to- Returns:
- A new
PrinterGraphics
object. - Since:
- 3.20
-
getPrinter
Returns the printer.- Returns:
- Printer
-
getPrintRegion
Returns a Rectangle that represents the region that can be printed to. The x, y, height, and width values are using the printers coordinates.- Returns:
- the print region
-
preparePrintSource
protected void preparePrintSource()This method contains all operations performed to sourceFigure prior to being printed. -
printPages
protected abstract void printPages()This method is responsible for printing pages. (A page is printed by calling Printer.startPage(), followed by painting to the PrinterGraphics object, and then calling Printer.endPage()). -
restorePrintSource
protected void restorePrintSource()This method contains all operations performed to sourceFigure after being printed. -
run
Sets the print job into motion.- Parameters:
jobName
- A String representing the name of the print job
-
setPrinter
Sets the printer.- Parameters:
printer
- The printer to set
-
setPrintMargin
Sets the page margin in pels (logical pixels) to the passed Insets.(72 pels == 1 inch)- Parameters:
margin
- The margin to set on the page
-
setupGraphicsForPage
@Deprecated(forRemoval=true, since="2025-06") protected void setupGraphicsForPage(PrinterGraphics pg) Deprecated, for removal: This API element is subject to removal in a future version.UsesetupGraphicsForPage(Graphics)
instead. This method will be removed after the 2027-06 release.Manipulates the PrinterGraphics to position it to paint in the desired region of the page. (Default is the top left corner of the page).- Parameters:
pg
- The PrinterGraphics to setup
-
setupGraphicsForPage
Manipulates the PrinterGraphics to position it to paint in the desired region of the page. (Default is the top left corner of the page).- Parameters:
g
- The Graphics to setup- Since:
- 3.20
-
getFreshGraphics()
instead.