W3cubDocs

/GTK 4.0

GtkPrintSettings

GtkPrintSettings — Stores print settings

Functions

void (*GtkPrintSettingsFunc) ()
GtkPrintSettings * gtk_print_settings_new ()
GtkPrintSettings * gtk_print_settings_copy ()
gboolean gtk_print_settings_has_key ()
const char * gtk_print_settings_get ()
void gtk_print_settings_set ()
void gtk_print_settings_unset ()
void gtk_print_settings_foreach ()
gboolean gtk_print_settings_get_bool ()
void gtk_print_settings_set_bool ()
double gtk_print_settings_get_double ()
double gtk_print_settings_get_double_with_default ()
void gtk_print_settings_set_double ()
double gtk_print_settings_get_length ()
void gtk_print_settings_set_length ()
int gtk_print_settings_get_int ()
int gtk_print_settings_get_int_with_default ()
void gtk_print_settings_set_int ()
const char * gtk_print_settings_get_printer ()
void gtk_print_settings_set_printer ()
GtkPageOrientation gtk_print_settings_get_orientation ()
void gtk_print_settings_set_orientation ()
GtkPaperSize * gtk_print_settings_get_paper_size ()
void gtk_print_settings_set_paper_size ()
double gtk_print_settings_get_paper_width ()
void gtk_print_settings_set_paper_width ()
double gtk_print_settings_get_paper_height ()
void gtk_print_settings_set_paper_height ()
gboolean gtk_print_settings_get_use_color ()
void gtk_print_settings_set_use_color ()
gboolean gtk_print_settings_get_collate ()
void gtk_print_settings_set_collate ()
gboolean gtk_print_settings_get_reverse ()
void gtk_print_settings_set_reverse ()
GtkPrintDuplex gtk_print_settings_get_duplex ()
void gtk_print_settings_set_duplex ()
GtkPrintQuality gtk_print_settings_get_quality ()
void gtk_print_settings_set_quality ()
int gtk_print_settings_get_n_copies ()
void gtk_print_settings_set_n_copies ()
int gtk_print_settings_get_number_up ()
void gtk_print_settings_set_number_up ()
GtkNumberUpLayout gtk_print_settings_get_number_up_layout ()
void gtk_print_settings_set_number_up_layout ()
int gtk_print_settings_get_resolution ()
void gtk_print_settings_set_resolution ()
void gtk_print_settings_set_resolution_xy ()
int gtk_print_settings_get_resolution_x ()
int gtk_print_settings_get_resolution_y ()
double gtk_print_settings_get_printer_lpi ()
void gtk_print_settings_set_printer_lpi ()
double gtk_print_settings_get_scale ()
void gtk_print_settings_set_scale ()
GtkPrintPages gtk_print_settings_get_print_pages ()
void gtk_print_settings_set_print_pages ()
GtkPageRange * gtk_print_settings_get_page_ranges ()
void gtk_print_settings_set_page_ranges ()
GtkPageSet gtk_print_settings_get_page_set ()
void gtk_print_settings_set_page_set ()
const char * gtk_print_settings_get_default_source ()
void gtk_print_settings_set_default_source ()
const char * gtk_print_settings_get_media_type ()
void gtk_print_settings_set_media_type ()
const char * gtk_print_settings_get_dither ()
void gtk_print_settings_set_dither ()
const char * gtk_print_settings_get_finishings ()
void gtk_print_settings_set_finishings ()
const char * gtk_print_settings_get_output_bin ()
void gtk_print_settings_set_output_bin ()
GtkPrintSettings * gtk_print_settings_new_from_file ()
GtkPrintSettings * gtk_print_settings_new_from_key_file ()
GtkPrintSettings * gtk_print_settings_new_from_gvariant ()
gboolean gtk_print_settings_load_file ()
gboolean gtk_print_settings_load_key_file ()
gboolean gtk_print_settings_to_file ()
void gtk_print_settings_to_key_file ()
GVariant * gtk_print_settings_to_gvariant ()

