#[repr(transparent)]pub struct PaperSize { /* private fields */ }
Expand description
GtkPaperSize handles paper sizes. It uses the standard called PWG 5101.1-2002 PWG: Standard for Media Standardized Names to name the paper sizes (and to get the data for the page sizes). In addition to standard paper sizes, GtkPaperSize allows to construct custom paper sizes with arbitrary dimensions.
The PaperSize
object stores not only the dimensions (width
and height) of a paper size and its name, it also provides
default [print margins][print-margins].
Printing support has been added in GTK+ 2.10.
Implementations
sourceimpl PaperSize
impl PaperSize
sourcepub fn new_custom(
name: &str,
display_name: &str,
width: f64,
height: f64,
unit: Unit
) -> PaperSize
pub fn new_custom(
name: &str,
display_name: &str,
width: f64,
height: f64,
unit: Unit
) -> PaperSize
Creates a new PaperSize
object with the
given parameters.
name
the paper name
display_name
the human-readable name
width
the paper width, in units of unit
height
the paper height, in units of unit
unit
the unit for width
and height
. not Unit::None
.
Returns
a new PaperSize
object, use gtk_paper_size_free()
to free it
sourcepub fn from_gvariant(variant: &Variant) -> PaperSize
Available on crate feature v3_22
only.
pub fn from_gvariant(variant: &Variant) -> PaperSize
v3_22
only.Deserialize a paper size from an a{sv} variant in
the format produced by to_gvariant()
.
variant
an a{sv} glib::Variant
Returns
a new PaperSize
object
sourcepub fn from_ipp(ipp_name: &str, width: f64, height: f64) -> PaperSize
pub fn from_ipp(ipp_name: &str, width: f64, height: f64) -> PaperSize
Creates a new PaperSize
object by using
IPP information.
If ipp_name
is not a recognized paper name,
width
and height
are used to
construct a custom PaperSize
object.
ipp_name
an IPP paper name
width
the paper width, in points
height
the paper height in points
Returns
a new PaperSize
, use gtk_paper_size_free()
to free it
sourcepub fn from_key_file(
key_file: &KeyFile,
group_name: Option<&str>
) -> Result<PaperSize, Error>
pub fn from_key_file(
key_file: &KeyFile,
group_name: Option<&str>
) -> Result<PaperSize, Error>
Reads a paper size from the group group_name
in the key file
key_file
.
key_file
the glib::KeyFile
to retrieve the papersize from
group_name
the name of the group in the key file to read,
or None
to read the first group
Returns
a new PaperSize
object with the restored
paper size, or None
if an error occurred
sourcepub fn from_ppd(
ppd_name: &str,
ppd_display_name: &str,
width: f64,
height: f64
) -> PaperSize
pub fn from_ppd(
ppd_name: &str,
ppd_display_name: &str,
width: f64,
height: f64
) -> PaperSize
Creates a new PaperSize
object by using
PPD information.
If ppd_name
is not a recognized PPD paper name,
ppd_display_name
, width
and height
are used to
construct a custom PaperSize
object.
ppd_name
a PPD paper name
ppd_display_name
the corresponding human-readable name
width
the paper width, in points
height
the paper height in points
Returns
a new PaperSize
, use gtk_paper_size_free()
to free it
sourcepub fn default_bottom_margin(&self, unit: Unit) -> f64
pub fn default_bottom_margin(&self, unit: Unit) -> f64
Gets the default bottom margin for the PaperSize
.
unit
the unit for the return value, not Unit::None
Returns
the default bottom margin
sourcepub fn default_left_margin(&self, unit: Unit) -> f64
pub fn default_left_margin(&self, unit: Unit) -> f64
Gets the default left margin for the PaperSize
.
unit
the unit for the return value, not Unit::None
Returns
the default left margin
sourcepub fn default_right_margin(&self, unit: Unit) -> f64
pub fn default_right_margin(&self, unit: Unit) -> f64
Gets the default right margin for the PaperSize
.
unit
the unit for the return value, not Unit::None
Returns
the default right margin
sourcepub fn default_top_margin(&self, unit: Unit) -> f64
pub fn default_top_margin(&self, unit: Unit) -> f64
Gets the default top margin for the PaperSize
.
unit
the unit for the return value, not Unit::None
Returns
the default top margin
sourcepub fn display_name(&self) -> Option<GString>
pub fn display_name(&self) -> Option<GString>
sourcepub fn height(&self, unit: Unit) -> f64
pub fn height(&self, unit: Unit) -> f64
Gets the paper height of the PaperSize
, in
units of unit
.
unit
the unit for the return value, not Unit::None
Returns
the paper height
sourcepub fn width(&self, unit: Unit) -> f64
pub fn width(&self, unit: Unit) -> f64
Gets the paper width of the PaperSize
, in
units of unit
.
unit
the unit for the return value, not Unit::None
Returns
the paper width
sourcepub fn to_gvariant(&mut self) -> Option<Variant>
Available on crate feature v3_22
only.
pub fn to_gvariant(&mut self) -> Option<Variant>
v3_22
only.sourcepub fn to_key_file(&mut self, key_file: &KeyFile, group_name: &str)
pub fn to_key_file(&mut self, key_file: &KeyFile, group_name: &str)
This function adds the paper size from self
to key_file
.
key_file
the glib::KeyFile
to save the paper size to
group_name
the group to add the settings to in key_file
sourcepub fn default() -> Option<GString>
pub fn default() -> Option<GString>
Returns the name of the default paper size, which depends on the current locale.
Returns
the name of the default paper size. The string is owned by GTK+ and should not be modified.
sourcepub fn paper_sizes(include_custom: bool) -> Vec<PaperSize>
pub fn paper_sizes(include_custom: bool) -> Vec<PaperSize>
Creates a list of known paper sizes.
include_custom
whether to include custom paper sizes as defined in the page setup dialog
Returns
a newly allocated list of newly
allocated PaperSize
objects
Trait Implementations
sourceimpl Ord for PaperSize
impl Ord for PaperSize
sourceimpl PartialOrd<PaperSize> for PaperSize
impl PartialOrd<PaperSize> for PaperSize
sourcefn partial_cmp(&self, other: &PaperSize) -> Option<Ordering>
fn partial_cmp(&self, other: &PaperSize) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
sourceimpl StaticType for PaperSize
impl StaticType for PaperSize
sourcefn static_type() -> Type
fn static_type() -> Type
Returns the type identifier of Self
.
impl Eq for PaperSize
Auto Trait Implementations
impl RefUnwindSafe for PaperSize
impl !Send for PaperSize
impl !Sync for PaperSize
impl Unpin for PaperSize
impl UnwindSafe for PaperSize
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> StaticTypeExt for T where
T: StaticType,
impl<T> StaticTypeExt for T where
T: StaticType,
sourcefn ensure_type()
fn ensure_type()
Ensures that the type has been registered with the type system.
sourceimpl<T> ToClosureReturnValue for T where
T: ToValue,
impl<T> ToClosureReturnValue for T where
T: ToValue,
fn to_closure_return_value(&self) -> Option<Value>
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more