PrintJob

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_print_job_get_type ()" ) ]
public class PrintJob : Object

Represents a job that is sent to a printer.

You only need to deal directly with print jobs if you use the non-portable [class@Gtk.PrintUnixDialog] API.

Use [method@Gtk.PrintJob.get_surface] to obtain the cairo surface onto which the pages must be drawn. Use [method@Gtk.PrintJob.send] to send the finished job to the printer. If you don’t use cairo `GtkPrintJob` also supports printing of manually generated PostScript, via [method@Gtk.PrintJob.set_source_file].

Namespace: Gtk

Package: gtk4-unix-print

Content:

Properties:

public PageSetup page_setup { owned get; construct; }
Page setup.
public Printer printer { get; construct; }
The printer to send the job to.
public PrintSettings settings { get; construct; }
Printer settings.
public string title { get; construct; }
The title of the print job.
public bool track_print_status { get; set; }
true if the print job will continue to emit status-changed signals after the print data has been setn to the printer.

Creation methods:

public PrintJob (string title, Printer printer, PrintSettings settings, PageSetup page_setup)
Creates a new `GtkPrintJob`.

Methods:

public bool get_collate ()
Gets whether this job is printed collated.
public uint get_n_up ()
Gets the n-up setting for this job.
public NumberUpLayout get_n_up_layout ()
Gets the n-up layout setting for this job.
public int get_num_copies ()
Gets the number of copies of this job.
public unowned PageRange[] get_page_ranges ()
Gets the page ranges for this job.
public PageSet get_page_set ()
Gets the `GtkPageSet` setting for this job.
public PrintPages get_pages ()
Gets the `GtkPrintPages` setting for this job.
public unowned Printer get_printer ()
Gets the `GtkPrinter` of the print job.
public bool get_reverse ()
Gets whether this job is printed reversed.
public bool get_rotate ()
Gets whether the job is printed rotated.
public double get_scale ()
Gets the scale for this job.
public unowned PrintSettings get_settings ()
Gets the `GtkPrintSettings` of the print job.
public PrintStatus get_status ()
Gets the status of the print job.
public unowned Surface get_surface () throws Error
Gets a cairo surface onto which the pages of the print job should be rendered.
public unowned string get_title ()
Gets the job title.
public bool get_track_print_status ()
Returns whether jobs will be tracked after printing.
public void send (owned PrintJobCompleteFunc callback)
Sends the print job off to the printer.
public void set_collate (bool collate)
Sets whether this job is printed collated.
public void set_n_up (uint n_up)
Sets the n-up setting for this job.
public void set_n_up_layout (NumberUpLayout layout)
Sets the n-up layout setting for this job.
public void set_num_copies (int num_copies)
Sets the number of copies for this job.
public void set_page_ranges (owned PageRange[] ranges)
Sets the page ranges for this job.
public void set_page_set (PageSet page_set)
Sets the `GtkPageSet` setting for this job.
public void set_pages (PrintPages pages)
Sets the `GtkPrintPages` setting for this job.
public void set_reverse (bool reverse)
Sets whether this job is printed reversed.
public void set_rotate (bool rotate)
Sets whether this job is printed rotated.
public void set_scale (double scale)
Sets the scale for this job.
public bool set_source_fd (int fd) throws Error
Make the `GtkPrintJob` send an existing document to the printing system.
public bool set_source_file (string filename) throws Error
Make the `GtkPrintJob` send an existing document to the printing system.
public void set_track_print_status (bool track_status)
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.

Signals:

public signal void status_changed ()
Emitted when the status of a job changes.

Inherited Members:

All known members inherited from class GLib.Object