Struct gtk4::PageSetup

source ·

pub struct PageSetup { /* private fields */ }

Expand description

A PageSetup object stores the page size, orientation and margins.

The idea is that you can get one of these from the page setup dialog and then pass it to the PrintOperation when printing. The benefit of splitting this out of the PrintSettings is that these affect the actual layout of the page, and thus need to be set long before user prints.

§Margins

The margins specified in this object are the “print margins”, i.e. the parts of the page that the printer cannot print on. These are different from the layout margins that a word processor uses; they are typically used to determine the minimal size for the layout margins.

To obtain a PageSetup use new() to get the defaults, or use print_run_page_setup_dialog() to show the page setup dialog and receive the resulting page setup.

§A page setup dialog

⚠️ The following code is in c ⚠️

static GtkPrintSettings *settings = NULL;
static GtkPageSetup *page_setup = NULL;

static void
do_page_setup (void)
{
  GtkPageSetup *new_page_setup;

  if (settings == NULL)
    settings = gtk_print_settings_new ();

  new_page_setup = gtk_print_run_page_setup_dialog (GTK_WINDOW (main_window),
                                                    page_setup, settings);

  if (page_setup)
    g_object_unref (page_setup);

  page_setup = new_page_setup;
}

§Implements

[trait@glib::ObjectExt]

Struct gtk4::PageSetupCopy item path

§Margins

§A page setup dialog

§Implements

Implementations§

impl PageSetup

pub fn new() -> PageSetup

§Returns

pub fn from_file(file_name: impl AsRef<Path>) -> Result<PageSetup, Error>

§file_name

§Returns

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

§variant

§Returns

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

§key_file

§group_name

§Returns

pub fn copy(&self) -> PageSetup

pub fn bottom_margin(&self, unit: Unit) -> f64

§unit

§Returns

pub fn left_margin(&self, unit: Unit) -> f64

§unit

§Returns

pub fn orientation(&self) -> PageOrientation

§Returns

pub fn page_height(&self, unit: Unit) -> f64

§unit

§Returns

pub fn page_width(&self, unit: Unit) -> f64

§unit

§Returns

pub fn paper_height(&self, unit: Unit) -> f64

§unit

§Returns

pub fn paper_size(&self) -> PaperSize

§Returns

pub fn paper_width(&self, unit: Unit) -> f64

§unit

§Returns

pub fn right_margin(&self, unit: Unit) -> f64

§unit

§Returns

pub fn top_margin(&self, unit: Unit) -> f64

§unit

§Returns

pub fn load_file(&self, file_name: impl AsRef<Path>) -> Result<(), Error>

§file_name

§Returns

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

§key_file

§group_name

§Returns

pub fn set_bottom_margin(&self, margin: f64, unit: Unit)

§margin

§unit

pub fn set_left_margin(&self, margin: f64, unit: Unit)

§margin

§unit

pub fn set_orientation(&self, orientation: PageOrientation)

§orientation

pub fn set_paper_size(&self, size: &PaperSize)

§size

pub fn set_paper_size_and_default_margins(&self, size: &PaperSize)

§size

pub fn set_right_margin(&self, margin: f64, unit: Unit)

§margin

§unit

pub fn set_top_margin(&self, margin: f64, unit: Unit)

§margin

§unit

pub fn to_file(&self, file_name: impl AsRef<Path>) -> Result<(), Error>

§file_name

§Returns

pub fn to_gvariant(&self) -> Variant

§Returns

pub fn to_key_file(&self, key_file: &KeyFile, group_name: Option<&str>)

§key_file

§group_name

Struct gtk4::PageSetup

§`file_name`

§`variant`

§`key_file`

§`group_name`

§`unit`

§`unit`

§`unit`

§`unit`

§`unit`

§`unit`

§`unit`

§`unit`

§`file_name`

§`key_file`

§`group_name`

§`margin`

§`unit`

§`margin`

§`unit`

§`orientation`

§`size`

§`size`

§`margin`

§`unit`

§`margin`

§`unit`

§`file_name`

§`key_file`

§`group_name`

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

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

fn max(self, other: Self) -> Self
where Self: Sized,

fn min(self, other: Self) -> Self
where Self: Sized,

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized + PartialOrd,

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<T> Cast for T
where T: ObjectType,

fn upcast<T>(self) -> T
where T: ObjectType, Self: IsA<T>,

fn upcast_ref<T>(&self) -> &T
where T: ObjectType, Self: IsA<T>,

fn downcast<T>(self) -> Result<T, Self>
where T: ObjectType, Self: MayDowncastTo<T>,

fn downcast_ref<T>(&self) -> Option<&T>
where T: ObjectType, Self: MayDowncastTo<T>,

fn dynamic_cast<T>(self) -> Result<T, Self>
where T: ObjectType,

fn dynamic_cast_ref<T>(&self) -> Option<&T>
where T: ObjectType,

unsafe fn unsafe_cast<T>(self) -> T
where T: ObjectType,

unsafe fn unsafe_cast_ref<T>(&self) -> &T
where T: ObjectType,

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,