|  |  |  | GTK+ Reference Manual |  | 
|---|---|---|---|---|
#include <gtk/gtk.h>
                    GtkPrinter;
                    GtkPrintBackend;
GtkPrinter*         gtk_printer_new                     (const gchar *name,
                                                         GtkPrintBackend *backend,
                                                         gboolean virtual_);
GtkPrintBackend*    gtk_printer_get_backend             (GtkPrinter *printer);
const gchar*        gtk_printer_get_name                (GtkPrinter *printer);
const gchar*        gtk_printer_get_state_message       (GtkPrinter *printer);
const gchar*        gtk_printer_get_description         (GtkPrinter *printer);
const gchar*        gtk_printer_get_location            (GtkPrinter *printer);
const gchar*        gtk_printer_get_icon_name           (GtkPrinter *printer);
gint                gtk_printer_get_job_count           (GtkPrinter *printer);
gboolean            gtk_printer_is_active               (GtkPrinter *printer);
gboolean            gtk_printer_is_virtual              (GtkPrinter *printer);
gboolean            gtk_printer_is_default              (GtkPrinter *printer);
gboolean            gtk_printer_accepts_ps              (GtkPrinter *printer);
gboolean            gtk_printer_accepts_pdf             (GtkPrinter *printer);
gint                gtk_printer_compare                 (GtkPrinter *a,
                                                         GtkPrinter *b);
gboolean            (*GtkPrinterFunc)                   (GtkPrinter *printer,
                                                         gpointer data);
void                gtk_enumerate_printers              (GtkPrinterFunc func,
                                                         gpointer data,
                                                         GDestroyNotify destroy,
                                                         gboolean wait);
accepts-pdf gboolean : Read / Write / Construct Only accepts-ps gboolean : Read / Write / Construct Only backend GtkPrintBackend : Read / Write / Construct Only icon-name gchararray : Read is-virtual gboolean : Read / Write / Construct Only job-count gint : Read location gchararray : Read name gchararray : Read / Write / Construct Only state-message gchararray : Read
A GtkPrinter object represents a printer. You only need to deal directly with printers if you use the non-portable GtkPrintUnixDialog API.
A GtkPrinter allows to get status information about the printer, such as its description, its location, the number of queued jobs, etc. Most importantly, a GtkPrinter object can be used to create a GtkPrintJob object, which lets you print to the printer.
Printing support was added in GTK+ 2.10.
GtkPrinter* gtk_printer_new (const gchar *name, GtkPrintBackend *backend, gboolean virtual_);
Creates a new GtkPrinter.
| name: | the name of the printer | 
| backend: | a GtkPrintBackend | 
| virtual_: | whether the printer is virtual | 
| Returns : | a new GtkPrinter | 
Since 2.10
GtkPrintBackend* gtk_printer_get_backend (GtkPrinter *printer);
Returns the backend of the printer.
| printer: | a GtkPrinter | 
| Returns : | the backend of printer | 
Since 2.10
const gchar* gtk_printer_get_name (GtkPrinter *printer);
Returns the name of the printer.
| printer: | a GtkPrinter | 
| Returns : | the name of printer | 
Since 2.10
const gchar* gtk_printer_get_state_message (GtkPrinter *printer);
Returns the state message describing the current state of the printer.
| printer: | a GtkPrinter | 
| Returns : | the state message of printer | 
Since 2.10
const gchar* gtk_printer_get_description (GtkPrinter *printer);
Gets the description of the printer.
| printer: | a GtkPrinter | 
| Returns : | the description of printer | 
Since 2.10
const gchar* gtk_printer_get_location (GtkPrinter *printer);
Returns a description of the location of the printer.
| printer: | a GtkPrinter | 
| Returns : | the location of printer | 
Since 2.10
const gchar* gtk_printer_get_icon_name (GtkPrinter *printer);
Gets the name of the icon to use for the printer.
| printer: | a GtkPrinter | 
| Returns : | the icon name for printer | 
Since 2.10
gint gtk_printer_get_job_count (GtkPrinter *printer);
Gets the number of jobs currently queued on the printer.
| printer: | a GtkPrinter | 
| Returns : | the number of jobs on printer | 
Since 2.10
gboolean gtk_printer_is_active (GtkPrinter *printer);
Returns whether the printer is currently active (i.e. accepts new jobs).
| printer: | a GtkPrinter | 
| Returns : | TRUEifprinteris active | 
Since 2.10
gboolean gtk_printer_is_virtual (GtkPrinter *printer);
Returns whether the printer is virtual (i.e. does not represent actual printer hardware, but something like a CUPS class).
| printer: | a GtkPrinter | 
| Returns : | TRUEifprinteris virtual | 
Since 2.10
gboolean gtk_printer_is_default (GtkPrinter *printer);
Returns whether the printer is the default printer.
| printer: | a GtkPrinter | 
| Returns : | TRUEifprinteris the default | 
Since 2.10
gboolean gtk_printer_accepts_ps (GtkPrinter *printer);
Returns whether the printer accepts input in PostScript format.
| printer: | a GtkPrinter | 
| Returns : | TRUEifprinteraccepts PostScript | 
Since 2.10
gboolean gtk_printer_accepts_pdf (GtkPrinter *printer);
Returns whether the printer accepts input in PDF format.
| printer: | a GtkPrinter | 
| Returns : | TRUEifprinteraccepts PDF | 
Since 2.10
gint gtk_printer_compare (GtkPrinter *a, GtkPrinter *b);
Compares two printers.
| a: | a GtkPrinter | 
| b: | another GtkPrinter | 
| Returns : | 0 if the printer match, a negative value if a<b, 
  or a positive value ifa>b | 
