A Printer object represents a printer. More...

#include <gtkmm/printer.h>

Inherits Glib::Object.

Public Member Functions
	Printer (Printer && src) noexcept

Printer &	operator= (Printer && src) noexcept

	~Printer () noexcept override

GtkPrinter *	gobj ()
	Provides access to the underlying C GObject. More...

const GtkPrinter *	gobj () const
	Provides access to the underlying C GObject. More...

GtkPrinter *	gobj_copy ()
	Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...

bool	equal (const Glib::RefPtr< Printer > & other) const

Glib::ustring	get_name () const
	Returns the name of the printer. More...

Glib::ustring	get_state_message () const
	Returns the state message describing the current state of the printer. More...

Glib::ustring	get_description () const
	Gets the description of the printer. More...

Glib::ustring	get_location () const
	Returns a description of the location of the printer. More...

Glib::ustring	get_icon_name () const
	Gets the name of the icon to use for the printer. More...

int	get_job_count () const
	Gets the number of jobs currently queued on the printer. More...

bool	is_active () const
	Returns whether the printer is currently active (i.e. accepts new jobs). More...

bool	is_paused () const
	Returns whether the printer is currently paused. More...

bool	is_accepting_jobs () const
	Returns whether the printer is accepting jobs. More...

bool	is_virtual () const
	Returns whether the printer is virtual (i.e. does not represent actual printer hardware, but something like a CUPS class). More...

bool	is_default () const
	Returns whether the printer is the default printer. More...

bool	accepts_pdf () const
	Returns whether the printer accepts input in PDF format. More...

bool	accepts_ps () const
	Returns whether the printer accepts input in PostScript format. More...

std::vector< Glib::RefPtr< PageSetup > >	list_papers ()
	Lists all the paper sizes printer supports. More...

Glib::RefPtr< PageSetup >	get_default_page_size () const
	Returns default page size of printer. More...

std::vector< Glib::RefPtr< const PageSetup > >	list_papers () const
	Lists all the paper sizes printer supports. More...

bool	has_details () const
	Returns whether the printer details are available. More...

void	request_details ()
	Requests the printer details. More...

PrintCapabilities	get_capabilities () const
	Returns the printer’s capabilities. More...

bool	get_hard_margins (double & top, double & bottom, double &left, double &right) const
	Retrieve the hard margins of printer, i.e. the margins that define the area at the borders of the paper that the printer cannot print to. More...

Glib::SignalProxy< void, bool >	signal_details_acquired ()

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_name () const
	Name of the printer. More...

Glib::PropertyProxy_ReadOnly< bool >	property_is_virtual () const
	`false` if this represents a real hardware printer. More...

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_state_message () const
	String giving the current state of the printer. More...

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_location () const
	The location of the printer. More...

Glib::PropertyProxy_ReadOnly< Glib::ustring >	property_icon_name () const
	The icon name to use for the printer. More...

Glib::PropertyProxy_ReadOnly< int >	property_job_count () const
	Number of jobs queued in the printer. More...

Glib::PropertyProxy_ReadOnly< bool >	property_accepts_pdf () const
	`true` if this printer can accept PDF. More...

Glib::PropertyProxy_ReadOnly< bool >	property_accepts_ps () const
	`true` if this printer can accept PostScript. More...

Glib::PropertyProxy_ReadOnly< bool >	property_paused () const
	This property is `true` if this printer is paused. More...

Glib::PropertyProxy_ReadOnly< bool >	property_accepting_jobs () const
	This property is `true` if the printer is accepting jobs. More...

Static Public Member Functions
static GType	get_type ()
	Get the GType for this class, for use with the underlying GObject type system. More...

Protected Member Functions
virtual void	on_details_acquired (bool success)
	This is a default handler for the signal signal_details_acquired(). More...

