CtkPrintSettings

CtkPrintSettings — Stores print settings

Functions

void (*CtkPrintSettingsFunc) ()
CtkPrintSettings * ctk_print_settings_new ()
CtkPrintSettings * ctk_print_settings_copy ()
gboolean ctk_print_settings_has_key ()
const gchar * ctk_print_settings_get ()
void ctk_print_settings_set ()
void ctk_print_settings_unset ()
void ctk_print_settings_foreach ()
gboolean ctk_print_settings_get_bool ()
void ctk_print_settings_set_bool ()
gdouble ctk_print_settings_get_double ()
gdouble ctk_print_settings_get_double_with_default ()
void ctk_print_settings_set_double ()
gdouble ctk_print_settings_get_length ()
void ctk_print_settings_set_length ()
gint ctk_print_settings_get_int ()
gint ctk_print_settings_get_int_with_default ()
void ctk_print_settings_set_int ()
const gchar * ctk_print_settings_get_printer ()
void ctk_print_settings_set_printer ()
CtkPageOrientation ctk_print_settings_get_orientation ()
void ctk_print_settings_set_orientation ()
CtkPaperSize * ctk_print_settings_get_paper_size ()
void ctk_print_settings_set_paper_size ()
gdouble ctk_print_settings_get_paper_width ()
void ctk_print_settings_set_paper_width ()
gdouble ctk_print_settings_get_paper_height ()
void ctk_print_settings_set_paper_height ()
gboolean ctk_print_settings_get_use_color ()
void ctk_print_settings_set_use_color ()
gboolean ctk_print_settings_get_collate ()
void ctk_print_settings_set_collate ()
gboolean ctk_print_settings_get_reverse ()
void ctk_print_settings_set_reverse ()
CtkPrintDuplex ctk_print_settings_get_duplex ()
void ctk_print_settings_set_duplex ()
CtkPrintQuality ctk_print_settings_get_quality ()
void ctk_print_settings_set_quality ()
gint ctk_print_settings_get_n_copies ()
void ctk_print_settings_set_n_copies ()
gint ctk_print_settings_get_number_up ()
void ctk_print_settings_set_number_up ()
CtkNumberUpLayout ctk_print_settings_get_number_up_layout ()
void ctk_print_settings_set_number_up_layout ()
gint ctk_print_settings_get_resolution ()
void ctk_print_settings_set_resolution ()
void ctk_print_settings_set_resolution_xy ()
gint ctk_print_settings_get_resolution_x ()
gint ctk_print_settings_get_resolution_y ()
gdouble ctk_print_settings_get_printer_lpi ()
void ctk_print_settings_set_printer_lpi ()
gdouble ctk_print_settings_get_scale ()
void ctk_print_settings_set_scale ()
CtkPrintPages ctk_print_settings_get_print_pages ()
void ctk_print_settings_set_print_pages ()
CtkPageRange * ctk_print_settings_get_page_ranges ()
void ctk_print_settings_set_page_ranges ()
CtkPageSet ctk_print_settings_get_page_set ()
void ctk_print_settings_set_page_set ()
const gchar * ctk_print_settings_get_default_source ()
void ctk_print_settings_set_default_source ()
const gchar * ctk_print_settings_get_media_type ()
void ctk_print_settings_set_media_type ()
const gchar * ctk_print_settings_get_dither ()
void ctk_print_settings_set_dither ()
const gchar * ctk_print_settings_get_finishings ()
void ctk_print_settings_set_finishings ()
const gchar * ctk_print_settings_get_output_bin ()
void ctk_print_settings_set_output_bin ()
CtkPrintSettings * ctk_print_settings_new_from_file ()
CtkPrintSettings * ctk_print_settings_new_from_key_file ()
CtkPrintSettings * ctk_print_settings_new_from_gvariant ()
gboolean ctk_print_settings_load_file ()
gboolean ctk_print_settings_load_key_file ()
gboolean ctk_print_settings_to_file ()
void ctk_print_settings_to_key_file ()
GVariant * ctk_print_settings_to_gvariant ()

Types and Values

Object Hierarchy

    GObject
    ╰── CtkPrintSettings

Includes

#include <ctk/ctk.h>

Description

A CtkPrintSettings object represents the settings of a print dialog in a system-independent way. The main use for this object is that once you’ve printed you can get a settings object that represents the settings the user chose, and the next time you print you can pass that object in so that the user doesn’t have to re-set all his settings.

Its also possible to enumerate the settings so that you can easily save the settings for the next time your app runs, or even store them in a document. The predefined keys try to use shared values as much as possible so that moving such a document between systems still works.

Printing support was added in CTK+ 2.10.

Functions

CtkPrintSettingsFunc ()

void
(*CtkPrintSettingsFunc) (const gchar *key,
                         const gchar *value,
                         gpointer user_data);

