Functions
GtkPrintSettingsFunc ()
void
(*GtkPrintSettingsFunc) (const gchar *key,
const gchar *value,
gpointer user_data);
gtk_print_settings_has_key ()
gboolean
gtk_print_settings_has_key (GtkPrintSettings *settings,
const gchar *key);
Returns TRUE, if a value is associated with key
.
Returns
TRUE, if key
has a value
Since: 2.10
gtk_print_settings_get ()
const gchar *
gtk_print_settings_get (GtkPrintSettings *settings,
const gchar *key);
Looks up the string value associated with key
.
Returns
the string value for key
Since: 2.10
gtk_print_settings_set ()
void
gtk_print_settings_set (GtkPrintSettings *settings,
const gchar *key,
const gchar *value);
Associates value
with key
.
Since: 2.10
gtk_print_settings_unset ()
void
gtk_print_settings_unset (GtkPrintSettings *settings,
const gchar *key);
Removes any value associated with key
.
This has the same effect as setting the value to NULL.
Since: 2.10
gtk_print_settings_get_bool ()
gboolean
gtk_print_settings_get_bool (GtkPrintSettings *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.
Returns
TRUE, if key
maps to a true value.
Since: 2.10
gtk_print_settings_set_bool ()
void
gtk_print_settings_set_bool (GtkPrintSettings *settings,
const gchar *key,
gboolean value);
Sets key
to a boolean value.
Since: 2.10
gtk_print_settings_get_double ()
gdouble
gtk_print_settings_get_double (GtkPrintSettings *settings,
const gchar *key);
Returns the double value associated with key
, or 0.
Returns
the double value of key
Since: 2.10
gtk_print_settings_get_double_with_default ()
gdouble
gtk_print_settings_get_double_with_default
(GtkPrintSettings *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().
Returns
the floating point number associated with key
Since: 2.10
gtk_print_settings_set_double ()
void
gtk_print_settings_set_double (GtkPrintSettings *settings,
const gchar *key,
gdouble value);
Sets key
to a double value.
Since: 2.10
gtk_print_settings_get_length ()
gdouble
gtk_print_settings_get_length (GtkPrintSettings *settings,
const gchar *key,
GtkUnit unit);
Returns the value associated with key
, interpreted
as a length. The returned value is converted to units
.
Returns
the length value of key
, converted to unit
Since: 2.10
gtk_print_settings_set_length ()
void
gtk_print_settings_set_length (GtkPrintSettings *settings,
const gchar *key,
gdouble value,
GtkUnit unit);
Associates a length in units of unit
with key
.
Since: 2.10
gtk_print_settings_get_int ()
gint
gtk_print_settings_get_int (GtkPrintSettings *settings,
const gchar *key);
Returns the integer value of key
, or 0.
Returns
the integer value of key
Since: 2.10
gtk_print_settings_get_int_with_default ()
gint
gtk_print_settings_get_int_with_default
(GtkPrintSettings *settings,
const gchar *key,
gint def);
Returns the value of key
, interpreted as
an integer, or the default value.
Returns
the integer value of key
Since: 2.10
gtk_print_settings_set_int ()
void
gtk_print_settings_set_int (GtkPrintSettings *settings,
const gchar *key,
gint value);
Sets key
to an integer value.
Since: 2.10
gtk_print_settings_new_from_key_file ()
GtkPrintSettings *
gtk_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 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.
Since: 2.12
gtk_print_settings_load_key_file ()
gboolean
gtk_print_settings_load_key_file (GtkPrintSettings *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.
Since: 2.14
gtk_print_settings_to_file ()
gboolean
gtk_print_settings_to_file (GtkPrintSettings *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.
Since: 2.12
gtk_print_settings_to_key_file ()
void
gtk_print_settings_to_key_file (GtkPrintSettings *settings,
GKeyFile *key_file,
const gchar *group_name);
This function adds the print settings from settings
to key_file
.
Since: 2.12
gtk_print_settings_to_gvariant ()
GVariant *
gtk_print_settings_to_gvariant (GtkPrintSettings *settings);
Serialize print settings to an a{sv} variant.
Returns
a new, floating, GVariant.
[transfer none]
Since: 3.22
Types and Values
GtkPrintSettings
typedef struct _GtkPrintSettings GtkPrintSettings;
GTK_PRINT_SETTINGS_PRINTER
#define GTK_PRINT_SETTINGS_PRINTER "printer"
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"
GTK_PRINT_SETTINGS_DUPLEX
#define GTK_PRINT_SETTINGS_DUPLEX "duplex"
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.
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"
GTK_PRINT_SETTINGS_PRINT_PAGES
#define GTK_PRINT_SETTINGS_PRINT_PAGES "print-pages"
GTK_PRINT_SETTINGS_PAGE_RANGES
#define GTK_PRINT_SETTINGS_PAGE_RANGES "page-ranges"
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.
Since: 3.6
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.
Since: 3.6
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"