Related Functions
(Note that these are not member functions.)
typedef sigc::slot< bool, const Glib::RefPtr< Printer > & >	SlotPrinterEnumerator
	For example, bool on_enumerate_printers(const Glib::RefPtr<Printer>& printer);. More...

bool	operator== (const Glib::RefPtr< Printer > & lhs, const Glib::RefPtr< Printer > & rhs)

bool	operator!= (const Glib::RefPtr< Printer > & lhs, const Glib::RefPtr< Printer > & rhs)

void	enumerate_printers (const SlotPrinterEnumerator & slot, bool wait=true)
	Calls a function for all Printers. More...

Glib::RefPtr< Gtk::Printer >	wrap (GtkPrinter * object, bool take_copy=false)
	A Glib::wrap() method for this object. More...

Detailed Description

A Printer object represents a printer.

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

A Printer object allows to get status information about the printer, such as its description, its location, the number of queued jobs, etc. Most importantly, a Printer object can be used to create a PrintJob object, which lets you print to the printer.

Since gtkmm 2.10:

Constructor & Destructor Documentation

◆ Printer()

Gtk::Printer::Printer ( Printer && src )

noexcept

◆ ~Printer()

Gtk::Printer::~Printer ( )

overridenoexcept

Member Function Documentation

◆ accepts_pdf()

bool Gtk::Printer::accepts_pdf ( ) const

Returns whether the printer accepts input in PDF format.

Since gtkmm 2.10:

Returns: true if printer accepts PDF.

◆ accepts_ps()

bool Gtk::Printer::accepts_ps ( ) const

Returns whether the printer accepts input in PostScript format.

Since gtkmm 2.10:

Returns: true if printer accepts PostScript.

◆ equal()

bool Gtk::Printer::equal ( const Glib::RefPtr< Printer > & other ) const

◆ get_capabilities()

PrintCapabilities Gtk::Printer::get_capabilities ( ) const

Returns the printer’s capabilities.

This is useful when you’re using Gtk::PrintUnixDialog’s manual-capabilities setting and need to know which settings the printer can handle and which you must handle yourself.

This will return 0 unless the printer’s details are available, see has_details() and request_details().

Since gtkmm 2.12:

Returns: The printer’s capabilities.

◆ get_default_page_size()

Glib::RefPtr< PageSetup > Gtk::Printer::get_default_page_size ( ) const

Returns default page size of printer.

Since gtkmm 2.14:

Returns: A newly allocated Gtk::PageSetup with default page size of the printer.

◆ get_description()

Glib::ustring Gtk::Printer::get_description ( ) const

Gets the description of the printer.

Since gtkmm 2.10:

Returns: The description of printer.

◆ get_hard_margins()

bool Gtk::Printer::get_hard_margins	(	double &	top,
		double &	bottom,
		double &	left,
		double &	right
	)		const

Retrieve the hard margins of printer, i.e. the margins that define the area at the borders of the paper that the printer cannot print to.

Note: This will not succeed unless the printer’s details are available, see has_details() and request_details().

Since gtkmm 2.20:

Parameters

top	A location to store the top margin in.
bottom	A location to store the bottom margin in.
left	A location to store the left margin in.
right	A location to store the right margin in.

Returns: true iff the hard margins were retrieved.

◆ get_icon_name()

Glib::ustring Gtk::Printer::get_icon_name ( ) const

Gets the name of the icon to use for the printer.

Since gtkmm 2.10:

Returns: The icon name for printer.

◆ get_job_count()

int Gtk::Printer::get_job_count ( ) const

Gets the number of jobs currently queued on the printer.

Since gtkmm 2.10:

Returns: The number of jobs on printer.

◆ get_location()

Glib::ustring Gtk::Printer::get_location ( ) const

Returns a description of the location of the printer.

Since gtkmm 2.10:

Returns: The location of printer.

◆ get_name()

Glib::ustring Gtk::Printer::get_name ( ) const

Returns the name of the printer.

Since gtkmm 2.10:

