pub struct PaperSize { /* private fields */ }
Expand description
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.
GLib type: Boxed type with copy-on-clone semantics.
Implementations§
source§impl PaperSize
impl PaperSize
sourcepub fn as_ptr(&self) -> *mut GtkPaperSize
pub fn as_ptr(&self) -> *mut GtkPaperSize
Return the inner pointer to the underlying C value.
sourcepub unsafe fn from_glib_ptr_borrow(ptr: &*mut GtkPaperSize) -> &Self
pub unsafe fn from_glib_ptr_borrow(ptr: &*mut GtkPaperSize) -> &Self
Borrows the underlying C value.
sourcepub unsafe fn from_glib_ptr_borrow_mut(ptr: &mut *mut GtkPaperSize) -> &mut Self
pub unsafe fn from_glib_ptr_borrow_mut(ptr: &mut *mut GtkPaperSize) -> &mut Self
Borrows the underlying C value mutably.
source§impl 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::PaperSize::free()
to free it
sourcepub fn from_gvariant(variant: &Variant) -> PaperSize
pub fn from_gvariant(variant: &Variant) -> PaperSize
Deserialize a paper size from a GVariant
.
The GVariant must be in the format produced by [
to_gvariant()`]Self::to_gvariant().
§variant
an a{sv} GVariant
§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::PaperSize::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>
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::PaperSize::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) -> GString
pub fn display_name(&self) -> 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) -> Variant
pub fn to_gvariant(&mut self) -> Variant
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)
Trait Implementations§
source§impl HasParamSpec for PaperSize
impl HasParamSpec for PaperSize
source§impl Ord for PaperSize
impl Ord for PaperSize
source§impl PartialOrd for PaperSize
impl PartialOrd for PaperSize
source§impl StaticType for PaperSize
impl StaticType for PaperSize
source§fn static_type() -> Type
fn static_type() -> Type
Self
.impl Eq for PaperSize
Auto Trait Implementations§
impl Freeze for PaperSize
impl RefUnwindSafe for PaperSize
impl !Send for PaperSize
impl !Sync for PaperSize
impl Unpin for PaperSize
impl UnwindSafe for PaperSize
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)