Struct gtk4::PrintJob [−][src]
pub struct PrintJob(_);
Expand description
A 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 PrintUnixDialog
API.
Use surface()
to obtain the cairo surface
onto which the pages must be drawn. Use send()
to send the finished job to the printer. If you don’t use cairo
PrintJob
also supports printing of manually generated PostScript,
via set_source_file()
.
Implements
Implementations
pub fn new(
title: &str,
printer: &Printer,
settings: &PrintSettings,
page_setup: &PageSetup
) -> PrintJob
This is supported on Linux only.
pub fn new(
title: &str,
printer: &Printer,
settings: &PrintSettings,
page_setup: &PageSetup
) -> PrintJob
This is supported on Linux only.
Creates a new builder-pattern struct instance to construct PrintJob
objects.
This method returns an instance of PrintJobBuilder
which can be used to create PrintJob
objects.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
Gets a cairo surface onto which the pages of the print job should be rendered.
Returns
the cairo surface of self
This is supported on Linux only.
This is supported on Linux only.
Returns whether jobs will be tracked after printing.
For details, see set_track_print_status()
.
Returns
true
if print job status will be reported after printing
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
This is supported on Linux only.
Make the PrintJob
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::accepts_pdf()
and
Printer::accepts_ps()
.
This is similar to set_source_file()
,
but takes expects an open file descriptor for the file,
instead of a filename.
fd
a file descriptor
Returns
false
if an error occurred
This is supported on Linux only.
Make the PrintJob
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::accepts_pdf()
and
Printer::accepts_ps()
.
filename
the file to be printed
Returns
false
if an error occurred
This is supported on Linux only.
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.
track_status
true
to track status after printing
This is supported on Linux only.
Page setup.
This is supported on Linux only.
Emitted when the status of a job changes.
The signal handler can use status()
to obtain the new status.
pub fn connect_track_print_status_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId
This is supported on Linux only.
Sends the print job off to the printer.
callback
function to call when the job completes or an error occurs
Trait Implementations
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
Returns the type identifier of Self
.
Auto Trait Implementations
impl RefUnwindSafe for PrintJob
impl UnwindSafe for PrintJob
Blanket Implementations
Mutably borrows from an owned value. Read more
Upcasts an object to a superclass or interface T
. Read more
Upcasts an object to a reference of its superclass or interface T
. Read more
Tries to downcast to a subclass or interface implementor T
. Read more
Tries to downcast to a reference of its subclass or interface implementor T
. Read more
Tries to cast to an object of type T
. This handles upcasting, downcasting
and casting between interface and interface implementors. All checks are performed at
runtime, while downcast
and upcast
will do many checks at compile-time already. Read more
Tries to cast to reference to an object of type T
. This handles upcasting, downcasting
and casting between interface and interface implementors. All checks are performed at
runtime, while downcast
and upcast
will do many checks at compile-time already. Read more
Casts to T
unconditionally. Read more
Casts to &T
unconditionally. Read more
Returns true
if the object is an instance of (can be cast to) T
.
pub fn set_property<'a, N, V>(
&self,
property_name: N,
value: V
) -> Result<(), BoolError> where
N: Into<&'a str>,
V: ToValue,
pub fn set_property_from_value<'a, N>(
&self,
property_name: N,
value: &Value
) -> Result<(), BoolError> where
N: Into<&'a str>,
pub fn set_properties_from_value(
&self,
property_values: &[(&str, Value)]
) -> Result<(), BoolError>
pub fn has_property<'a, N>(&self, property_name: N, type_: Option<Type>) -> bool where
N: Into<&'a str>,
pub fn find_property<'a, N>(&self, property_name: N) -> Option<ParamSpec> where
N: Into<&'a str>,
Safety Read more
Safety Read more
Safety Read more
Safety Read more
pub fn connect<'a, N, F>(
&self,
signal_name: N,
after: bool,
callback: F
) -> Result<SignalHandlerId, BoolError> where
N: Into<&'a str>,
F: 'static + Fn(&[Value]) -> Option<Value> + Send + Sync,
Same as connect
but takes a SignalId
instead of a signal name.
pub fn connect_local<'a, N, F>(
&self,
signal_name: N,
after: bool,
callback: F
) -> Result<SignalHandlerId, BoolError> where
N: Into<&'a str>,
F: 'static + Fn(&[Value]) -> Option<Value>,
Same as connect_local
but takes a SignalId
instead of a signal name.
pub unsafe fn connect_unsafe<'a, N, F>(
&self,
signal_name: N,
after: bool,
callback: F
) -> Result<SignalHandlerId, BoolError> where
N: Into<&'a str>,
F: Fn(&[Value]) -> Option<Value>,
Same as connect_unsafe
but takes a SignalId
instead of a signal name.
Emit signal by signal id.
Same as emit
but takes Value
for the arguments.
Emit signal by its name.
Same as emit_by_name
but takes Value
for the arguments.
Emit signal with details by signal id.
Same as emit_with_details
but takes Value
for the arguments.
pub fn connect_notify<F>(&self, name: Option<&str>, f: F) -> SignalHandlerId where
F: 'static + Fn(&T, &ParamSpec) + Send + Sync,
pub fn connect_notify_local<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: 'static + Fn(&T, &ParamSpec),
pub unsafe fn connect_notify_unsafe<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: Fn(&T, &ParamSpec),
pub fn bind_property<'a, O, N, M>(
&'a self,
source_property: N,
target: &'a O,
target_property: M
) -> BindingBuilder<'a> where
O: ObjectType,
N: Into<&'a str>,
M: Into<&'a str>,
Returns a SendValue
clone of self
.