ctk_print_settings_new ()

CtkPrintSettings *
ctk_print_settings_new (void);

Creates a new CtkPrintSettings object.

Returns

a new CtkPrintSettings object

Since: 2.10


ctk_print_settings_copy ()

CtkPrintSettings *
ctk_print_settings_copy (CtkPrintSettings *other);

Copies a CtkPrintSettings object.

Parameters

other

a CtkPrintSettings

 

Returns

a newly allocated copy of other .

[transfer full]

Since: 2.10


ctk_print_settings_has_key ()

gboolean
ctk_print_settings_has_key (CtkPrintSettings *settings,
                            const gchar *key);

Returns TRUE, if a value is associated with key .

Parameters

settings

a CtkPrintSettings

 

key

a key

 

Returns

TRUE, if key has a value

Since: 2.10


ctk_print_settings_get ()

const gchar *
ctk_print_settings_get (CtkPrintSettings *settings,
                        const gchar *key);

Looks up the string value associated with key .

Parameters

settings

a CtkPrintSettings

 

key

a key

 

Returns

the string value for key

Since: 2.10


ctk_print_settings_set ()

void
ctk_print_settings_set (CtkPrintSettings *settings,
                        const gchar *key,
                        const gchar *value);

Associates value with key .

Parameters

settings

a CtkPrintSettings

 

key

a key

 

value

a string value, or NULL.

[allow-none]

Since: 2.10


ctk_print_settings_unset ()

void
ctk_print_settings_unset (CtkPrintSettings *settings,
                          const gchar *key);

Removes any value associated with key . This has the same effect as setting the value to NULL.

Parameters

settings

a CtkPrintSettings

 

key

a key

 

Since: 2.10


ctk_print_settings_foreach ()

void
ctk_print_settings_foreach (CtkPrintSettings *settings,
                            CtkPrintSettingsFunc func,
                            gpointer user_data);

Calls func for each key-value pair of settings .

Parameters

settings

a CtkPrintSettings

 

func

the function to call.

[scope call]

user_data

user data for func

 

Since: 2.10


ctk_print_settings_get_bool ()

gboolean
ctk_print_settings_get_bool (CtkPrintSettings *settings,
                             const gchar *key);

Returns the boolean represented by the value that is associated with key .

The string “true” represents TRUE, any other string FALSE.

Parameters

settings

a CtkPrintSettings

 

key

a key

 

Returns

TRUE, if key maps to a true value.

Since: 2.10


ctk_print_settings_set_bool ()

void
ctk_print_settings_set_bool (CtkPrintSettings *settings,
                             const gchar *key,
                             gboolean value);

Sets key to a boolean value.

Parameters

settings

a CtkPrintSettings

 

key

a key

 

value

a boolean

 

Since: 2.10


ctk_print_settings_get_double ()

gdouble
ctk_print_settings_get_double (CtkPrintSettings *settings,
                               const gchar *key);

Returns the double value associated with key , or 0.

Parameters

settings

a CtkPrintSettings

 

key

a key

 

Returns

the double value of key

Since: 2.10


ctk_print_settings_get_double_with_default ()

gdouble
ctk_print_settings_get_double_with_default
                               (CtkPrintSettings *settings,
                                const gchar *key,
                                gdouble def);

Returns the floating point number represented by the value that is associated with key , or default_val if the value does not represent a floating point number.

Floating point numbers are parsed with g_ascii_strtod().

Parameters

settings

a CtkPrintSettings

 

key

a key

 

def

the default value

 

Returns

the floating point number associated with key

Since: 2.10


ctk_print_settings_set_double ()

void
ctk_print_settings_set_double (CtkPrintSettings *settings,
                               const gchar *key,
                               gdouble value);

Sets key to a double value.

Parameters

settings

a CtkPrintSettings

 

key

a key

 

value

a double value

 

Since: 2.10


ctk_print_settings_get_length ()

gdouble
ctk_print_settings_get_length (CtkPrintSettings *settings,
                               const gchar *key,
                               CtkUnit unit);

Returns the value associated with key , interpreted as a length. The returned value is converted to units .

Parameters

settings

a CtkPrintSettings

 

key

a key

 

unit

the unit of the return value

 

Returns

the length value of key , converted to unit

Since: 2.10


ctk_print_settings_set_length ()

void
ctk_print_settings_set_length (CtkPrintSettings *settings,
                               const gchar *key,
                               gdouble value,
                               CtkUnit unit);

Associates a length in units of unit with key .

Parameters

settings

a CtkPrintSettings

 

key

a key

 

value

a length

 

unit

the unit of length

 

Since: 2.10


ctk_print_settings_get_int ()

gint
ctk_print_settings_get_int (CtkPrintSettings *settings,
                            const gchar *key);

