gi-gtk-3.0.24: Gtk bindings

CopyrightWill Thompson Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria (garetxe@gmail.com)
Safe HaskellNone
LanguageHaskell2010

GI.Gtk.Objects.PageSetup

Contents

Description

A GtkPageSetup 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.

## {print-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 pageSetupNew to get the defaults, or use printRunPageSetupDialog to show the page setup dialog and receive the resulting page setup.

A page setup dialog

C code

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;
}

Printing support was added in GTK+ 2.10.

Synopsis

Exported types

newtype PageSetup Source #

Memory-managed wrapper type.

Instances
GObject PageSetup Source # 
Instance details

Defined in GI.Gtk.Objects.PageSetup

IsObject PageSetup Source # 
Instance details

Defined in GI.Gtk.Objects.PageSetup

IsPageSetup PageSetup Source # 
Instance details

Defined in GI.Gtk.Objects.PageSetup

class GObject o => IsPageSetup o Source #

Type class for types which can be safely cast to PageSetup, for instance with toPageSetup.

Instances
(GObject a, (UnknownAncestorError PageSetup a :: Constraint)) => IsPageSetup a Source # 
Instance details

Defined in GI.Gtk.Objects.PageSetup

IsPageSetup PageSetup Source # 
Instance details

Defined in GI.Gtk.Objects.PageSetup

toPageSetup :: (MonadIO m, IsPageSetup o) => o -> m PageSetup Source #

Cast to PageSetup, for types for which this is known to be safe. For general casts, use castTo.

noPageSetup :: Maybe PageSetup Source #

A convenience alias for Nothing :: Maybe PageSetup.

Methods

copy

pageSetupCopy Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

other: the PageSetup to copy

-> m PageSetup

Returns: a copy of other

Copies a PageSetup.

Since: 2.10

getBottomMargin

pageSetupGetBottomMargin Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Unit

unit: the unit for the return value

-> m Double

Returns: the bottom margin

Gets the bottom margin in units of unit.

Since: 2.10

getLeftMargin

pageSetupGetLeftMargin Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Unit

unit: the unit for the return value

-> m Double

Returns: the left margin

Gets the left margin in units of unit.

Since: 2.10

getOrientation

pageSetupGetOrientation Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> m PageOrientation

Returns: the page orientation

Gets the page orientation of the PageSetup.

Since: 2.10

getPageHeight

pageSetupGetPageHeight Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Unit

unit: the unit for the return value

-> m Double

Returns: the page height.

Returns the page height in units of unit.

Note that this function takes orientation and margins into consideration. See pageSetupGetPaperHeight.

Since: 2.10

getPageWidth

pageSetupGetPageWidth Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Unit

unit: the unit for the return value

-> m Double

Returns: the page width.

Returns the page width in units of unit.

Note that this function takes orientation and margins into consideration. See pageSetupGetPaperWidth.

Since: 2.10

getPaperHeight

pageSetupGetPaperHeight Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Unit

unit: the unit for the return value

-> m Double

Returns: the paper height.

Returns the paper height in units of unit.

Note that this function takes orientation, but not margins into consideration. See pageSetupGetPageHeight.

Since: 2.10

getPaperSize

pageSetupGetPaperSize Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> m PaperSize

Returns: the paper size

Gets the paper size of the PageSetup.

Since: 2.10

getPaperWidth

pageSetupGetPaperWidth Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Unit

unit: the unit for the return value

-> m Double

Returns: the paper width.

Returns the paper width in units of unit.

Note that this function takes orientation, but not margins into consideration. See pageSetupGetPageWidth.

Since: 2.10

getRightMargin

pageSetupGetRightMargin Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Unit

unit: the unit for the return value

-> m Double

Returns: the right margin

Gets the right margin in units of unit.

Since: 2.10

getTopMargin

pageSetupGetTopMargin Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Unit

unit: the unit for the return value

-> m Double

Returns: the top margin

Gets the top margin in units of unit.

Since: 2.10

loadFile

pageSetupLoadFile Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> [Char]

