Struct gtk::PaperSize

pub struct PaperSize(_);

PaperSize 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, PaperSize 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

impl PaperSize

pub fn new(name: Option<&str>) -> PaperSize

Creates a new PaperSize object by parsing a PWG 5101.1-2002 paper name.

If name is None, the default paper size is returned, see PaperSize::get_default.

name

a paper size name, or None

Returns

a new PaperSize, use PaperSize::free to free it

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 PaperSize::free to free it

pub fn from_gvariant(variant: &Variant) -> PaperSize

pub fn from_ipp(ipp_name: &str, width: f64, height: f64) -> PaperSize

pub fn from_key_file(
    key_file: &KeyFile,
    group_name: Option<&str>
) -> Result<PaperSize, Error>

pub fn from_ppd(
    ppd_name: &str,
    ppd_display_name: &str,
    width: f64,
    height: f64
) -> PaperSize

pub fn get_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

pub fn get_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

pub fn get_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

pub fn get_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

pub fn get_display_name(&self) -> Option<GString>

Gets the human-readable name of the PaperSize.

Returns

the human-readable name of self

pub fn get_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

pub fn get_name(&self) -> Option<GString>

Gets the name of the PaperSize.

Returns

the name of self

pub fn get_ppd_name(&self) -> Option<GString>

Gets the PPD name of the PaperSize, which may be None.

Returns

the PPD name of self

pub fn get_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

pub fn is_custom(&self) -> bool

Returns true if self is not a standard paper size.

Returns

whether self is a custom paper size.

pub fn is_ipp(&self) -> bool

Returns true if self is an IPP standard paper size.

Returns

whether self is not an IPP custom paper size.

pub fn set_size(&mut self, width: f64, height: f64, unit: Unit)

Changes the dimensions of a self to width x height.

width

the new width in units of unit

height

the new height in units of unit

unit

the unit for width and height

pub fn to_gvariant(&mut self) -> Option<Variant>

Serialize a paper size to an a{sv} variant.

Feature: v3_22

Returns

a new, floating, glib::Variant

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

pub fn get_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.

pub fn get_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

impl Clone for PaperSize

fn clone(&self) -> PaperSize

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PaperSize

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for PaperSize

impl Hash for PaperSize

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl Ord for PaperSize

fn cmp(&self, other: &PaperSize) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<PaperSize> for PaperSize

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialOrd<PaperSize> for PaperSize

fn partial_cmp(&self, other: &PaperSize) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &PaperSize) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &PaperSize) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &PaperSize) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &PaperSize) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for PaperSize

fn static_type() -> Type

Returns the type identifier of Self.