Returns the integer value of key , or 0.

Parameters

settings

a CtkPrintSettings

 

key

a key

 

Returns

the integer value of key

Since: 2.10


ctk_print_settings_get_int_with_default ()

gint
ctk_print_settings_get_int_with_default
                               (CtkPrintSettings *settings,
                                const gchar *key,
                                gint def);

Returns the value of key , interpreted as an integer, or the default value.

Parameters

settings

a CtkPrintSettings

 

key

a key

 

def

the default value

 

Returns

the integer value of key

Since: 2.10


ctk_print_settings_set_int ()

void
ctk_print_settings_set_int (CtkPrintSettings *settings,
                            const gchar *key,
                            gint value);

Sets key to an integer value.

Parameters

settings

a CtkPrintSettings

 

key

a key

 

value

an integer

 

Since: 2.10


ctk_print_settings_get_printer ()

const gchar *
ctk_print_settings_get_printer (CtkPrintSettings *settings);

Convenience function to obtain the value of CTK_PRINT_SETTINGS_PRINTER.

Parameters

settings

a CtkPrintSettings

 

Returns

the printer name

Since: 2.10


ctk_print_settings_set_printer ()

void
ctk_print_settings_set_printer (CtkPrintSettings *settings,
                                const gchar *printer);

Convenience function to set CTK_PRINT_SETTINGS_PRINTER to printer .

Parameters

settings

a CtkPrintSettings

 

printer

the printer name

 

Since: 2.10


ctk_print_settings_get_orientation ()

CtkPageOrientation
ctk_print_settings_get_orientation (CtkPrintSettings *settings);

Get the value of CTK_PRINT_SETTINGS_ORIENTATION, converted to a CtkPageOrientation.

Parameters

settings

a CtkPrintSettings

 

Returns

the orientation

Since: 2.10


ctk_print_settings_set_orientation ()

void
ctk_print_settings_set_orientation (CtkPrintSettings *settings,
                                    CtkPageOrientation orientation);

Sets the value of CTK_PRINT_SETTINGS_ORIENTATION.

Parameters

settings

a CtkPrintSettings

 

orientation

a page orientation

 

Since: 2.10


ctk_print_settings_get_paper_size ()

