Package org.gnome.gtk

Class PrintJob

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gtk.PrintJob

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class PrintJob
extends GObject

Represents a job that is sent to a printer.

You only need to deal directly with print jobs if you use the non-portable PrintUnixDialog API.

Use getSurface() to obtain the cairo surface onto which the pages must be drawn. Use send(org.gnome.gtk.PrintJobCompleteFunc) to send the finished job to the printer. If you don’t use cairo GtkPrintJob also supports printing of manually generated PostScript, via setSourceFile(java.lang.String).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PrintJob.Builder<B extends PrintJob.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.
static interface	PrintJob.StatusChangedCallback	Functional interface declaration of the StatusChangedCallback callback.

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Constructor Summary

Constructors

Constructor	Description
PrintJob()	Creates a new PrintJob.
PrintJob(MemorySegment address)	Create a PrintJob proxy instance for the provided memory address.
PrintJob(String title, Printer printer, PrintSettings settings, PageSetup pageSetup)	Creates a new GtkPrintJob.

Method Summary

Modifier and Type	Method	Description
protected PrintJob	asParent()	Returns this instance as if it were its parent type.
static PrintJob.Builder<? extends PrintJob.Builder>	builder()	A PrintJob.Builder object constructs a PrintJob with the specified properties.
void	emitStatusChanged()	Emits the "status-changed" signal.
boolean	getCollate()	Gets whether this job is printed collated.
int	getNumCopies()	Gets the number of copies of this job.
int	getNUp()	Gets the n-up setting for this job.
NumberUpLayout	getNUpLayout()	Gets the n-up layout setting for this job.
PageRange[]	getPageRanges()	Gets the page ranges for this job.
PrintPages	getPages()	Gets the GtkPrintPages setting for this job.
PageSet	getPageSet()	Gets the GtkPageSet setting for this job.
Printer	getPrinter()	Gets the GtkPrinter of the print job.
boolean	getReverse()	Gets whether this job is printed reversed.
boolean	getRotate()	Gets whether the job is printed rotated.
double	getScale()	Gets the scale for this job.
PrintSettings	getSettings()	Gets the GtkPrintSettings of the print job.
PrintStatus	getStatus()	Gets the status of the print job.
org.freedesktop.cairo.Surface	getSurface()	Gets a cairo surface onto which the pages of the print job should be rendered.
String	getTitle()	Gets the job title.
boolean	getTrackPrintStatus()	Returns whether jobs will be tracked after printing.
static @Nullable Type	getType()	Get the GType of the PrintJob class
SignalConnection<PrintJob.StatusChangedCallback>	onStatusChanged(PrintJob.StatusChangedCallback handler)	Emitted when the status of a job changes.
void	send(@Nullable PrintJobCompleteFunc callback)	Sends the print job off to the printer.
void	setCollate(boolean collate)	Sets whether this job is printed collated.
void	setNumCopies(int numCopies)	Sets the number of copies for this job.
void	setNUp(int nUp)	Sets the n-up setting for this job.
void	setNUpLayout(NumberUpLayout layout)	Sets the n-up layout setting for this job.
void	setPageRanges(@Nullable PageRange @Nullable [] ranges)	Sets the page ranges for this job.
void	setPages(PrintPages pages)	Sets the GtkPrintPages setting for this job.
void	setPageSet(PageSet pageSet)	Sets the GtkPageSet setting for this job.
void	setReverse(boolean reverse)	Sets whether this job is printed reversed.
void	setRotate(boolean rotate)	Sets whether this job is printed rotated.
void	setScale(double scale)	Sets the scale for this job.
boolean	setSourceFd(int fd)	Make the GtkPrintJob send an existing document to the printing system.
boolean	setSourceFile(String filename)	Make the GtkPrintJob send an existing document to the printing system.
void	setTrackPrintStatus(boolean trackStatus)	If track_status is true, the print job will try to continue report on the status of the print job in the printer queues and printer.

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getMemoryLayout, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

PrintJob

public PrintJob(MemorySegment address)

Create a PrintJob proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

PrintJob

public PrintJob(String title,
 Printer printer,
 PrintSettings settings,
 PageSetup pageSetup)

Creates a new GtkPrintJob.

Parameters:

title - the job title

printer - a GtkPrinter

settings - a GtkPrintSettings

pageSetup - a GtkPageSetup

PrintJob

public PrintJob()

Creates a new PrintJob.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the PrintJob class

Returns:

the GType

asParent

protected PrintJob asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class GObject

getCollate

public boolean getCollate()

Gets whether this job is printed collated.

Returns:

whether the job is printed collated

getNUp

public int getNUp()

Gets the n-up setting for this job.

Returns:

the n-up setting

getNUpLayout

public NumberUpLayout getNUpLayout()

Gets the n-up layout setting for this job.

Returns:

the n-up layout

getNumCopies

public int getNumCopies()

Gets the number of copies of this job.

Returns:

the number of copies

getPageRanges

public PageRange[] getPageRanges()

Gets the page ranges for this job.

Returns:

a pointer to an array of GtkPageRange structs

getPageSet

public PageSet getPageSet()

Gets the GtkPageSet setting for this job.