fileName: the filename to read the page setup from

-> m ()

(Can throw GError)

Reads the page setup from the file fileName. See pageSetupToFile.

Since: 2.14

loadKeyFile

pageSetupLoadKeyFile Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> KeyFile

keyFile: the KeyFile to retrieve the page_setup from

-> Maybe Text

groupName: the name of the group in the key_file to read, or Nothing to use the default name “Page Setup”

-> m ()

(Can throw GError)

Reads the page setup from the group groupName in the key file keyFile.

Since: 2.14

new

pageSetupNew Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> m PageSetup

Returns: a new PageSetup.

Creates a new PageSetup.

Since: 2.10

newFromFile

pageSetupNewFromFile Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> [Char]

fileName: the filename to read the page setup from

-> m PageSetup

Returns: the restored PageSetup (Can throw GError)

Reads the page setup from the file fileName. Returns a new PageSetup object with the restored page setup, or Nothing if an error occurred. See pageSetupToFile.

Since: 2.12

newFromGvariant

pageSetupNewFromGvariant Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> GVariant

variant: an a{sv} GVariant

-> m PageSetup

Returns: a new PageSetup object

Desrialize a page setup from an a{sv} variant in the format produced by pageSetupToGvariant.

Since: 3.22

newFromKeyFile

pageSetupNewFromKeyFile Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> KeyFile

keyFile: the KeyFile to retrieve the page_setup from

-> Maybe Text

groupName: the name of the group in the key_file to read, or Nothing to use the default name “Page Setup”

-> m PageSetup

Returns: the restored PageSetup (Can throw GError)

Reads the page setup from the group groupName in the key file keyFile. Returns a new PageSetup object with the restored page setup, or Nothing if an error occurred.

Since: 2.12

setBottomMargin

pageSetupSetBottomMargin Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Double

margin: the new bottom margin in units of unit

-> Unit

unit: the units for margin

-> m () 

Sets the bottom margin of the PageSetup.

Since: 2.10

setLeftMargin

pageSetupSetLeftMargin Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Double

margin: the new left margin in units of unit

-> Unit

unit: the units for margin

-> m () 

Sets the left margin of the PageSetup.

Since: 2.10

setOrientation

pageSetupSetOrientation Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> PageOrientation

orientation: a PageOrientation value

-> m () 

Sets the page orientation of the PageSetup.

Since: 2.10

setPaperSize

pageSetupSetPaperSize Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> PaperSize

size: a PaperSize

-> m () 

Sets the paper size of the PageSetup without changing the margins. See pageSetupSetPaperSizeAndDefaultMargins.

Since: 2.10

setPaperSizeAndDefaultMargins

pageSetupSetPaperSizeAndDefaultMargins Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> PaperSize

size: a PaperSize

-> m () 

Sets the paper size of the PageSetup and modifies the margins according to the new paper size.

Since: 2.10

setRightMargin

pageSetupSetRightMargin Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Double

margin: the new right margin in units of unit

-> Unit

unit: the units for margin

-> m () 

Sets the right margin of the PageSetup.

Since: 2.10

setTopMargin

pageSetupSetTopMargin Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> Double

margin: the new top margin in units of unit

-> Unit

unit: the units for margin

-> m () 

Sets the top margin of the PageSetup.

Since: 2.10

toFile

pageSetupToFile Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> [Char]

fileName: the file to save to

-> m ()

(Can throw GError)

This function saves the information from setup to fileName.

Since: 2.12

toGvariant

pageSetupToGvariant Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> m GVariant

Returns: a new, floating, GVariant

Serialize page setup to an a{sv} variant.

Since: 3.22

toKeyFile

pageSetupToKeyFile Source #

Arguments

:: (HasCallStack, MonadIO m, IsPageSetup a) 
=> a

setup: a PageSetup

-> KeyFile

keyFile: the KeyFile to save the page setup to

-> Text

groupName: the group to add the settings to in keyFile, or Nothing to use the default name “Page Setup”

-> m () 

This function adds the page setup from setup to keyFile.

Since: 2.12