Gtk::Printer Diff - Ruby-GNOME2 Project Website
- Added parts are displayed like this.
- Deleted parts are displayed
like this.
= class Gtk::Printer
A Gtk::Printer object represents a printer. You only need to deal directly with printers if you use the non-portable Gtk::PrintUnixDialog API.
A Gtk::Printer allows to get status information about the printer, such as its description, its location, the number of queued jobs, etc. Most importantly, a Gtk::Printer object can be used to create a Gtk::PrintJob object, which lets you print to the printer.
Printing support was added in GTK+ 2.10.
== Object Hierarchy
* Object
* GLib::Instantiatable
* GLib::Object
* Gtk::Printer
== Included Modules
* Comparable
== Class Methods
--- Gtk::Printer.each(wait = false){|printer| ... }
Iterates all ((<Gtk::Printer>))s. ((* Since 2.10 *))
* {|printer| ...}: a block to iterate printers.
* printer: an Gtk::Printer
* Returns: true if the enumeration is stopped, false is continue.
* wait: if true, wait in a recursive mainloop until all
printers are enumerated; otherwise return early
* Returns: self
--- Gtk::Printer.printers(wait = false)
Retrives Printers. ((* Since 2.10 *))
* wait: if true, wait in a recursive mainloop until all
printers are enumerated; otherwise return early
* Returns: An Array of ((<Gtk::Printer>))s.
--- Gtk::Printer.new(name, backend, virtual)
Creates a new Gtk::Printer. ((* Since 2.10 *))
* name: the name of the printer
* backend: a Gtk::PrintBackend
* virtual: whether the printer is virtual
* Returns: a new Gtk::Printer
== Instance Methods
--- <=>(other)
Compares two printers. ((* Since 2.10 *))
* Returns: 0 if the printer match, a negative value if
((|self|)) < ((|other|)), or a positive value if
((|self|)) > ((|other|))
--- active?
Returns whether the printer is currently active
(i.e. accepts new jobs). ((* Since 2.10 *))
* Returns: true if self is active
--- default?
Returns whether the printer is the default printer. ((* Since 2.10 *))
* Returns: true if self is the default
--- description
Gets the description of the printer. ((* Since 2.10 *))
* Returns: the description of printer.
--- accepts_pdf?
Gets the value whether this printer can accept PDF. ((* Since 2.10 *))
* Returns: true if this printer can accept PDF
--- accepts_pdf=(accepts_pdf)
Sets the value this printer can accept PDF. ((* Since 2.10 *))
* accepts_pdf: true if this printer can accept PDF
* Returns: accepts_pdf
--- set_accepts_pdf(accepts_pdf)
Same as accepts_pdf=. ((* Since 2.10 *))
* accepts_pdf: true if this printer can accept PDF
* Returns: self
--- accepts_ps?
Gets the value whether this printer can accept PostScript. ((* Since 2.10 *))
* Returns: true if this printer can accept PostScript
--- accepts_ps=(accepts_ps)
Sets the value whether this printer can accept PostScript. ((* Since 2.10 *))
* accepts_ps: true if this printer can accept PostScript
* Returns: accepts_ps
--- set_accepts_ps(accepts_ps)
Same as accepts_ps=. ((* Since 2.10 *))
* accepts_ps: true if this printer can accept PostScript
* Returns: self
--- backend
Gets the Gtk::PrintBackend for the printer. ((* Since 2.10 *))
* Returns: Gtk::PrintBackend for the printer
--- backend=(backend)
Sets the Gtk::PrintBackend for the printer. ((* Since 2.10 *))
* backend: Gtk::PrintBackend for the printer
* Returns: backend
--- set_backend(backend)
Same as backend=. ((* Since 2.10 *))
* backend: Gtk::PrintBackend for the printer
* Returns: self
--- icon_name
Gets the icon name to use for the printer. ((* Since 2.10 *))
* Returns: The icon name to use for the printer
--- virtual?
Gets the value whether this represents a real hardware printer. ((* Since 2.10 *))
* Returns: false if this represents a real hardware printer
--- virtual=(virtual)
Sets the value whether this represents a real hardware printer. ((* Since 2.10 *))
* virtual: false if this represents a real hardware printer
* Returns: virtual
--- set_virtual(virtual)
Same as virtual=. ((* Since 2.10 *))
* virtual: false if this represents a real hardware printer
* Returns: self
--- job_count
Gets the Number of jobs queued in the printer. ((* Since 2.10 *))
* Returns: Number of jobs queued in the printer
--- location
Gets the location of the printer. ((* Since 2.10 *))
* Returns: The location of the printer
--- name
Gets the Name of the printer. ((* Since 2.10 *))
* Returns: Name of the printer
--- name=(name)
Sets the Name of the printer. ((* Since 2.10 *))
* name: Name of the printer
* Returns: name
--- set_name(name)
Same as name=. ((* Since 2.10 *))
* name: Name of the printer
* Returns: self
--- state_message
Gets the String giving the current state of the printer. ((* Since 2.10 *))
* Returns: String giving the current state of the printer
--- accepting_jobs?
Gets the true if this printer is accepting new jobs.
* Returns: true if this printer is accepting new jobs
--- paused?
Gets the true if this printer is paused.
* Returns: true if this printer is paused
== Properties
--- accepts-pdf: true or false (Read/Write)
true if this printer can accept PDF ((* Since 2.10 *))
--- accepts-ps: true or false (Read/Write)
true if this printer can accept PostScript ((* Since 2.10 *))
--- backend: Gtk::PrintBackend (Read/Write)
Gtk::PrintBackend for the printer ((* Since 2.10 *))
--- icon-name: String (Read)
The icon name to use for the printer ((* Since 2.10 *))
--- is-virtual: true or false (Read/Write)
false if this represents a real hardware printer ((* Since 2.10 *))
--- job-count: Integer (Read)
Number of jobs queued in the printer ((* Since 2.10 *))
--- location: String (Read)
The location of the printer ((* Since 2.10 *))
--- name: String (Read/Write)
Name of the printer ((* Since 2.10 *))
--- state-message: String (Read)
String giving the current state of the printer ((* Since 2.10 *))
--- accepting-jobs: true or false (Read)
true if this printer is accepting new jobs
--- paused: true or false (Read)
true if this printer is paused
== Signals
--- details-acquired: self, success
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 2.10 *))
* self: the Gtk::Printer on which the signal is emitted
* success: true if the details were successfully acquired
== See Also
== ChangeLog
* 2006-11-02: Modified. - ((<Masao>))
* 2006-07-10: updated for 2.10. - ((<kou>))
- ((<kou>))
A Gtk::Printer object represents a printer. You only need to deal directly with printers if you use the non-portable Gtk::PrintUnixDialog API.
A Gtk::Printer allows to get status information about the printer, such as its description, its location, the number of queued jobs, etc. Most importantly, a Gtk::Printer object can be used to create a Gtk::PrintJob object, which lets you print to the printer.
Printing support was added in GTK+ 2.10.
== Object Hierarchy
* Object
* GLib::Instantiatable
* GLib::Object
* Gtk::Printer
== Included Modules
* Comparable
== Class Methods
--- Gtk::Printer.each(wait = false){|printer| ... }
Iterates all ((<Gtk::Printer>))s. ((* Since 2.10 *))
* {|printer| ...}: a block to iterate printers.
* printer: an Gtk::Printer
* Returns: true if the enumeration is stopped, false is continue.
* wait: if true, wait in a recursive mainloop until all
printers are enumerated; otherwise return early
* Returns: self
--- Gtk::Printer.printers(wait = false)
Retrives Printers. ((* Since 2.10 *))
* wait: if true, wait in a recursive mainloop until all
printers are enumerated; otherwise return early
* Returns: An Array of ((<Gtk::Printer>))s.
--- Gtk::Printer.new(name, backend, virtual)
Creates a new Gtk::Printer. ((* Since 2.10 *))
* name: the name of the printer
* backend: a Gtk::PrintBackend
* virtual: whether the printer is virtual
* Returns: a new Gtk::Printer
== Instance Methods
--- <=>(other)
Compares two printers. ((* Since 2.10 *))
* Returns: 0 if the printer match, a negative value if
((|self|)) < ((|other|)), or a positive value if
((|self|)) > ((|other|))
--- active?
Returns whether the printer is currently active
(i.e. accepts new jobs). ((* Since 2.10 *))
* Returns: true if self is active
--- default?
Returns whether the printer is the default printer. ((* Since 2.10 *))
* Returns: true if self is the default
--- description
Gets the description of the printer. ((* Since 2.10 *))
* Returns: the description of printer.
--- accepts_pdf?
Gets the value whether this printer can accept PDF. ((* Since 2.10 *))
* Returns: true if this printer can accept PDF
--- accepts_pdf=(accepts_pdf)
Sets the value this printer can accept PDF. ((* Since 2.10 *))
* accepts_pdf: true if this printer can accept PDF
* Returns: accepts_pdf
--- set_accepts_pdf(accepts_pdf)
Same as accepts_pdf=. ((* Since 2.10 *))
* accepts_pdf: true if this printer can accept PDF
* Returns: self
--- accepts_ps?
Gets the value whether this printer can accept PostScript. ((* Since 2.10 *))
* Returns: true if this printer can accept PostScript
--- accepts_ps=(accepts_ps)
Sets the value whether this printer can accept PostScript. ((* Since 2.10 *))
* accepts_ps: true if this printer can accept PostScript
* Returns: accepts_ps
--- set_accepts_ps(accepts_ps)
Same as accepts_ps=. ((* Since 2.10 *))
* accepts_ps: true if this printer can accept PostScript
* Returns: self
--- backend
Gets the Gtk::PrintBackend for the printer. ((* Since 2.10 *))
* Returns: Gtk::PrintBackend for the printer
--- backend=(backend)
Sets the Gtk::PrintBackend for the printer. ((* Since 2.10 *))
* backend: Gtk::PrintBackend for the printer
* Returns: backend
--- set_backend(backend)
Same as backend=. ((* Since 2.10 *))
* backend: Gtk::PrintBackend for the printer
* Returns: self
--- icon_name
Gets the icon name to use for the printer. ((* Since 2.10 *))
* Returns: The icon name to use for the printer
--- virtual?
Gets the value whether this represents a real hardware printer. ((* Since 2.10 *))
* Returns: false if this represents a real hardware printer
--- virtual=(virtual)
Sets the value whether this represents a real hardware printer. ((* Since 2.10 *))
* virtual: false if this represents a real hardware printer
* Returns: virtual
--- set_virtual(virtual)
Same as virtual=. ((* Since 2.10 *))
* virtual: false if this represents a real hardware printer
* Returns: self
--- job_count
Gets the Number of jobs queued in the printer. ((* Since 2.10 *))
* Returns: Number of jobs queued in the printer
--- location
Gets the location of the printer. ((* Since 2.10 *))
* Returns: The location of the printer
--- name
Gets the Name of the printer. ((* Since 2.10 *))
* Returns: Name of the printer
--- name=(name)
Sets the Name of the printer. ((* Since 2.10 *))
* name: Name of the printer
* Returns: name
--- set_name(name)
Same as name=. ((* Since 2.10 *))
* name: Name of the printer
* Returns: self
--- state_message
Gets the String giving the current state of the printer. ((* Since 2.10 *))
* Returns: String giving the current state of the printer
--- accepting_jobs?
Gets the true if this printer is accepting new jobs.
* Returns: true if this printer is accepting new jobs
--- paused?
Gets the true if this printer is paused.
* Returns: true if this printer is paused
== Properties
--- accepts-pdf: true or false (Read/Write)
true if this printer can accept PDF ((* Since 2.10 *))
--- accepts-ps: true or false (Read/Write)
true if this printer can accept PostScript ((* Since 2.10 *))
--- backend: Gtk::PrintBackend (Read/Write)
Gtk::PrintBackend for the printer ((* Since 2.10 *))
--- icon-name: String (Read)
The icon name to use for the printer ((* Since 2.10 *))
--- is-virtual: true or false (Read/Write)
false if this represents a real hardware printer ((* Since 2.10 *))
--- job-count: Integer (Read)
Number of jobs queued in the printer ((* Since 2.10 *))
--- location: String (Read)
The location of the printer ((* Since 2.10 *))
--- name: String (Read/Write)
Name of the printer ((* Since 2.10 *))
--- state-message: String (Read)
String giving the current state of the printer ((* Since 2.10 *))
--- accepting-jobs: true or false (Read)
true if this printer is accepting new jobs
--- paused: true or false (Read)
true if this printer is paused
== Signals
--- details-acquired: self, success
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 2.10 *))
* self: the Gtk::Printer on which the signal is emitted
* success: true if the details were successfully acquired
== See Also
== ChangeLog
* 2006-11-02: Modified. - ((<Masao>))
* 2006-07-10: updated for 2.10. - ((<kou>))
- ((<kou>))