Object Hierarchy

    GObject
    ╰── GtkPrintSettings

Includes

#include <gtk/gtk.h>

Description

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

Functions

GtkPrintSettingsFunc ()

void
(*GtkPrintSettingsFunc) (const char *key,
                         const char *value,
                         gpointer user_data);

gtk_print_settings_new ()

GtkPrintSettings *
gtk_print_settings_new (void);

Creates a new GtkPrintSettings object.

Returns

a new GtkPrintSettings object

gtk_print_settings_copy ()

GtkPrintSettings *
gtk_print_settings_copy (GtkPrintSettings *other);

Copies a GtkPrintSettings object.

Parameters

Returns

a newly allocated copy of other .

[transfer full]

gtk_print_settings_has_key ()

gboolean
gtk_print_settings_has_key (GtkPrintSettings *settings,
                            const char *key);

Returns TRUE, if a value is associated with key .

Parameters

settings

a GtkPrintSettings

key

a key

Returns

TRUE, if key has a value

gtk_print_settings_get ()

const char *
gtk_print_settings_get (GtkPrintSettings *settings,
                        const char *key);

Looks up the string value associated with key .

Parameters

settings

a GtkPrintSettings

key

a key

Returns

the string value for key

gtk_print_settings_set ()

void
gtk_print_settings_set (GtkPrintSettings *settings,
                        const char *key,
                        const char *value);

Associates value with key .

Parameters

settings

a GtkPrintSettings

key

a key

value

a string value, or NULL.

[allow-none]

gtk_print_settings_unset ()

void
gtk_print_settings_unset (GtkPrintSettings *settings,
                          const char *key);

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

Parameters

settings

a GtkPrintSettings

key

a key

gtk_print_settings_foreach ()

void
gtk_print_settings_foreach (GtkPrintSettings *settings,
                            GtkPrintSettingsFunc func,
                            gpointer user_data);

Calls func for each key-value pair of settings .

Parameters

settings

a GtkPrintSettings

func

the function to call.

[scope call]

user_data

user data for func .

[closure]

gtk_print_settings_get_bool ()