Returns: The name of printer.

◆ get_state_message()

Glib::ustring Gtk::Printer::get_state_message ( ) const

Returns the state message describing the current state of the printer.

Since gtkmm 2.10:

Returns: The state message of printer.

◆ get_type()

static GType Gtk::Printer::get_type ( )

static

Get the GType for this class, for use with the underlying GObject type system.

◆ gobj() [1/2]

GtkPrinter * Gtk::Printer::gobj ( )

inline

Provides access to the underlying C GObject.

◆ gobj() [2/2]

const GtkPrinter * Gtk::Printer::gobj ( ) const

inline

Provides access to the underlying C GObject.

◆ gobj_copy()

GtkPrinter * Gtk::Printer::gobj_copy ( )

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

◆ has_details()

bool Gtk::Printer::has_details ( ) const

Returns whether the printer details are available.

Since gtkmm 2.12:

Returns: true if printer details are available.

◆ is_accepting_jobs()

bool Gtk::Printer::is_accepting_jobs ( ) const

Returns whether the printer is accepting jobs.

Since gtkmm 2.14:

Returns: true if printer is accepting jobs.

◆ is_active()

bool Gtk::Printer::is_active ( ) const

Returns whether the printer is currently active (i.e. accepts new jobs).

Since gtkmm 2.10:

Returns: true if printer is active.

◆ is_default()

bool Gtk::Printer::is_default ( ) const

Returns whether the printer is the default printer.

Since gtkmm 2.10:

Returns: true if printer is the default.

◆ is_paused()

bool Gtk::Printer::is_paused ( ) const

Returns whether the printer is currently paused.

A paused printer still accepts jobs, but it is not printing them.

Since gtkmm 2.14:

Returns: true if printer is paused.

◆ is_virtual()

bool Gtk::Printer::is_virtual ( ) const

Returns whether the printer is virtual (i.e. does not represent actual printer hardware, but something like a CUPS class).

Since gtkmm 2.10:

Returns: true if printer is virtual.

◆ list_papers() [1/2]

std::vector< Glib::RefPtr< PageSetup > > Gtk::Printer::list_papers ( )

Lists all the paper sizes printer supports.

This will return and empty list unless the printer’s details are available, see has_details() and request_details().

Since gtkmm 2.12:

Returns: A newly allocated list of newly allocated Gtk::PageSetup s.

◆ list_papers() [2/2]

std::vector< Glib::RefPtr< const PageSetup > > Gtk::Printer::list_papers ( ) const

Lists all the paper sizes printer supports.

This will return and empty list unless the printer’s details are available, see has_details() and request_details().

Since gtkmm 2.12:

Returns: A newly allocated list of newly allocated Gtk::PageSetup s.

◆ on_details_acquired()

virtual void Gtk::Printer::on_details_acquired ( bool success )

protectedvirtual

This is a default handler for the signal signal_details_acquired().

◆ operator=()

Printer & Gtk::Printer::operator= ( Printer && src )

noexcept

◆ property_accepting_jobs()

Glib::PropertyProxy_ReadOnly< bool > Gtk::Printer::property_accepting_jobs ( ) const

This property is true if the printer is accepting jobs.

Since gtkmm 2.14:

Default value: true

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_accepts_pdf()

Glib::PropertyProxy_ReadOnly< bool > Gtk::Printer::property_accepts_pdf ( ) const

true if this printer can accept PDF.

Default value: false

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_accepts_ps()

Glib::PropertyProxy_ReadOnly< bool > Gtk::Printer::property_accepts_ps ( ) const

true if this printer can accept PostScript.

Default value: true

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_icon_name()

Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::Printer::property_icon_name ( ) const

The icon name to use for the printer.

Default value: ""

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_is_virtual()

Glib::PropertyProxy_ReadOnly< bool > Gtk::Printer::property_is_virtual ( ) const