CtkPaperSize *
ctk_print_settings_get_paper_size (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_PAPER_FORMAT, converted to a CtkPaperSize.

Parameters

settings

a CtkPrintSettings

 

Returns

the paper size

Since: 2.10


ctk_print_settings_set_paper_size ()

void
ctk_print_settings_set_paper_size (CtkPrintSettings *settings,
                                   CtkPaperSize *paper_size);

Sets the value of CTK_PRINT_SETTINGS_PAPER_FORMAT, CTK_PRINT_SETTINGS_PAPER_WIDTH and CTK_PRINT_SETTINGS_PAPER_HEIGHT.

Parameters

settings

a CtkPrintSettings

 

paper_size

a paper size

 

Since: 2.10


ctk_print_settings_get_paper_width ()

gdouble
ctk_print_settings_get_paper_width (CtkPrintSettings *settings,
                                    CtkUnit unit);

Gets the value of CTK_PRINT_SETTINGS_PAPER_WIDTH, converted to unit .

Parameters

settings

a CtkPrintSettings

 

unit

the unit for the return value

 

Returns

the paper width, in units of unit

Since: 2.10


ctk_print_settings_set_paper_width ()

void
ctk_print_settings_set_paper_width (CtkPrintSettings *settings,
                                    gdouble width,
                                    CtkUnit unit);

Sets the value of CTK_PRINT_SETTINGS_PAPER_WIDTH.

Parameters

settings

a CtkPrintSettings

 

width

the paper width

 

unit

the units of width

 

Since: 2.10


ctk_print_settings_get_paper_height ()

gdouble
ctk_print_settings_get_paper_height (CtkPrintSettings *settings,
                                     CtkUnit unit);

Gets the value of CTK_PRINT_SETTINGS_PAPER_HEIGHT, converted to unit .

Parameters

settings

a CtkPrintSettings

 

unit

the unit for the return value

 

Returns

the paper height, in units of unit

Since: 2.10


ctk_print_settings_set_paper_height ()

void
ctk_print_settings_set_paper_height (CtkPrintSettings *settings,
                                     gdouble height,
                                     CtkUnit unit);

Sets the value of CTK_PRINT_SETTINGS_PAPER_HEIGHT.

Parameters

settings

a CtkPrintSettings

 

height

the paper height

 

unit

the units of height

 

Since: 2.10


ctk_print_settings_get_use_color ()

gboolean
ctk_print_settings_get_use_color (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_USE_COLOR.

Parameters

settings

a CtkPrintSettings

 

Returns

whether to use color

Since: 2.10


ctk_print_settings_set_use_color ()

void
ctk_print_settings_set_use_color (CtkPrintSettings *settings,
                                  gboolean use_color);

Sets the value of CTK_PRINT_SETTINGS_USE_COLOR.

Parameters

settings

a CtkPrintSettings

 

use_color

whether to use color

 

Since: 2.10


ctk_print_settings_get_collate ()

gboolean
ctk_print_settings_get_collate (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_COLLATE.

Parameters

settings

a CtkPrintSettings

 

Returns

whether to collate the printed pages

Since: 2.10


ctk_print_settings_set_collate ()

void
ctk_print_settings_set_collate (CtkPrintSettings *settings,
                                gboolean collate);

Sets the value of CTK_PRINT_SETTINGS_COLLATE.

Parameters

settings

a CtkPrintSettings

 

collate

whether to collate the output

 

Since: 2.10


ctk_print_settings_get_reverse ()

gboolean
ctk_print_settings_get_reverse (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_REVERSE.

Parameters

settings

a CtkPrintSettings

 

Returns

whether to reverse the order of the printed pages

Since: 2.10


ctk_print_settings_set_reverse ()

void
ctk_print_settings_set_reverse (CtkPrintSettings *settings,
                                gboolean reverse);

Sets the value of CTK_PRINT_SETTINGS_REVERSE.

Parameters

settings

a CtkPrintSettings

 

reverse

whether to reverse the output

 

Since: 2.10


ctk_print_settings_get_duplex ()

CtkPrintDuplex
ctk_print_settings_get_duplex (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_DUPLEX.

Parameters

settings

a CtkPrintSettings

 

Returns

whether to print the output in duplex.

Since: 2.10


ctk_print_settings_set_duplex ()

void
ctk_print_settings_set_duplex (CtkPrintSettings *settings,
                               CtkPrintDuplex duplex);

Sets the value of CTK_PRINT_SETTINGS_DUPLEX.

Parameters

settings

a CtkPrintSettings

 

duplex

a CtkPrintDuplex value

 

Since: 2.10


ctk_print_settings_get_quality ()

CtkPrintQuality
ctk_print_settings_get_quality (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_QUALITY.

Parameters

settings

a CtkPrintSettings

 

Returns

the print quality

Since: 2.10


ctk_print_settings_set_quality ()

void
ctk_print_settings_set_quality (CtkPrintSettings *settings,
                                CtkPrintQuality quality);

Sets the value of CTK_PRINT_SETTINGS_QUALITY.

Parameters

settings

a CtkPrintSettings

 

quality

a CtkPrintQuality value

 

Since: 2.10


ctk_print_settings_get_n_copies ()

gint
ctk_print_settings_get_n_copies (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_N_COPIES.

Parameters

settings

a CtkPrintSettings

 

Returns

the number of copies to print

Since: 2.10


ctk_print_settings_set_n_copies ()

void
ctk_print_settings_set_n_copies (CtkPrintSettings *settings,
                                 gint num_copies);

Sets the value of CTK_PRINT_SETTINGS_N_COPIES.

Parameters

settings

a CtkPrintSettings

 

num_copies

the number of copies

 

Since: 2.10


ctk_print_settings_get_number_up ()

gint
ctk_print_settings_get_number_up (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_NUMBER_UP.

Parameters

settings

a CtkPrintSettings

 

Returns

the number of pages per sheet

Since: 2.10


ctk_print_settings_set_number_up ()

void
ctk_print_settings_set_number_up (CtkPrintSettings *settings,
                                  gint number_up);

Sets the value of CTK_PRINT_SETTINGS_NUMBER_UP.

Parameters

settings

a CtkPrintSettings

 

number_up

the number of pages per sheet

 

Since: 2.10


ctk_print_settings_get_number_up_layout ()

CtkNumberUpLayout
ctk_print_settings_get_number_up_layout
                               (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT.

Parameters

settings

a CtkPrintSettings

 

Returns

layout of page in number-up mode

Since: 2.14


ctk_print_settings_set_number_up_layout ()

void
ctk_print_settings_set_number_up_layout
                               (CtkPrintSettings *settings,
                                CtkNumberUpLayout number_up_layout);

Sets the value of CTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT.

Parameters

settings

a CtkPrintSettings

 

number_up_layout

a CtkNumberUpLayout value

 

Since: 2.14


ctk_print_settings_get_resolution ()

gint
ctk_print_settings_get_resolution (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_RESOLUTION.

Parameters

settings

a CtkPrintSettings

 

Returns

the resolution in dpi

Since: 2.10


ctk_print_settings_set_resolution ()

void
ctk_print_settings_set_resolution (CtkPrintSettings *settings,
                                   gint resolution);

Sets the values of CTK_PRINT_SETTINGS_RESOLUTION, CTK_PRINT_SETTINGS_RESOLUTION_X and CTK_PRINT_SETTINGS_RESOLUTION_Y.

Parameters

settings

a CtkPrintSettings

 

resolution

the resolution in dpi

 

Since: 2.10


ctk_print_settings_set_resolution_xy ()

void
ctk_print_settings_set_resolution_xy (CtkPrintSettings *settings,
                                      gint resolution_x,
                                      gint resolution_y);

Sets the values of CTK_PRINT_SETTINGS_RESOLUTION, CTK_PRINT_SETTINGS_RESOLUTION_X and CTK_PRINT_SETTINGS_RESOLUTION_Y.

Parameters

settings

a CtkPrintSettings

 

resolution_x

the horizontal resolution in dpi

 

resolution_y

the vertical resolution in dpi

 

Since: 2.16


ctk_print_settings_get_resolution_x ()

gint
ctk_print_settings_get_resolution_x (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_RESOLUTION_X.

Parameters

settings

a CtkPrintSettings

 

Returns

the horizontal resolution in dpi

Since: 2.16


ctk_print_settings_get_resolution_y ()

gint
ctk_print_settings_get_resolution_y (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_RESOLUTION_Y.

Parameters

settings

a CtkPrintSettings

 

Returns

the vertical resolution in dpi

Since: 2.16


ctk_print_settings_get_printer_lpi ()

gdouble
ctk_print_settings_get_printer_lpi (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_PRINTER_LPI.

Parameters

settings

a CtkPrintSettings

 

Returns

the resolution in lpi (lines per inch)

Since: 2.16


ctk_print_settings_set_printer_lpi ()

void
ctk_print_settings_set_printer_lpi (CtkPrintSettings *settings,
                                    gdouble lpi);

Sets the value of CTK_PRINT_SETTINGS_PRINTER_LPI.

Parameters

settings

a CtkPrintSettings

 

lpi

the resolution in lpi (lines per inch)

 

Since: 2.16


ctk_print_settings_get_scale ()

gdouble
ctk_print_settings_get_scale (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_SCALE.

Parameters

settings

a CtkPrintSettings

 

Returns

the scale in percent

Since: 2.10


ctk_print_settings_set_scale ()

void
ctk_print_settings_set_scale (CtkPrintSettings *settings,
                              gdouble scale);

Sets the value of CTK_PRINT_SETTINGS_SCALE.

Parameters

settings

a CtkPrintSettings

 

scale

the scale in percent

 

Since: 2.10


ctk_print_settings_get_print_pages ()

CtkPrintPages
ctk_print_settings_get_print_pages (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_PRINT_PAGES.

Parameters

settings

a CtkPrintSettings

 

Returns

which pages to print

Since: 2.10


ctk_print_settings_set_print_pages ()

void
ctk_print_settings_set_print_pages (CtkPrintSettings *settings,
                                    CtkPrintPages pages);

Sets the value of CTK_PRINT_SETTINGS_PRINT_PAGES.

Parameters

settings

a CtkPrintSettings

 

pages

a CtkPrintPages value

 

Since: 2.10


ctk_print_settings_get_page_ranges ()

CtkPageRange *
ctk_print_settings_get_page_ranges (CtkPrintSettings *settings,
                                    gint *num_ranges);

Gets the value of CTK_PRINT_SETTINGS_PAGE_RANGES.

Parameters

settings

a CtkPrintSettings

 

num_ranges

return location for the length of the returned array.

[out]

Returns

an array of CtkPageRanges. Use g_free() to free the array when it is no longer needed.

[array length=num_ranges][transfer full]

Since: 2.10


ctk_print_settings_set_page_ranges ()

void
ctk_print_settings_set_page_ranges (CtkPrintSettings *settings,
                                    CtkPageRange *page_ranges,
                                    gint num_ranges);

Sets the value of CTK_PRINT_SETTINGS_PAGE_RANGES.

Parameters

settings

a CtkPrintSettings

 

page_ranges

an array of CtkPageRanges.

[array length=num_ranges]

num_ranges

the length of page_ranges

 

Since: 2.10


ctk_print_settings_get_page_set ()

CtkPageSet
ctk_print_settings_get_page_set (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_PAGE_SET.

Parameters

settings

a CtkPrintSettings

 

Returns

the set of pages to print

Since: 2.10


ctk_print_settings_set_page_set ()

void
ctk_print_settings_set_page_set (CtkPrintSettings *settings,
                                 CtkPageSet page_set);

Sets the value of CTK_PRINT_SETTINGS_PAGE_SET.

Parameters

settings

a CtkPrintSettings

 

page_set

a CtkPageSet value

 

Since: 2.10


ctk_print_settings_get_default_source ()

const gchar *
ctk_print_settings_get_default_source (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_DEFAULT_SOURCE.

Parameters

settings

a CtkPrintSettings

 

Returns

the default source

Since: 2.10


ctk_print_settings_set_default_source ()

void
ctk_print_settings_set_default_source (CtkPrintSettings *settings,
                                       const gchar *default_source);

Sets the value of CTK_PRINT_SETTINGS_DEFAULT_SOURCE.

Parameters

settings

a CtkPrintSettings

 

default_source

the default source

 

Since: 2.10


ctk_print_settings_get_media_type ()

const gchar *
ctk_print_settings_get_media_type (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_MEDIA_TYPE.

The set of media types is defined in PWG 5101.1-2002 PWG.

Parameters

settings

a CtkPrintSettings

 

Returns

the media type

Since: 2.10


ctk_print_settings_set_media_type ()

void
ctk_print_settings_set_media_type (CtkPrintSettings *settings,
                                   const gchar *media_type);

Sets the value of CTK_PRINT_SETTINGS_MEDIA_TYPE.

The set of media types is defined in PWG 5101.1-2002 PWG.

Parameters

settings

a CtkPrintSettings

 

media_type

the media type

 

Since: 2.10


ctk_print_settings_get_dither ()

const gchar *
ctk_print_settings_get_dither (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_DITHER.

Parameters

settings

a CtkPrintSettings

 

Returns

the dithering that is used

Since: 2.10


ctk_print_settings_set_dither ()

void
ctk_print_settings_set_dither (CtkPrintSettings *settings,
                               const gchar *dither);

Sets the value of CTK_PRINT_SETTINGS_DITHER.

Parameters

settings

a CtkPrintSettings

 

dither

the dithering that is used

 

Since: 2.10


ctk_print_settings_get_finishings ()

const gchar *
ctk_print_settings_get_finishings (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_FINISHINGS.

Parameters

settings

a CtkPrintSettings

 

Returns

the finishings

Since: 2.10


ctk_print_settings_set_finishings ()

void
ctk_print_settings_set_finishings (CtkPrintSettings *settings,
                                   const gchar *finishings);

Sets the value of CTK_PRINT_SETTINGS_FINISHINGS.

Parameters

settings

a CtkPrintSettings

 

finishings

the finishings

 

Since: 2.10


ctk_print_settings_get_output_bin ()

const gchar *
ctk_print_settings_get_output_bin (CtkPrintSettings *settings);

Gets the value of CTK_PRINT_SETTINGS_OUTPUT_BIN.

Parameters

settings

a CtkPrintSettings

 

Returns

the output bin

Since: 2.10


ctk_print_settings_set_output_bin ()

void
ctk_print_settings_set_output_bin (CtkPrintSettings *settings,
                                   const gchar *output_bin);

Sets the value of CTK_PRINT_SETTINGS_OUTPUT_BIN.

Parameters

settings

a CtkPrintSettings

 

output_bin

the output bin

 

Since: 2.10


ctk_print_settings_new_from_file ()

CtkPrintSettings *
ctk_print_settings_new_from_file (const gchar *file_name,
                                  GError **error);

Reads the print settings from file_name . Returns a new CtkPrintSettings object with the restored settings, or NULL if an error occurred. If the file could not be loaded then error is set to either a GFileError or GKeyFileError. See ctk_print_settings_to_file().

Parameters

file_name

the filename to read the settings from.

[type filename]

error

return location for errors, or NULL.

[allow-none]

Returns

the restored CtkPrintSettings

Since: 2.12


ctk_print_settings_new_from_key_file ()

CtkPrintSettings *
ctk_print_settings_new_from_key_file (GKeyFile *key_file,
                                      const gchar *group_name,
                                      GError **error);

Reads the print settings from the group group_name in key_file . Returns a new CtkPrintSettings object with the restored settings, or NULL if an error occurred. If the file could not be loaded then error is set to either a GFileError or GKeyFileError.

Parameters

key_file

the GKeyFile to retrieve the settings from

 

group_name

the name of the group to use, or NULL to use the default “Print Settings”.

[allow-none]

error

return location for errors, or NULL.

[allow-none]

Returns

the restored CtkPrintSettings

Since: 2.12


ctk_print_settings_new_from_gvariant ()

CtkPrintSettings *
ctk_print_settings_new_from_gvariant (GVariant *variant);

Deserialize print settings from an a{sv} variant in the format produced by ctk_print_settings_to_gvariant().

Parameters

variant

an a{sv} GVariant

 

Returns

a new CtkPrintSettings object.

[transfer full]

Since: 3.22


ctk_print_settings_load_file ()

gboolean
ctk_print_settings_load_file (CtkPrintSettings *settings,
                              const gchar *file_name,
                              GError **error);

Reads the print settings from file_name . If the file could not be loaded then error is set to either a GFileError or GKeyFileError. See ctk_print_settings_to_file().

Parameters

settings

a CtkPrintSettings

 

file_name

the filename to read the settings from.

[type filename]

error

return location for errors, or NULL.

[allow-none]

Returns

TRUE on success

Since: 2.14


ctk_print_settings_load_key_file ()

gboolean
ctk_print_settings_load_key_file (CtkPrintSettings *settings,
                                  GKeyFile *key_file,
                                  const gchar *group_name,
                                  GError **error);

Reads the print settings from the group group_name in key_file . If the file could not be loaded then error is set to either a GFileError or GKeyFileError.

Parameters

settings

a CtkPrintSettings

 

key_file

the GKeyFile to retrieve the settings from

 

group_name

the name of the group to use, or NULL to use the default “Print Settings”.

[allow-none]

error

return location for errors, or NULL.

[allow-none]

Returns

TRUE on success

Since: 2.14


ctk_print_settings_to_file ()

gboolean
ctk_print_settings_to_file (CtkPrintSettings *settings,
                            const gchar *file_name,
                            GError **error);

This function saves the print settings from settings to file_name . If the file could not be loaded then error is set to either a GFileError or GKeyFileError.

Parameters

settings

a CtkPrintSettings

 

file_name

the file to save to.

[type filename]

error

return location for errors, or NULL.

[allow-none]

Returns

TRUE on success

Since: 2.12


ctk_print_settings_to_key_file ()

void
ctk_print_settings_to_key_file (CtkPrintSettings *settings,
                                GKeyFile *key_file,
                                const gchar *group_name);

This function adds the print settings from settings to key_file .

Parameters

settings

a CtkPrintSettings

 

key_file

the GKeyFile to save the print settings to

 

group_name

the group to add the settings to in key_file , or NULL to use the default “Print Settings”.

[nullable]

Since: 2.12


ctk_print_settings_to_gvariant ()

GVariant *
ctk_print_settings_to_gvariant (CtkPrintSettings *settings);

Serialize print settings to an a{sv} variant.

Parameters

settings

a CtkPrintSettings

 

Returns

a new, floating, GVariant.

[transfer none]

Since: 3.22

Types and Values

CtkPrintSettings

typedef struct _CtkPrintSettings CtkPrintSettings;

CTK_PRINT_SETTINGS_PRINTER

#define CTK_PRINT_SETTINGS_PRINTER          "printer"

enum CtkPageOrientation

See also ctk_print_settings_set_orientation().

Members

CTK_PAGE_ORIENTATION_PORTRAIT

Portrait mode.

 

CTK_PAGE_ORIENTATION_LANDSCAPE

Landscape mode.

 

CTK_PAGE_ORIENTATION_REVERSE_PORTRAIT

Reverse portrait mode.

 

CTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE

Reverse landscape mode.

 

CTK_PRINT_SETTINGS_ORIENTATION

#define CTK_PRINT_SETTINGS_ORIENTATION      "orientation"

CTK_PRINT_SETTINGS_PAPER_FORMAT

#define CTK_PRINT_SETTINGS_PAPER_FORMAT     "paper-format"

CTK_PRINT_SETTINGS_PAPER_WIDTH

#define CTK_PRINT_SETTINGS_PAPER_WIDTH      "paper-width"

CTK_PRINT_SETTINGS_PAPER_HEIGHT

#define CTK_PRINT_SETTINGS_PAPER_HEIGHT     "paper-height"

CTK_PRINT_SETTINGS_USE_COLOR

#define CTK_PRINT_SETTINGS_USE_COLOR        "use-color"

CTK_PRINT_SETTINGS_COLLATE

#define CTK_PRINT_SETTINGS_COLLATE          "collate"

CTK_PRINT_SETTINGS_REVERSE

#define CTK_PRINT_SETTINGS_REVERSE          "reverse"

enum CtkPrintDuplex

See also ctk_print_settings_set_duplex().

Members

CTK_PRINT_DUPLEX_SIMPLEX

No duplex.

 

CTK_PRINT_DUPLEX_HORIZONTAL

Horizontal duplex.

 

CTK_PRINT_DUPLEX_VERTICAL

Vertical duplex.

 

CTK_PRINT_SETTINGS_DUPLEX

#define CTK_PRINT_SETTINGS_DUPLEX           "duplex"

enum CtkPrintQuality

See also ctk_print_settings_set_quality().

Members

CTK_PRINT_QUALITY_LOW

Low quality.

 

CTK_PRINT_QUALITY_NORMAL

Normal quality.

 

CTK_PRINT_QUALITY_HIGH

High quality.

 

CTK_PRINT_QUALITY_DRAFT

Draft quality.

 

CTK_PRINT_SETTINGS_QUALITY

#define CTK_PRINT_SETTINGS_QUALITY          "quality"

CTK_PRINT_SETTINGS_N_COPIES

#define CTK_PRINT_SETTINGS_N_COPIES         "n-copies"

CTK_PRINT_SETTINGS_NUMBER_UP

#define CTK_PRINT_SETTINGS_NUMBER_UP        "number-up"

enum CtkNumberUpLayout

Used to determine the layout of pages on a sheet when printing multiple pages per sheet.

Members

CTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM

 

CTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_BOTTOM_TO_TOP

 

CTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_TOP_TO_BOTTOM

 

CTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_BOTTOM_TO_TOP

 

CTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_LEFT_TO_RIGHT

 

CTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_RIGHT_TO_LEFT

 

CTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_LEFT_TO_RIGHT

 

CTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_RIGHT_TO_LEFT

 

CTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT

#define CTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT "number-up-layout"

CTK_PRINT_SETTINGS_RESOLUTION

#define CTK_PRINT_SETTINGS_RESOLUTION       "resolution"

CTK_PRINT_SETTINGS_RESOLUTION_X

#define CTK_PRINT_SETTINGS_RESOLUTION_X     "resolution-x"

CTK_PRINT_SETTINGS_RESOLUTION_Y

#define CTK_PRINT_SETTINGS_RESOLUTION_Y     "resolution-y"

CTK_PRINT_SETTINGS_PRINTER_LPI

#define CTK_PRINT_SETTINGS_PRINTER_LPI      "printer-lpi"

CTK_PRINT_SETTINGS_SCALE

#define CTK_PRINT_SETTINGS_SCALE            "scale"

enum CtkPrintPages

See also ctk_print_job_set_pages()

Members

CTK_PRINT_PAGES_ALL

All pages.

 

CTK_PRINT_PAGES_CURRENT

Current page.

 

CTK_PRINT_PAGES_RANGES

Range of pages.

 

CTK_PRINT_PAGES_SELECTION

Selected pages.

 

CTK_PRINT_SETTINGS_PRINT_PAGES

#define CTK_PRINT_SETTINGS_PRINT_PAGES      "print-pages"

struct CtkPageRange

struct CtkPageRange {
  gint start;
  gint end;
};

See also ctk_print_settings_set_page_ranges().

Members

gint start;

start of page range.

 

gint end;

end of page range.

 

CTK_PRINT_SETTINGS_PAGE_RANGES

#define CTK_PRINT_SETTINGS_PAGE_RANGES      "page-ranges"

enum CtkPageSet

See also ctk_print_job_set_page_set().

Members

CTK_PAGE_SET_ALL

All pages.

 

CTK_PAGE_SET_EVEN

Even pages.

 

CTK_PAGE_SET_ODD

Odd pages.

 

CTK_PRINT_SETTINGS_PAGE_SET

#define CTK_PRINT_SETTINGS_PAGE_SET         "page-set"

CTK_PRINT_SETTINGS_DEFAULT_SOURCE

#define CTK_PRINT_SETTINGS_DEFAULT_SOURCE   "default-source"

CTK_PRINT_SETTINGS_MEDIA_TYPE

#define CTK_PRINT_SETTINGS_MEDIA_TYPE       "media-type"

CTK_PRINT_SETTINGS_DITHER

#define CTK_PRINT_SETTINGS_DITHER           "dither"

CTK_PRINT_SETTINGS_FINISHINGS

#define CTK_PRINT_SETTINGS_FINISHINGS       "finishings"

CTK_PRINT_SETTINGS_OUTPUT_BIN

#define CTK_PRINT_SETTINGS_OUTPUT_BIN       "output-bin"

CTK_PRINT_SETTINGS_OUTPUT_DIR

#define CTK_PRINT_SETTINGS_OUTPUT_DIR       "output-dir"

The key used by the “Print to file” printer to store the directory to which the output should be written.

Since: 3.6


CTK_PRINT_SETTINGS_OUTPUT_BASENAME

#define CTK_PRINT_SETTINGS_OUTPUT_BASENAME  "output-basename"

The key used by the “Print to file” printer to store the file name of the output without the path to the directory and the file extension.

Since: 3.6


CTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT

#define CTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT  "output-file-format"

The key used by the “Print to file” printer to store the format of the output. The supported values are “PS” and “PDF”.


CTK_PRINT_SETTINGS_OUTPUT_URI

#define CTK_PRINT_SETTINGS_OUTPUT_URI          "output-uri"

The key used by the “Print to file” printer to store the URI to which the output should be written. CTK+ itself supports only “file://” URIs.


CTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA

#define CTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA   "win32-driver-extra"

CTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION

#define CTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION "win32-driver-version"