gboolean
gtk_print_settings_get_bool (GtkPrintSettings *settings,
                             const char *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 GtkPrintSettings

key

a key

Returns

TRUE, if key maps to a true value.

gtk_print_settings_set_bool ()

void
gtk_print_settings_set_bool (GtkPrintSettings *settings,
                             const char *key,
                             gboolean value);

Sets key to a boolean value.

Parameters

settings

a GtkPrintSettings

key

a key

value

a boolean

gtk_print_settings_get_double ()

double
gtk_print_settings_get_double (GtkPrintSettings *settings,
                               const char *key);

Returns the double value associated with key , or 0.

Parameters

settings

a GtkPrintSettings

key

a key

Returns

the double value of key

gtk_print_settings_get_double_with_default ()

double
gtk_print_settings_get_double_with_default
                               (GtkPrintSettings *settings,
                                const char *key,
                                double 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 GtkPrintSettings

key

a key

def

the default value

Returns

the floating point number associated with key

gtk_print_settings_set_double ()

void
gtk_print_settings_set_double (GtkPrintSettings *settings,
                               const char *key,
                               double value);

Sets key to a double value.

Parameters

settings

a GtkPrintSettings

key

a key

value

a double value

gtk_print_settings_get_length ()

double
gtk_print_settings_get_length (GtkPrintSettings *settings,
                               const char *key,
                               GtkUnit unit);

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

Parameters

settings

a GtkPrintSettings

key

a key

unit

the unit of the return value

Returns

the length value of key , converted to unit

gtk_print_settings_set_length ()

void
gtk_print_settings_set_length (GtkPrintSettings *settings,
                               const char *key,
                               double value,
                               GtkUnit unit);

Associates a length in units of unit with key .

Parameters

settings

a GtkPrintSettings

key

a key

value

a length

unit

the unit of length

gtk_print_settings_get_int ()

int
gtk_print_settings_get_int (GtkPrintSettings *settings,
                            const char *key);

Returns the integer value of key , or 0.

Parameters

settings

a GtkPrintSettings

key

a key

Returns

the integer value of key

gtk_print_settings_get_int_with_default ()

int
gtk_print_settings_get_int_with_default
                               (GtkPrintSettings *settings,
                                const char *key,
                                int def);

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

Parameters

settings

a GtkPrintSettings

key

a key

def

the default value

Returns

the integer value of key

gtk_print_settings_set_int ()

void
gtk_print_settings_set_int (GtkPrintSettings *settings,
                            const char *key,
                            int value);

Sets key to an integer value.

Parameters

settings

a GtkPrintSettings

key

a key

value

an integer

gtk_print_settings_get_printer ()

const char *
gtk_print_settings_get_printer (GtkPrintSettings *settings);

Convenience function to obtain the value of GTK_PRINT_SETTINGS_PRINTER.

Parameters

settings

a GtkPrintSettings

Returns

the printer name

gtk_print_settings_set_printer ()

void
gtk_print_settings_set_printer (GtkPrintSettings *settings,
                                const char *printer);

Convenience function to set GTK_PRINT_SETTINGS_PRINTER to printer .

Parameters

settings

a GtkPrintSettings

printer

the printer name

gtk_print_settings_get_orientation ()

GtkPageOrientation
gtk_print_settings_get_orientation (GtkPrintSettings *settings);

Get the value of GTK_PRINT_SETTINGS_ORIENTATION, converted to a GtkPageOrientation.

Parameters

settings

a GtkPrintSettings

Returns

the orientation

gtk_print_settings_set_orientation ()

void
gtk_print_settings_set_orientation (GtkPrintSettings *settings,
                                    GtkPageOrientation orientation);

Sets the value of GTK_PRINT_SETTINGS_ORIENTATION.

Parameters

settings

a GtkPrintSettings

orientation

a page orientation

gtk_print_settings_get_paper_size ()

GtkPaperSize *
gtk_print_settings_get_paper_size (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_PAPER_FORMAT, converted to a GtkPaperSize.

Parameters

settings

a GtkPrintSettings

Returns

the paper size

gtk_print_settings_set_paper_size ()

void
gtk_print_settings_set_paper_size (GtkPrintSettings *settings,
                                   GtkPaperSize *paper_size);

Sets the value of GTK_PRINT_SETTINGS_PAPER_FORMAT, GTK_PRINT_SETTINGS_PAPER_WIDTH and GTK_PRINT_SETTINGS_PAPER_HEIGHT.

Parameters

settings

a GtkPrintSettings

paper_size

a paper size

gtk_print_settings_get_paper_width ()

double
gtk_print_settings_get_paper_width (GtkPrintSettings *settings,
                                    GtkUnit unit);

Gets the value of GTK_PRINT_SETTINGS_PAPER_WIDTH, converted to unit .

Parameters

settings

a GtkPrintSettings

unit

the unit for the return value

Returns

the paper width, in units of unit

gtk_print_settings_set_paper_width ()

void
gtk_print_settings_set_paper_width (GtkPrintSettings *settings,
                                    double width,
                                    GtkUnit unit);

Sets the value of GTK_PRINT_SETTINGS_PAPER_WIDTH.

Parameters

settings

a GtkPrintSettings

width

the paper width

unit

the units of width

gtk_print_settings_get_paper_height ()

double
gtk_print_settings_get_paper_height (GtkPrintSettings *settings,
                                     GtkUnit unit);

Gets the value of GTK_PRINT_SETTINGS_PAPER_HEIGHT, converted to unit .

Parameters

settings

a GtkPrintSettings

unit

the unit for the return value

Returns

the paper height, in units of unit

gtk_print_settings_set_paper_height ()

void
gtk_print_settings_set_paper_height (GtkPrintSettings *settings,
                                     double height,
                                     GtkUnit unit);

Sets the value of GTK_PRINT_SETTINGS_PAPER_HEIGHT.

Parameters

settings

a GtkPrintSettings

height

the paper height

unit

the units of height

gtk_print_settings_get_use_color ()

gboolean
gtk_print_settings_get_use_color (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_USE_COLOR.

Parameters

settings

a GtkPrintSettings

Returns

whether to use color

gtk_print_settings_set_use_color ()

void
gtk_print_settings_set_use_color (GtkPrintSettings *settings,
                                  gboolean use_color);

Sets the value of GTK_PRINT_SETTINGS_USE_COLOR.

Parameters

settings

a GtkPrintSettings

use_color

whether to use color

gtk_print_settings_get_collate ()

gboolean
gtk_print_settings_get_collate (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_COLLATE.

Parameters

settings

a GtkPrintSettings

Returns

whether to collate the printed pages

gtk_print_settings_set_collate ()

void
gtk_print_settings_set_collate (GtkPrintSettings *settings,
                                gboolean collate);

Sets the value of GTK_PRINT_SETTINGS_COLLATE.

Parameters

settings

a GtkPrintSettings

collate

whether to collate the output

gtk_print_settings_get_reverse ()

gboolean
gtk_print_settings_get_reverse (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_REVERSE.

Parameters

settings

a GtkPrintSettings

Returns

whether to reverse the order of the printed pages

gtk_print_settings_set_reverse ()

void
gtk_print_settings_set_reverse (GtkPrintSettings *settings,
                                gboolean reverse);

Sets the value of GTK_PRINT_SETTINGS_REVERSE.

Parameters

settings

a GtkPrintSettings

reverse

whether to reverse the output

gtk_print_settings_get_duplex ()

GtkPrintDuplex
gtk_print_settings_get_duplex (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_DUPLEX.

Parameters

settings

a GtkPrintSettings

Returns

whether to print the output in duplex.

gtk_print_settings_set_duplex ()

void
gtk_print_settings_set_duplex (GtkPrintSettings *settings,
                               GtkPrintDuplex duplex);

Sets the value of GTK_PRINT_SETTINGS_DUPLEX.

Parameters

settings

a GtkPrintSettings

duplex

a GtkPrintDuplex value

gtk_print_settings_get_quality ()

GtkPrintQuality
gtk_print_settings_get_quality (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_QUALITY.

Parameters

settings

a GtkPrintSettings

Returns

the print quality

gtk_print_settings_set_quality ()

void
gtk_print_settings_set_quality (GtkPrintSettings *settings,
                                GtkPrintQuality quality);

Sets the value of GTK_PRINT_SETTINGS_QUALITY.

Parameters

settings

a GtkPrintSettings

quality

a GtkPrintQuality value

gtk_print_settings_get_n_copies ()

int
gtk_print_settings_get_n_copies (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_N_COPIES.

Parameters

settings

a GtkPrintSettings

Returns

the number of copies to print

gtk_print_settings_set_n_copies ()

void
gtk_print_settings_set_n_copies (GtkPrintSettings *settings,
                                 int num_copies);

Sets the value of GTK_PRINT_SETTINGS_N_COPIES.

Parameters

settings

a GtkPrintSettings

num_copies

the number of copies

gtk_print_settings_get_number_up ()

int
gtk_print_settings_get_number_up (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_NUMBER_UP.

Parameters

settings

a GtkPrintSettings

Returns

the number of pages per sheet

gtk_print_settings_set_number_up ()

void
gtk_print_settings_set_number_up (GtkPrintSettings *settings,
                                  int number_up);

Sets the value of GTK_PRINT_SETTINGS_NUMBER_UP.

Parameters

settings

a GtkPrintSettings

number_up

the number of pages per sheet

gtk_print_settings_get_number_up_layout ()

GtkNumberUpLayout
gtk_print_settings_get_number_up_layout
                               (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT.

Parameters

settings

a GtkPrintSettings

Returns

layout of page in number-up mode

gtk_print_settings_set_number_up_layout ()

void
gtk_print_settings_set_number_up_layout
                               (GtkPrintSettings *settings,
                                GtkNumberUpLayout number_up_layout);

Sets the value of GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT.

Parameters

settings

a GtkPrintSettings

number_up_layout

a GtkNumberUpLayout value

gtk_print_settings_get_resolution ()

int
gtk_print_settings_get_resolution (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_RESOLUTION.

Parameters

settings

a GtkPrintSettings

Returns

the resolution in dpi

gtk_print_settings_set_resolution ()

void
gtk_print_settings_set_resolution (GtkPrintSettings *settings,
                                   int resolution);

Sets the values of GTK_PRINT_SETTINGS_RESOLUTION, GTK_PRINT_SETTINGS_RESOLUTION_X and GTK_PRINT_SETTINGS_RESOLUTION_Y.

Parameters

settings

a GtkPrintSettings

resolution

the resolution in dpi

gtk_print_settings_set_resolution_xy ()

void
gtk_print_settings_set_resolution_xy (GtkPrintSettings *settings,
                                      int resolution_x,
                                      int resolution_y);

Sets the values of GTK_PRINT_SETTINGS_RESOLUTION, GTK_PRINT_SETTINGS_RESOLUTION_X and GTK_PRINT_SETTINGS_RESOLUTION_Y.

Parameters

settings

a GtkPrintSettings

resolution_x

the horizontal resolution in dpi

resolution_y

the vertical resolution in dpi

gtk_print_settings_get_resolution_x ()

int
gtk_print_settings_get_resolution_x (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_RESOLUTION_X.

Parameters

settings

a GtkPrintSettings

Returns

the horizontal resolution in dpi

gtk_print_settings_get_resolution_y ()

int
gtk_print_settings_get_resolution_y (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_RESOLUTION_Y.

Parameters

settings

a GtkPrintSettings

Returns

the vertical resolution in dpi

gtk_print_settings_get_printer_lpi ()

double
gtk_print_settings_get_printer_lpi (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_PRINTER_LPI.

Parameters

settings

a GtkPrintSettings

Returns

the resolution in lpi (lines per inch)

gtk_print_settings_set_printer_lpi ()

void
gtk_print_settings_set_printer_lpi (GtkPrintSettings *settings,
                                    double lpi);

Sets the value of GTK_PRINT_SETTINGS_PRINTER_LPI.

Parameters

settings

a GtkPrintSettings

lpi

the resolution in lpi (lines per inch)

gtk_print_settings_get_scale ()

double
gtk_print_settings_get_scale (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_SCALE.

Parameters

settings

a GtkPrintSettings

Returns

the scale in percent

gtk_print_settings_set_scale ()

void
gtk_print_settings_set_scale (GtkPrintSettings *settings,
                              double scale);

Sets the value of GTK_PRINT_SETTINGS_SCALE.

Parameters

settings

a GtkPrintSettings

scale

the scale in percent

gtk_print_settings_get_print_pages ()

GtkPrintPages
gtk_print_settings_get_print_pages (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_PRINT_PAGES.

Parameters

settings

a GtkPrintSettings

Returns

which pages to print

gtk_print_settings_set_print_pages ()

void
gtk_print_settings_set_print_pages (GtkPrintSettings *settings,
                                    GtkPrintPages pages);

Sets the value of GTK_PRINT_SETTINGS_PRINT_PAGES.

Parameters

settings

a GtkPrintSettings

pages

a GtkPrintPages value

gtk_print_settings_get_page_ranges ()

GtkPageRange *
gtk_print_settings_get_page_ranges (GtkPrintSettings *settings,
                                    int *num_ranges);

Gets the value of GTK_PRINT_SETTINGS_PAGE_RANGES.

Parameters

settings

a GtkPrintSettings

num_ranges

return location for the length of the returned array.

[out]

Returns

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

[array length=num_ranges][transfer full]

gtk_print_settings_set_page_ranges ()

void
gtk_print_settings_set_page_ranges (GtkPrintSettings *settings,
                                    GtkPageRange *page_ranges,
                                    int num_ranges);

Sets the value of GTK_PRINT_SETTINGS_PAGE_RANGES.

Parameters

settings

a GtkPrintSettings

page_ranges

an array of GtkPageRanges.

[array length=num_ranges]

num_ranges

the length of page_ranges

gtk_print_settings_get_page_set ()

GtkPageSet
gtk_print_settings_get_page_set (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_PAGE_SET.

Parameters

settings

a GtkPrintSettings

Returns

the set of pages to print

gtk_print_settings_set_page_set ()

void
gtk_print_settings_set_page_set (GtkPrintSettings *settings,
                                 GtkPageSet page_set);

Sets the value of GTK_PRINT_SETTINGS_PAGE_SET.

Parameters

settings

a GtkPrintSettings

page_set

a GtkPageSet value

gtk_print_settings_get_default_source ()

const char *
gtk_print_settings_get_default_source (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_DEFAULT_SOURCE.

Parameters

settings

a GtkPrintSettings

Returns

the default source

gtk_print_settings_set_default_source ()

void
gtk_print_settings_set_default_source (GtkPrintSettings *settings,
                                       const char *default_source);

Sets the value of GTK_PRINT_SETTINGS_DEFAULT_SOURCE.

Parameters

settings

a GtkPrintSettings

default_source

the default source

gtk_print_settings_get_media_type ()

const char *
gtk_print_settings_get_media_type (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_MEDIA_TYPE.

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

Parameters

settings

a GtkPrintSettings

Returns

the media type

gtk_print_settings_set_media_type ()

void
gtk_print_settings_set_media_type (GtkPrintSettings *settings,
                                   const char *media_type);

Sets the value of GTK_PRINT_SETTINGS_MEDIA_TYPE.

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

Parameters

settings

a GtkPrintSettings

media_type

the media type

gtk_print_settings_get_dither ()

const char *
gtk_print_settings_get_dither (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_DITHER.

Parameters

settings

a GtkPrintSettings

Returns

the dithering that is used

gtk_print_settings_set_dither ()

void
gtk_print_settings_set_dither (GtkPrintSettings *settings,
                               const char *dither);

Sets the value of GTK_PRINT_SETTINGS_DITHER.

Parameters

settings

a GtkPrintSettings

dither

the dithering that is used

gtk_print_settings_get_finishings ()

const char *
gtk_print_settings_get_finishings (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_FINISHINGS.

Parameters

settings

a GtkPrintSettings

Returns

the finishings

gtk_print_settings_set_finishings ()

void
gtk_print_settings_set_finishings (GtkPrintSettings *settings,
                                   const char *finishings);

Sets the value of GTK_PRINT_SETTINGS_FINISHINGS.

Parameters

settings

a GtkPrintSettings

finishings

the finishings

gtk_print_settings_get_output_bin ()

const char *
gtk_print_settings_get_output_bin (GtkPrintSettings *settings);

Gets the value of GTK_PRINT_SETTINGS_OUTPUT_BIN.

Parameters

settings

a GtkPrintSettings

Returns

the output bin

gtk_print_settings_set_output_bin ()

void
gtk_print_settings_set_output_bin (GtkPrintSettings *settings,
                                   const char *output_bin);

Sets the value of GTK_PRINT_SETTINGS_OUTPUT_BIN.

Parameters

settings

a GtkPrintSettings

output_bin

the output bin

gtk_print_settings_new_from_file ()

GtkPrintSettings *
gtk_print_settings_new_from_file (const char *file_name,
                                  GError **error);

Reads the print settings from file_name . Returns a new GtkPrintSettings 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 gtk_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 GtkPrintSettings

gtk_print_settings_new_from_key_file ()

GtkPrintSettings *
gtk_print_settings_new_from_key_file (GKeyFile *key_file,
                                      const char *group_name,
                                      GError **error);

Reads the print settings from the group group_name in key_file . Returns a new GtkPrintSettings 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 GtkPrintSettings

gtk_print_settings_new_from_gvariant ()

GtkPrintSettings *
gtk_print_settings_new_from_gvariant (GVariant *variant);

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

Parameters

variant

an a{sv} GVariant

Returns

a new GtkPrintSettings object.

[transfer full]

gtk_print_settings_load_file ()

gboolean
gtk_print_settings_load_file (GtkPrintSettings *settings,
                              const char *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 gtk_print_settings_to_file().

Parameters

settings

a GtkPrintSettings

file_name

the filename to read the settings from.

[type filename]

error

return location for errors, or NULL.

[allow-none]

Returns

TRUE on success

gtk_print_settings_load_key_file ()

gboolean
gtk_print_settings_load_key_file (GtkPrintSettings *settings,
                                  GKeyFile *key_file,
                                  const char *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 GtkPrintSettings

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

gtk_print_settings_to_file ()

gboolean
gtk_print_settings_to_file (GtkPrintSettings *settings,
                            const char *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 GtkPrintSettings

file_name

the file to save to.

[type filename]

error

return location for errors, or NULL.

[allow-none]

Returns

TRUE on success

gtk_print_settings_to_key_file ()

void
gtk_print_settings_to_key_file (GtkPrintSettings *settings,
                                GKeyFile *key_file,
                                const char *group_name);

This function adds the print settings from settings to key_file .

Parameters

settings

a GtkPrintSettings

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]

gtk_print_settings_to_gvariant ()

GVariant *
gtk_print_settings_to_gvariant (GtkPrintSettings *settings);

Serialize print settings to an a{sv} variant.

Parameters

settings

a GtkPrintSettings

Returns

a new, floating, GVariant.

[transfer none]

Types and Values

GtkPrintSettings

typedef struct _GtkPrintSettings GtkPrintSettings;

GTK_PRINT_SETTINGS_PRINTER

#define GTK_PRINT_SETTINGS_PRINTER          "printer"

enum GtkPageOrientation

See also gtk_print_settings_set_orientation().

Members

GTK_PAGE_ORIENTATION_PORTRAIT

Portrait mode.

GTK_PAGE_ORIENTATION_LANDSCAPE

Landscape mode.

GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT

Reverse portrait mode.

GTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE

Reverse landscape mode.

GTK_PRINT_SETTINGS_ORIENTATION

#define GTK_PRINT_SETTINGS_ORIENTATION      "orientation"

GTK_PRINT_SETTINGS_PAPER_FORMAT

#define GTK_PRINT_SETTINGS_PAPER_FORMAT     "paper-format"

GTK_PRINT_SETTINGS_PAPER_WIDTH

#define GTK_PRINT_SETTINGS_PAPER_WIDTH      "paper-width"

GTK_PRINT_SETTINGS_PAPER_HEIGHT

#define GTK_PRINT_SETTINGS_PAPER_HEIGHT     "paper-height"

GTK_PRINT_SETTINGS_USE_COLOR

#define GTK_PRINT_SETTINGS_USE_COLOR        "use-color"

GTK_PRINT_SETTINGS_COLLATE

#define GTK_PRINT_SETTINGS_COLLATE          "collate"

GTK_PRINT_SETTINGS_REVERSE

#define GTK_PRINT_SETTINGS_REVERSE          "reverse"

enum GtkPrintDuplex

See also gtk_print_settings_set_duplex().

Members

GTK_PRINT_DUPLEX_SIMPLEX

No duplex.

GTK_PRINT_DUPLEX_HORIZONTAL

Horizontal duplex.

GTK_PRINT_DUPLEX_VERTICAL

Vertical duplex.

GTK_PRINT_SETTINGS_DUPLEX

#define GTK_PRINT_SETTINGS_DUPLEX           "duplex"

enum GtkPrintQuality

See also gtk_print_settings_set_quality().

Members

GTK_PRINT_QUALITY_LOW

Low quality.

GTK_PRINT_QUALITY_NORMAL

Normal quality.

GTK_PRINT_QUALITY_HIGH

High quality.

GTK_PRINT_QUALITY_DRAFT

Draft quality.

GTK_PRINT_SETTINGS_QUALITY

#define GTK_PRINT_SETTINGS_QUALITY          "quality"

GTK_PRINT_SETTINGS_N_COPIES

#define GTK_PRINT_SETTINGS_N_COPIES         "n-copies"

GTK_PRINT_SETTINGS_NUMBER_UP

#define GTK_PRINT_SETTINGS_NUMBER_UP        "number-up"

enum GtkNumberUpLayout

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

Members

GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM

GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_BOTTOM_TO_TOP

GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_TOP_TO_BOTTOM

GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_BOTTOM_TO_TOP

GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_LEFT_TO_RIGHT

GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_RIGHT_TO_LEFT

GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_LEFT_TO_RIGHT

GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_RIGHT_TO_LEFT

GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT

#define GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT "number-up-layout"

GTK_PRINT_SETTINGS_RESOLUTION

#define GTK_PRINT_SETTINGS_RESOLUTION       "resolution"

GTK_PRINT_SETTINGS_RESOLUTION_X

#define GTK_PRINT_SETTINGS_RESOLUTION_X     "resolution-x"

GTK_PRINT_SETTINGS_RESOLUTION_Y

#define GTK_PRINT_SETTINGS_RESOLUTION_Y     "resolution-y"

GTK_PRINT_SETTINGS_PRINTER_LPI

#define GTK_PRINT_SETTINGS_PRINTER_LPI      "printer-lpi"

GTK_PRINT_SETTINGS_SCALE

#define GTK_PRINT_SETTINGS_SCALE            "scale"

enum GtkPrintPages

See also gtk_print_job_set_pages()

Members

GTK_PRINT_PAGES_ALL

All pages.

GTK_PRINT_PAGES_CURRENT

Current page.

GTK_PRINT_PAGES_RANGES

Range of pages.

GTK_PRINT_PAGES_SELECTION

Selected pages.

GTK_PRINT_SETTINGS_PRINT_PAGES

#define GTK_PRINT_SETTINGS_PRINT_PAGES      "print-pages"

struct GtkPageRange

struct GtkPageRange {
  int start;
  int end;
};

See also gtk_print_settings_set_page_ranges().

Members

int start;

start of page range.

int end;

end of page range.

GTK_PRINT_SETTINGS_PAGE_RANGES

#define GTK_PRINT_SETTINGS_PAGE_RANGES      "page-ranges"

enum GtkPageSet

See also gtk_print_job_set_page_set().

Members

GTK_PAGE_SET_ALL

All pages.

GTK_PAGE_SET_EVEN

Even pages.

GTK_PAGE_SET_ODD

Odd pages.

GTK_PRINT_SETTINGS_PAGE_SET

#define GTK_PRINT_SETTINGS_PAGE_SET         "page-set"

GTK_PRINT_SETTINGS_DEFAULT_SOURCE

#define GTK_PRINT_SETTINGS_DEFAULT_SOURCE   "default-source"

GTK_PRINT_SETTINGS_MEDIA_TYPE

#define GTK_PRINT_SETTINGS_MEDIA_TYPE       "media-type"

GTK_PRINT_SETTINGS_DITHER

#define GTK_PRINT_SETTINGS_DITHER           "dither"

GTK_PRINT_SETTINGS_FINISHINGS

#define GTK_PRINT_SETTINGS_FINISHINGS       "finishings"

GTK_PRINT_SETTINGS_OUTPUT_BIN

#define GTK_PRINT_SETTINGS_OUTPUT_BIN       "output-bin"

GTK_PRINT_SETTINGS_OUTPUT_DIR

#define GTK_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.

GTK_PRINT_SETTINGS_OUTPUT_BASENAME

#define GTK_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.

GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT

#define GTK_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”.

GTK_PRINT_SETTINGS_OUTPUT_URI

#define GTK_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. GTK itself supports only “file://” URIs.

GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA

#define GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA   "win32-driver-extra"

GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION

#define GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION "win32-driver-version"

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk4/4.0/GtkPrintSettings.html