false if this represents a real hardware printer.

Default value: false

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_job_count()

Glib::PropertyProxy_ReadOnly< int > Gtk::Printer::property_job_count ( ) const

Number of jobs queued in the printer.

Default value: 0

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_location()

Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::Printer::property_location ( ) const

The location of the printer.

Default value: ""

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_name()

Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::Printer::property_name ( ) const

Name of the printer.

Default value: ""

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_paused()

Glib::PropertyProxy_ReadOnly< bool > Gtk::Printer::property_paused ( ) const

This property is true if this printer is paused.

A paused printer still accepts jobs, but it does not print them.

Since gtkmm 2.14:

Default value: false

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ property_state_message()

Glib::PropertyProxy_ReadOnly< Glib::ustring > Gtk::Printer::property_state_message ( ) const

String giving the current state of the printer.

Default value: ""

Returns: A PropertyProxy_ReadOnly that allows you to get the value of the property, or receive notification when the value of the property changes.

◆ request_details()

void Gtk::Printer::request_details ( )

Requests the printer details.

When the details are available, the details_acquired signal will be emitted.

Since gtkmm 2.12:

◆ signal_details_acquired()

Glib::SignalProxy< void, bool > Gtk::Printer::signal_details_acquired ( )

Slot Prototype:: void on_my_details_acquired(bool success)

Flags: 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.

Since gtkmm 2.10:

Parameters

success true if the details were successfully acquired.

Friends And Related Function Documentation

◆ enumerate_printers()

void enumerate_printers	(	const SlotPrinterEnumerator &	slot,
		bool	wait = `true`
	)

If the callback returns true, the enumeration is stopped.

Parameters

slot	A function to call for each printer
wait	If true, wait in a recursive mainloop until all printers are enumerated; otherwise return early.

◆ operator!=()

bool operator!=	(	const Glib::RefPtr< Printer > &	lhs,
		const Glib::RefPtr< Printer > &	rhs
	)

bool operator==	(	const Glib::RefPtr< Printer > &	lhs,
		const Glib::RefPtr< Printer > &	rhs
	)

typedef sigc::slot< bool, const Glib::RefPtr<Printer>& > SlotPrinterEnumerator

Parameters

printer	A printer.
result	true to stop the enumeration, false to continue.

◆ wrap()

Glib::RefPtr< Gtk::Printer > wrap	(	GtkPrinter *	object,
		bool	take_copy = `false`
	)

Parameters

object	The C instance.
take_copy	False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns: A C++ instance that wraps this C instance.

Public Member Functions

Static Public Member Functions

Protected Member Functions

Related Functions

Detailed Description

Constructor & Destructor Documentation

◆ Printer()

◆ ~Printer()

Member Function Documentation

◆ accepts_pdf()

◆ accepts_ps()

◆ equal()

◆ get_capabilities()

◆ get_default_page_size()

◆ get_description()

◆ get_hard_margins()

◆ get_icon_name()

◆ get_job_count()

◆ get_location()

◆ get_name()

◆ get_state_message()

◆ get_type()

◆ gobj() [1/2]

◆ gobj() [2/2]

◆ gobj_copy()

◆ has_details()

◆ is_accepting_jobs()

◆ is_active()

◆ is_default()

◆ is_paused()

◆ is_virtual()

◆ list_papers() [1/2]

◆ list_papers() [2/2]

◆ on_details_acquired()

◆ operator=()

◆ property_accepting_jobs()

◆ property_accepts_pdf()

◆ property_accepts_ps()

◆ property_icon_name()

◆ property_is_virtual()

◆ property_job_count()

◆ property_location()

◆ property_name()

◆ property_paused()

◆ property_state_message()

◆ request_details()

◆ signal_details_acquired()

Friends And Related Function Documentation

◆ enumerate_printers()

◆ operator!=()

◆ operator==()

◆ SlotPrinterEnumerator

◆ wrap()