Since 2.10
gboolean (*GtkPrinterFunc) (GtkPrinter *printer, gpointer data);
The type of function passed to gtk_enumerate_printers().
Note that you need to ref printer, if you want to keep
a reference to it after the function has returned.
| printer: | a GtkPrinter | 
| data: | user data passed to gtk_enumerate_printers() | 
| Returns : | TRUEto stop the enumeration,FALSEto continue | 
void gtk_enumerate_printers (GtkPrinterFunc func, gpointer data, GDestroyNotify destroy, gboolean wait);
Calls a function for all GtkPrinters. 
If func returns TRUE, the enumeration is stopped.
| func: | a function to call for each printer | 
| data: | user data to pass to func | 
| destroy: | function to call if datais no longer needed | 
| wait: | if TRUE, wait in a recursive mainloop until
   all printers are enumerated; otherwise return early | 
Since 2.10
accepts-pdf propertyaccepts-pdf gboolean : Read / Write / Construct Only
TRUE if this printer can accept PDF.
Default value: TRUE
accepts-ps propertyaccepts-ps gboolean : Read / Write / Construct Only
TRUE if this printer can accept PostScript.
Default value: TRUE
backend propertybackend GtkPrintBackend : Read / Write / Construct Only
Backend for the printer.
icon-name propertyicon-name gchararray : Read
The icon name to use for the printer.
Default value: NULL
is-virtual propertyis-virtual gboolean : Read / Write / Construct Only
FALSE if this represents a real hardware printer.
Default value: FALSE
job-count propertyjob-count gint : Read
Number of jobs queued in the printer.
Allowed values: >= 0
Default value: 0
name propertyname gchararray : Read / Write / Construct Only
Name of the printer.
Default value: NULL
::details-acquired signalvoid user_function (GtkPrinter *printer, gboolean success, gpointer user_data) : Run Last
Gets emitted in response to a request for detailed information
about a printer from the print backend. The success parameter
indicates if the information was actually obtained.
| printer: | the GtkPrinter on which the signal is emitted | 
| success: | TRUEif the details were successfully acquired | 
| user_data: | user data set when the signal handler was connected. | 
Since 2.10