[−]Struct gtk::PrintSettings
A PrintSettings object represents the settings of a print dialog in
a system-independent way. The main use for this object is that once
you’ve printed you can get a settings object that represents the settings
the user chose, and the next time you print you can pass that object in so
that the user doesn’t have to re-set all his settings.
Its also possible to enumerate the settings so that you can easily save the settings for the next time your app runs, or even store them in a document. The predefined keys try to use shared values as much as possible so that moving such a document between systems still works.
Printing support was added in GTK+ 2.10.
Implements
Implementations
impl PrintSettings[src]
pub fn new() -> PrintSettings[src]
pub fn from_file<P: AsRef<Path>>(file_name: P) -> Result<PrintSettings, Error>[src]
pub fn from_gvariant(variant: &Variant) -> PrintSettings[src]
pub fn from_key_file(
key_file: &KeyFile,
group_name: Option<&str>
) -> Result<PrintSettings, Error>[src]
key_file: &KeyFile,
group_name: Option<&str>
) -> Result<PrintSettings, Error>
pub fn copy(&self) -> Option<PrintSettings>[src]
pub fn foreach<P: FnMut(&str, &str)>(&self, func: P)[src]
pub fn get(&self, key: &str) -> Option<GString>[src]
pub fn get_bool(&self, key: &str) -> bool[src]
Returns the boolean represented by the value
that is associated with key.
The string “true” represents true, any other
string false.
key
a key
Returns
true, if key maps to a true value.
pub fn get_collate(&self) -> bool[src]
pub fn get_default_source(&self) -> Option<GString>[src]
pub fn get_dither(&self) -> Option<GString>[src]
pub fn get_double(&self, key: &str) -> f64[src]
pub fn get_double_with_default(&self, key: &str, def: f64) -> f64[src]
Returns the floating point number represented by
the value that is associated with key, or default_val
if the value does not represent a floating point number.
Floating point numbers are parsed with g_ascii_strtod.
key
a key
def
the default value
Returns
the floating point number associated with key
pub fn get_duplex(&self) -> PrintDuplex[src]
pub fn get_finishings(&self) -> Option<GString>[src]
pub fn get_int(&self, key: &str) -> i32[src]
pub fn get_int_with_default(&self, key: &str, def: i32) -> i32[src]
Returns the value of key, interpreted as
an integer, or the default value.
key
a key
def
the default value
Returns
the integer value of key
pub fn get_length(&self, key: &str, unit: Unit) -> f64[src]
Returns the value associated with key, interpreted
as a length. The returned value is converted to units.
key
a key
unit
the unit of the return value
Returns
the length value of key, converted to unit
pub fn get_media_type(&self) -> Option<GString>[src]
Gets the value of GTK_PRINT_SETTINGS_MEDIA_TYPE.
The set of media types is defined in PWG 5101.1-2002 PWG.
Returns
the media type
pub fn get_n_copies(&self) -> i32[src]
pub fn get_number_up(&self) -> i32[src]
pub fn get_number_up_layout(&self) -> NumberUpLayout[src]
pub fn get_orientation(&self) -> PageOrientation[src]
Get the value of GTK_PRINT_SETTINGS_ORIENTATION,
converted to a PageOrientation.
Returns
the orientation
pub fn get_output_bin(&self) -> Option<GString>[src]
pub fn get_page_ranges(&self) -> Vec<PageRange>[src]
Gets the value of GTK_PRINT_SETTINGS_PAGE_RANGES.
num_ranges
return location for the length of the returned array
Returns
an array
of GtkPageRanges. Use g_free to free the array when
it is no longer needed.
pub fn get_page_set(&self) -> PageSet[src]
pub fn get_paper_height(&self, unit: Unit) -> f64[src]
Gets the value of GTK_PRINT_SETTINGS_PAPER_HEIGHT,
converted to unit.
unit
the unit for the return value
Returns
the paper height, in units of unit
pub fn get_paper_size(&self) -> PaperSize[src]
pub fn get_paper_width(&self, unit: Unit) -> f64[src]
Gets the value of GTK_PRINT_SETTINGS_PAPER_WIDTH,
converted to unit.
unit
the unit for the return value
Returns
the paper width, in units of unit
pub fn get_print_pages(&self) -> PrintPages[src]
pub fn get_printer(&self) -> Option<GString>[src]
pub fn get_printer_lpi(&self) -> f64[src]
pub fn get_quality(&self) -> PrintQuality[src]
pub fn get_resolution(&self) -> i32[src]
pub fn get_resolution_x(&self) -> i32[src]
pub fn get_resolution_y(&self) -> i32[src]
pub fn get_reverse(&self) -> bool[src]
Gets the value of GTK_PRINT_SETTINGS_REVERSE.
Returns
whether to reverse the order of the printed pages
pub fn get_scale(&self) -> f64[src]
pub fn get_use_color(&self) -> bool[src]
pub fn has_key(&self, key: &str) -> bool[src]
pub fn load_file<P: AsRef<Path>>(&self, file_name: P) -> Result<(), Error>[src]
Reads the print settings from file_name. If the file could not be loaded
then error is set to either a glib::FileError or glib::KeyFileError.
See PrintSettings::to_file.
file_name
the filename to read the settings from
Returns
true on success
pub fn load_key_file(
&self,
key_file: &KeyFile,
group_name: Option<&str>
) -> Result<(), Error>[src]
&self,
key_file: &KeyFile,
group_name: Option<&str>
) -> Result<(), Error>
Reads the print settings from the group group_name in key_file. If the
file could not be loaded then error is set to either a glib::FileError or
glib::KeyFileError.
key_file
the glib::KeyFile to retrieve the settings from
group_name
the name of the group to use, or None to use the default
“Print Settings”
Returns
true on success
pub fn set(&self, key: &str, value: Option<&str>)[src]
pub fn set_bool(&self, key: &str, value: bool)[src]
pub fn set_collate(&self, collate: bool)[src]
pub fn set_default_source(&self, default_source: &str)[src]
pub fn set_dither(&self, dither: &str)[src]
pub fn set_double(&self, key: &str, value: f64)[src]
pub fn set_duplex(&self, duplex: PrintDuplex)[src]
pub fn set_finishings(&self, finishings: &str)[src]
pub fn set_int(&self, key: &str, value: i32)[src]
pub fn set_length(&self, key: &str, value: f64, unit: Unit)[src]
pub fn set_media_type(&self, media_type: &str)[src]
Sets the value of GTK_PRINT_SETTINGS_MEDIA_TYPE.
The set of media types is defined in PWG 5101.1-2002 PWG.
media_type
the media type
pub fn set_n_copies(&self, num_copies: i32)[src]
pub fn set_number_up(&self, number_up: i32)[src]
pub fn set_number_up_layout(&self, number_up_layout: NumberUpLayout)[src]
pub fn set_orientation(&self, orientation: PageOrientation)[src]
pub fn set_output_bin(&self, output_bin: &str)[src]
pub fn set_page_set(&self, page_set: PageSet)[src]
pub fn set_paper_height(&self, height: f64, unit: Unit)[src]
pub fn set_paper_size(&self, paper_size: &PaperSize)[src]
Sets the value of GTK_PRINT_SETTINGS_PAPER_FORMAT,
GTK_PRINT_SETTINGS_PAPER_WIDTH and
GTK_PRINT_SETTINGS_PAPER_HEIGHT.
paper_size
a paper size
pub fn set_paper_width(&self, width: f64, unit: Unit)[src]
pub fn set_print_pages(&self, pages: PrintPages)[src]
pub fn set_printer(&self, printer: &str)[src]
pub fn set_printer_lpi(&self, lpi: f64)[src]
pub fn set_quality(&self, quality: PrintQuality)[src]
pub fn set_resolution(&self, resolution: i32)[src]
Sets the values of GTK_PRINT_SETTINGS_RESOLUTION,
GTK_PRINT_SETTINGS_RESOLUTION_X and
GTK_PRINT_SETTINGS_RESOLUTION_Y.
resolution
the resolution in dpi
pub fn set_resolution_xy(&self, resolution_x: i32, resolution_y: i32)[src]
Sets the values of GTK_PRINT_SETTINGS_RESOLUTION,
GTK_PRINT_SETTINGS_RESOLUTION_X and
GTK_PRINT_SETTINGS_RESOLUTION_Y.
resolution_x
the horizontal resolution in dpi
resolution_y
the vertical resolution in dpi
pub fn set_reverse(&self, reverse: bool)[src]
pub fn set_scale(&self, scale: f64)[src]
pub fn set_use_color(&self, use_color: bool)[src]
pub fn to_file<P: AsRef<Path>>(&self, file_name: P) -> Result<(), Error>[src]
This function saves the print settings from self to file_name. If the
file could not be loaded then error is set to either a glib::FileError or
glib::KeyFileError.
file_name
the file to save to
Returns
true on success
pub fn to_gvariant(&self) -> Option<Variant>[src]
pub fn to_key_file(&self, key_file: &KeyFile, group_name: Option<&str>)[src]
This function adds the print settings from self to key_file.
key_file
the glib::KeyFile to save the print settings to
group_name
the group to add the settings to in key_file, or
None to use the default “Print Settings”
pub fn unset(&self, key: &str)[src]
Removes any value associated with key.
This has the same effect as setting the value to None.
key
a key
impl PrintSettings[src]
pub fn set_page_ranges(&self, page_ranges: &[PageRange])[src]
Sets the value of GTK_PRINT_SETTINGS_PAGE_RANGES.
page_ranges
an array of GtkPageRanges
num_ranges
the length of page_ranges
Trait Implementations
impl Clone for PrintSettings
fn clone(&self) -> PrintSettings
fn clone_from(&mut self, source: &Self)1.0.0[src]
impl Debug for PrintSettings
impl Default for PrintSettings[src]
impl Display for PrintSettings[src]
impl Eq for PrintSettings
impl Hash for PrintSettings
fn hash<__H: Hasher>(&self, state: &mut __H)
fn hash_slice<H>(data: &[Self], state: &mut H) where
H: Hasher, 1.3.0[src]
H: Hasher,
impl Ord for PrintSettings
fn cmp(&self, other: &PrintSettings) -> Ordering
#[must_use]fn max(self, other: Self) -> Self1.21.0[src]
#[must_use]fn min(self, other: Self) -> Self1.21.0[src]
#[must_use]fn clamp(self, min: Self, max: Self) -> Self[src]
impl<T: ObjectType> PartialEq<T> for PrintSettings
impl<T: ObjectType> PartialOrd<T> for PrintSettings
fn partial_cmp(&self, other: &T) -> Option<Ordering>
#[must_use]fn lt(&self, other: &Rhs) -> bool1.0.0[src]
#[must_use]fn le(&self, other: &Rhs) -> bool1.0.0[src]
#[must_use]fn gt(&self, other: &Rhs) -> bool1.0.0[src]
#[must_use]fn ge(&self, other: &Rhs) -> bool1.0.0[src]
impl StaticType for PrintSettings
fn static_type() -> Type
Auto Trait Implementations
impl RefUnwindSafe for PrintSettings
impl !Send for PrintSettings
impl !Sync for PrintSettings
impl Unpin for PrintSettings
impl UnwindSafe for PrintSettings
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized, [src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized, [src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized, [src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T[src]
impl<Super, Sub> CanDowncast<Sub> for Super where
Sub: IsA<Super>,
Super: IsA<Super>,
Sub: IsA<Super>,
Super: IsA<Super>,
impl<T> Cast for T where
T: ObjectType,
T: ObjectType,
fn upcast<T>(self) -> T where
Self: IsA<T>,
T: ObjectType,
Self: IsA<T>,
T: ObjectType,
fn upcast_ref<T>(&self) -> &T where
Self: IsA<T>,
T: ObjectType,
Self: IsA<T>,
T: ObjectType,
fn downcast<T>(self) -> Result<T, Self> where
Self: CanDowncast<T>,
T: ObjectType,
Self: CanDowncast<T>,
T: ObjectType,
fn downcast_ref<T>(&self) -> Option<&T> where
Self: CanDowncast<T>,
T: ObjectType,
Self: CanDowncast<T>,
T: ObjectType,
fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,
T: ObjectType,
fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
T: ObjectType,
unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,
T: ObjectType,
unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,
T: ObjectType,
impl<T> From<T> for T[src]
impl<T, U> Into<U> for T where
U: From<T>, [src]
U: From<T>,
impl<T> ObjectExt for T where
T: ObjectType,
T: ObjectType,
fn is<U>(&self) -> bool where
U: StaticType,
U: StaticType,
fn get_type(&self) -> Type
fn get_object_class(&self) -> &ObjectClass
fn set_properties(
&self,
property_values: &[(&str, &dyn ToValue)]
) -> Result<(), BoolError>
&self,
property_values: &[(&str, &dyn ToValue)]
) -> Result<(), BoolError>
fn set_property<'a, N>(
&self,
property_name: N,
value: &dyn ToValue
) -> Result<(), BoolError> where
N: Into<&'a str>,
&self,
property_name: N,
value: &dyn ToValue
) -> Result<(), BoolError> where
N: Into<&'a str>,
fn get_property<'a, N>(&self, property_name: N) -> Result<Value, BoolError> where
N: Into<&'a str>,
N: Into<&'a str>,
unsafe fn set_qdata<QD>(&self, key: Quark, value: QD) where
QD: 'static,
QD: 'static,
unsafe fn get_qdata<QD>(&self, key: Quark) -> Option<&QD> where
QD: 'static,
QD: 'static,
unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD> where
QD: 'static,
QD: 'static,
unsafe fn set_data<QD>(&self, key: &str, value: QD) where
QD: 'static,
QD: 'static,
unsafe fn get_data<QD>(&self, key: &str) -> Option<&QD> where
QD: 'static,
QD: 'static,
unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD> where
QD: 'static,
QD: 'static,
fn block_signal(&self, handler_id: &SignalHandlerId)
fn unblock_signal(&self, handler_id: &SignalHandlerId)
fn stop_signal_emission(&self, signal_name: &str)
fn disconnect(&self, handler_id: SignalHandlerId)
fn connect_notify<F>(&self, name: Option<&str>, f: F) -> SignalHandlerId where
F: 'static + Send + Sync + Fn(&T, &ParamSpec),
F: 'static + Send + Sync + Fn(&T, &ParamSpec),
unsafe fn connect_notify_unsafe<F>(
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: Fn(&T, &ParamSpec),
&self,
name: Option<&str>,
f: F
) -> SignalHandlerId where
F: Fn(&T, &ParamSpec),
fn notify<'a, N>(&self, property_name: N) where
N: Into<&'a str>,
N: Into<&'a str>,
fn notify_by_pspec(&self, pspec: &ParamSpec)
fn has_property<'a, N>(&self, property_name: N, type_: Option<Type>) -> bool where
N: Into<&'a str>,
N: Into<&'a str>,
fn get_property_type<'a, N>(&self, property_name: N) -> Option<Type> where
N: Into<&'a str>,
N: Into<&'a str>,
fn find_property<'a, N>(&self, property_name: N) -> Option<ParamSpec> where
N: Into<&'a str>,
N: Into<&'a str>,
fn list_properties(&self) -> Vec<ParamSpec>
fn connect<'a, N, F>(
&self,
signal_name: N,
after: bool,
callback: F
) -> Result<SignalHandlerId, BoolError> where
F: Fn(&[Value]) -> Option<Value> + Send + Sync + 'static,
N: Into<&'a str>,
&self,
signal_name: N,
after: bool,
callback: F
) -> Result<SignalHandlerId, BoolError> where
F: Fn(&[Value]) -> Option<Value> + Send + Sync + 'static,
N: Into<&'a str>,
fn connect_local<'a, N, F>(
&self,
signal_name: N,
after: bool,
callback: F
) -> Result<SignalHandlerId, BoolError> where
F: Fn(&[Value]) -> Option<Value> + 'static,
N: Into<&'a str>,
&self,
signal_name: N,
after: bool,
callback: F
) -> Result<SignalHandlerId, BoolError> where
F: Fn(&[Value]) -> Option<Value> + 'static,
N: Into<&'a str>,
unsafe fn connect_unsafe<'a, N, F>(
&self,
signal_name: N,
after: bool,
callback: F
) -> Result<SignalHandlerId, BoolError> where
F: Fn(&[Value]) -> Option<Value>,
N: Into<&'a str>,
&self,
signal_name: N,
after: bool,
callback: F
) -> Result<SignalHandlerId, BoolError> where
F: Fn(&[Value]) -> Option<Value>,
N: Into<&'a str>,
fn emit<'a, N>(
&self,
signal_name: N,
args: &[&dyn ToValue]
) -> Result<Option<Value>, BoolError> where
N: Into<&'a str>,
&self,
signal_name: N,
args: &[&dyn ToValue]
) -> Result<Option<Value>, BoolError> where
N: Into<&'a str>,
fn downgrade(&self) -> WeakRef<T>
fn bind_property<'a, O, N, M>(
&'a self,
source_property: N,
target: &'a O,
target_property: M
) -> BindingBuilder<'a> where
M: Into<&'a str>,
N: Into<&'a str>,
O: ObjectType,
&'a self,
source_property: N,
target: &'a O,
target_property: M
) -> BindingBuilder<'a> where
M: Into<&'a str>,
N: Into<&'a str>,
O: ObjectType,
fn ref_count(&self) -> u32
impl<'a, T> ToGlibContainerFromSlice<'a, *const GList> for T where
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
type Storage = (Option<List>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)
fn to_glib_none_from_slice(
t: &'a [T]
) -> (*const GList, <T as ToGlibContainerFromSlice<'a, *const GList>>::Storage)
t: &'a [T]
) -> (*const GList, <T as ToGlibContainerFromSlice<'a, *const GList>>::Storage)
fn to_glib_container_from_slice(
_t: &'a [T]
) -> (*const GList, <T as ToGlibContainerFromSlice<'a, *const GList>>::Storage)
_t: &'a [T]
) -> (*const GList, <T as ToGlibContainerFromSlice<'a, *const GList>>::Storage)
fn to_glib_full_from_slice(_t: &[T]) -> *const GList
impl<'a, T> ToGlibContainerFromSlice<'a, *const GPtrArray> for T where
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
type Storage = (Option<PtrArray>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)
fn to_glib_none_from_slice(
t: &'a [T]
) -> (*const GPtrArray, <T as ToGlibContainerFromSlice<'a, *const GPtrArray>>::Storage)
t: &'a [T]
) -> (*const GPtrArray, <T as ToGlibContainerFromSlice<'a, *const GPtrArray>>::Storage)
fn to_glib_container_from_slice(
_t: &'a [T]
) -> (*const GPtrArray, <T as ToGlibContainerFromSlice<'a, *const GPtrArray>>::Storage)
_t: &'a [T]
) -> (*const GPtrArray, <T as ToGlibContainerFromSlice<'a, *const GPtrArray>>::Storage)
fn to_glib_full_from_slice(_t: &[T]) -> *const GPtrArray
impl<'a, T> ToGlibContainerFromSlice<'a, *mut GArray> for T where
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
type Storage = (Option<Array>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)
fn to_glib_none_from_slice(
t: &'a [T]
) -> (*mut GArray, <T as ToGlibContainerFromSlice<'a, *mut GArray>>::Storage)
t: &'a [T]
) -> (*mut GArray, <T as ToGlibContainerFromSlice<'a, *mut GArray>>::Storage)
fn to_glib_container_from_slice(
t: &'a [T]
) -> (*mut GArray, <T as ToGlibContainerFromSlice<'a, *mut GArray>>::Storage)
t: &'a [T]
) -> (*mut GArray, <T as ToGlibContainerFromSlice<'a, *mut GArray>>::Storage)
fn to_glib_full_from_slice(t: &[T]) -> *mut GArray
impl<'a, T> ToGlibContainerFromSlice<'a, *mut GList> for T where
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
type Storage = (Option<List>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)
fn to_glib_none_from_slice(
t: &'a [T]
) -> (*mut GList, <T as ToGlibContainerFromSlice<'a, *mut GList>>::Storage)
t: &'a [T]
) -> (*mut GList, <T as ToGlibContainerFromSlice<'a, *mut GList>>::Storage)
fn to_glib_container_from_slice(
t: &'a [T]
) -> (*mut GList, <T as ToGlibContainerFromSlice<'a, *mut GList>>::Storage)
t: &'a [T]
) -> (*mut GList, <T as ToGlibContainerFromSlice<'a, *mut GList>>::Storage)
fn to_glib_full_from_slice(t: &[T]) -> *mut GList
impl<'a, T> ToGlibContainerFromSlice<'a, *mut GPtrArray> for T where
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
T: GlibPtrDefault + ToGlibPtr<'a, <T as GlibPtrDefault>::GlibType>,
type Storage = (Option<PtrArray>, Vec<Stash<'a, <T as GlibPtrDefault>::GlibType, T>>)
fn to_glib_none_from_slice(
t: &'a [T]
) -> (*mut GPtrArray, <T as ToGlibContainerFromSlice<'a, *mut GPtrArray>>::Storage)
t: &'a [T]
) -> (*mut GPtrArray, <T as ToGlibContainerFromSlice<'a, *mut GPtrArray>>::Storage)
fn to_glib_container_from_slice(
t: &'a [T]
) -> (*mut GPtrArray, <T as ToGlibContainerFromSlice<'a, *mut GPtrArray>>::Storage)
t: &'a [T]
) -> (*mut GPtrArray, <T as ToGlibContainerFromSlice<'a, *mut GPtrArray>>::Storage)
fn to_glib_full_from_slice(t: &[T]) -> *mut GPtrArray
impl<T> ToOwned for T where
T: Clone, [src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T[src]
fn clone_into(&self, target: &mut T)[src]
impl<T> ToSendValue for T where
T: ToValue + SetValue + Send + ?Sized,
T: ToValue + SetValue + Send + ?Sized,
fn to_send_value(&self) -> SendValue
impl<T> ToString for T where
T: Display + ?Sized, [src]
T: Display + ?Sized,
impl<T> ToValue for T where
T: SetValue + ?Sized,
T: SetValue + ?Sized,
fn to_value(&self) -> Value
fn to_value_type(&self) -> Type
impl<T, U> TryFrom<U> for T where
U: Into<T>, [src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>, [src]
U: TryFrom<T>,