Returns:

the GtkPageSet setting

getPages

public PrintPages getPages()

Gets the GtkPrintPages setting for this job.

Returns:

the GtkPrintPages setting

getPrinter

public Printer getPrinter()

Gets the GtkPrinter of the print job.

Returns:

the printer of this PrintJob

getReverse

public boolean getReverse()

Gets whether this job is printed reversed.

Returns:

whether the job is printed reversed.

getRotate

public boolean getRotate()

Gets whether the job is printed rotated.

Returns:

whether the job is printed rotated

getScale

public double getScale()

Gets the scale for this job.

Returns:

the scale

getSettings

public PrintSettings getSettings()

Gets the GtkPrintSettings of the print job.

Returns:

the settings of this PrintJob

getStatus

public PrintStatus getStatus()

Gets the status of the print job.

Returns:

the status of this PrintJob

getSurface

public org.freedesktop.cairo.Surface getSurface()
                                         throws GErrorException

Gets a cairo surface onto which the pages of the print job should be rendered.

Returns:

the cairo surface of this PrintJob

Throws:

GErrorException - see GError

getTitle

public String getTitle()

Gets the job title.

Returns:

the title of this PrintJob

getTrackPrintStatus

public boolean getTrackPrintStatus()

Returns whether jobs will be tracked after printing.

For details, see setTrackPrintStatus(boolean).

Returns:

true if print job status will be reported after printing

send

public void send(@Nullable PrintJobCompleteFunc callback)

Sends the print job off to the printer.

Parameters:

callback - function to call when the job completes or an error occurs

setCollate

public void setCollate(boolean collate)

Sets whether this job is printed collated.

Parameters:

collate - whether the job is printed collated

setNUp

public void setNUp(int nUp)

Sets the n-up setting for this job.

Parameters:

nUp - the n-up value

setNUpLayout

public void setNUpLayout(NumberUpLayout layout)

Sets the n-up layout setting for this job.

Parameters:

layout - the n-up layout setting

setNumCopies

public void setNumCopies(int numCopies)

Sets the number of copies for this job.

Parameters:

numCopies - the number of copies

setPageRanges

public void setPageRanges(@Nullable PageRange @Nullable [] ranges)

Sets the page ranges for this job.

Parameters:

ranges - pointer to an array of GtkPageRange structs

setPageSet

public void setPageSet(PageSet pageSet)

Sets the GtkPageSet setting for this job.

Parameters:

pageSet - a GtkPageSet setting

setPages

public void setPages(PrintPages pages)

Sets the GtkPrintPages setting for this job.

Parameters:

pages - the GtkPrintPages setting

setReverse

public void setReverse(boolean reverse)

Sets whether this job is printed reversed.

Parameters:

reverse - whether the job is printed reversed

setRotate

public void setRotate(boolean rotate)

Sets whether this job is printed rotated.

Parameters:

rotate - whether to print rotated

setScale

public void setScale(double scale)

Sets the scale for this job.

1.0 means unscaled.

Parameters:

scale - the scale

setSourceFd

public boolean setSourceFd(int fd)
                    throws GErrorException

Make the GtkPrintJob send an existing document to the printing system.

The file can be in any format understood by the platforms printing system (typically PostScript, but on many platforms PDF may work too). See Printer.acceptsPdf() and Printer.acceptsPs().

This is similar to setSourceFile(java.lang.String), but takes expects an open file descriptor for the file, instead of a filename.

Parameters:

fd - a file descriptor

Returns:

false if an error occurred

Throws:

GErrorException - see GError

setSourceFile

public boolean setSourceFile(String filename)
                      throws GErrorException

Make the GtkPrintJob send an existing document to the printing system.

The file can be in any format understood by the platforms printing system (typically PostScript, but on many platforms PDF may work too). See Printer.acceptsPdf() and Printer.acceptsPs().

Parameters:

filename - the file to be printed

Returns:

false if an error occurred

Throws:

GErrorException - see GError

setTrackPrintStatus

public void setTrackPrintStatus(boolean trackStatus)

If track_status is true, the print job will try to continue report on the status of the print job in the printer queues and printer.

This can allow your application to show things like “out of paper” issues, and when the print job actually reaches the printer.

This function is often implemented using some form of polling, so it should not be enabled unless needed.

Parameters:

trackStatus - true to track status after printing

onStatusChanged

public SignalConnection<PrintJob.StatusChangedCallback> onStatusChanged(PrintJob.StatusChangedCallback handler)

Emitted when the status of a job changes.

The signal handler can use getStatus() to obtain the new status.

Parameters:

handler - the signal handler

Returns:

a signal handler ID to keep track of the signal connection

See Also:

• PrintJob.StatusChangedCallback.run()

emitStatusChanged

public void emitStatusChanged()

Emits the "status-changed" signal. See onStatusChanged(org.gnome.gtk.PrintJob.StatusChangedCallback).

builder

public static PrintJob.Builder<? extends PrintJob.Builder> builder()

A PrintJob.Builder object constructs a PrintJob with the specified properties. Use the various set...() methods to set properties, and finish construction with PrintJob.Builder.build().

Returns:

the builder object