gtk-0.12.3: Binding to the Gtk+ graphical user interface library.

Portabilityportable (depends on GHC)
Stabilityprovisional
Maintainergtk2hs-users@lists.sourceforge.net
Safe HaskellSafe-Infered

Graphics.UI.Gtk.Printing.PageSetup

Contents

Description

Stores page setup information

  • Module available since Gtk+ version 2.10

Synopsis

Detail

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.

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.

Printing support was added in Gtk+ 2.10.

Class Hierarchy

 | GObject
 | +----PageSetup

Types

Constructors

pageSetupNewFromFileSource

Arguments

:: String

fileName - the filename to read the page setup from

-> IO PageSetup 

Reads the page setup from the file fileName. Returns a new PageSetup object with the restored page setup.

  • Available since Gtk+ version 2.12

Methods

pageSetupCopySource

Arguments

:: PageSetupClass self 
=> self 
-> IO PageSetup

returns a copy of other

Copies a PageSetup.

pageSetupGetTopMarginSource

Arguments

:: PageSetupClass self 
=> self 
-> Unit

unit - the unit for the return value

-> IO Double

returns the top margin

Gets the top margin in units of unit.

pageSetupSetTopMarginSource

Arguments

:: PageSetupClass self 
=> self 
-> Double

margin - the new top margin in units of unit

-> Unit

unit - the units for margin

-> IO () 

Sets the top margin of the PageSetup.

pageSetupGetBottomMarginSource

Arguments

:: PageSetupClass self 
=> self 
-> Unit

unit - the unit for the return value

-> IO Double

returns the bottom margin

Gets the bottom margin in units of unit.

pageSetupSetBottomMarginSource

Arguments

:: PageSetupClass self 
=> self 
-> Double

margin - the new bottom margin in units of unit

-> Unit

unit - the units for margin

-> IO () 

Sets the bottom margin of the PageSetup.

pageSetupGetLeftMarginSource

Arguments

:: PageSetupClass self 
=> self 
-> Unit

unit - the unit for the return value

-> IO Double

returns the left margin

Gets the left margin in units of unit.

pageSetupSetLeftMarginSource

Arguments

:: PageSetupClass self 
=> self 
-> Double

margin - the new left margin in units of unit

-> Unit

unit - the units for margin

-> IO () 

Sets the left margin of the PageSetup.

pageSetupGetRightMarginSource

Arguments

:: PageSetupClass self 
=> self 
-> Unit

unit - the unit for the return value

-> IO Double

returns the right margin

Gets the right margin in units of unit.

pageSetupSetRightMarginSource

Arguments

:: PageSetupClass self 
=> self 
-> Double

margin - the new right margin in units of unit

-> Unit

unit - the units for margin

-> IO () 

Sets the right margin of the PageSetup.

pageSetupSetPaperSizeAndDefaultMarginsSource

Arguments

:: PageSetupClass self 
=> self 
-> PaperSize

size - a PaperSize

-> IO () 

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

pageSetupGetPaperWidthSource

Arguments

:: PageSetupClass self 
=> self 
-> Unit

unit - the unit for the return value

-> IO 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.

pageSetupGetPaperHeightSource

Arguments

:: PageSetupClass self 
=> self 
-> Unit

unit - the unit for the return value

-> IO 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.

pageSetupGetPageWidthSource

Arguments

:: PageSetupClass self 
=> self 
-> Unit

unit - the unit for the return value

-> IO 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.

pageSetupGetPageHeightSource

Arguments

:: PageSetupClass self 
=> self 
-> Unit

unit - the unit for the return value

-> IO 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.

pageSetupLoadFileSource

Arguments

:: PageSetupClass self 
=> self 
-> String

fileName - the filename to read the page setup from

-> IO Bool

returns True on success

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

  • Available since Gtk+ version 2.14

pageSetupToFileSource

Arguments

:: PageSetupClass self 
=> self 
-> String

fileName - the file to save to

-> IO Bool

returns True on success

This function saves the information from setup to fileName.

  • Available since Gtk+ version 2.12

Attributes

pageSetupOrientation :: PageSetupClass self => Attr self PageOrientationSource

The page orientation of the PageSetup.

pageSetupPaperSize :: PageSetupClass self => Attr self PaperSizeSource

The paper size of the PageSetup.