![]() |
![]() |
![]() |
GTK+ 3 Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <gtk/gtk.h> GtkPrintSettings; void (*GtkPrintSettingsFunc) (const gchar *key
,const gchar *value
,gpointer user_data
); GtkPrintSettings * gtk_print_settings_new (void
); GtkPrintSettings * gtk_print_settings_copy (GtkPrintSettings *other
); gboolean gtk_print_settings_has_key (GtkPrintSettings *settings
,const gchar *key
); const gchar * gtk_print_settings_get (GtkPrintSettings *settings
,const gchar *key
); void gtk_print_settings_set (GtkPrintSettings *settings
,const gchar *key
,const gchar *value
); void gtk_print_settings_unset (GtkPrintSettings *settings
,const gchar *key
); void gtk_print_settings_foreach (GtkPrintSettings *settings
,GtkPrintSettingsFunc func
,gpointer user_data
); gboolean gtk_print_settings_get_bool (GtkPrintSettings *settings
,const gchar *key
); void gtk_print_settings_set_bool (GtkPrintSettings *settings
,const gchar *key
,gboolean value
); gdouble gtk_print_settings_get_double (GtkPrintSettings *settings
,const gchar *key
); gdouble gtk_print_settings_get_double_with_default (GtkPrintSettings *settings
,const gchar *key
,gdouble def
); void gtk_print_settings_set_double (GtkPrintSettings *settings
,const gchar *key
,gdouble value
); gdouble gtk_print_settings_get_length (GtkPrintSettings *settings
,const gchar *key
,GtkUnit unit
); void gtk_print_settings_set_length (GtkPrintSettings *settings
,const gchar *key
,gdouble value
,GtkUnit unit
); gint gtk_print_settings_get_int (GtkPrintSettings *settings
,const gchar *key
); gint gtk_print_settings_get_int_with_default (GtkPrintSettings *settings
,const gchar *key
,gint def
); void gtk_print_settings_set_int (GtkPrintSettings *settings
,const gchar *key
,gint value
); #define GTK_PRINT_SETTINGS_PRINTER const gchar * gtk_print_settings_get_printer (GtkPrintSettings *settings
); void gtk_print_settings_set_printer (GtkPrintSettings *settings
,const gchar *printer
); enum GtkPageOrientation; #define GTK_PRINT_SETTINGS_ORIENTATION GtkPageOrientation gtk_print_settings_get_orientation (GtkPrintSettings *settings
); void gtk_print_settings_set_orientation (GtkPrintSettings *settings
,GtkPageOrientation orientation
); #define GTK_PRINT_SETTINGS_PAPER_FORMAT GtkPaperSize * gtk_print_settings_get_paper_size (GtkPrintSettings *settings
); void gtk_print_settings_set_paper_size (GtkPrintSettings *settings
,GtkPaperSize *paper_size
); #define GTK_PRINT_SETTINGS_PAPER_WIDTH gdouble gtk_print_settings_get_paper_width (GtkPrintSettings *settings
,GtkUnit unit
); void gtk_print_settings_set_paper_width (GtkPrintSettings *settings
,gdouble width
,GtkUnit unit
); #define GTK_PRINT_SETTINGS_PAPER_HEIGHT gdouble gtk_print_settings_get_paper_height (GtkPrintSettings *settings
,GtkUnit unit
); void gtk_print_settings_set_paper_height (GtkPrintSettings *settings
,gdouble height
,GtkUnit unit
); #define GTK_PRINT_SETTINGS_USE_COLOR gboolean gtk_print_settings_get_use_color (GtkPrintSettings *settings
); void gtk_print_settings_set_use_color (GtkPrintSettings *settings
,gboolean use_color
); #define GTK_PRINT_SETTINGS_COLLATE gboolean gtk_print_settings_get_collate (GtkPrintSettings *settings
); void gtk_print_settings_set_collate (GtkPrintSettings *settings
,gboolean collate
); #define GTK_PRINT_SETTINGS_REVERSE gboolean gtk_print_settings_get_reverse (GtkPrintSettings *settings
); void gtk_print_settings_set_reverse (GtkPrintSettings *settings
,gboolean reverse
); enum GtkPrintDuplex; #define GTK_PRINT_SETTINGS_DUPLEX GtkPrintDuplex gtk_print_settings_get_duplex (GtkPrintSettings *settings
); void gtk_print_settings_set_duplex (GtkPrintSettings *settings
,GtkPrintDuplex duplex
); enum GtkPrintQuality; #define GTK_PRINT_SETTINGS_QUALITY GtkPrintQuality gtk_print_settings_get_quality (GtkPrintSettings *settings
); void gtk_print_settings_set_quality (GtkPrintSettings *settings
,GtkPrintQuality quality
); #define GTK_PRINT_SETTINGS_N_COPIES gint gtk_print_settings_get_n_copies (GtkPrintSettings *settings
); void gtk_print_settings_set_n_copies (GtkPrintSettings *settings
,gint num_copies
); #define GTK_PRINT_SETTINGS_NUMBER_UP gint gtk_print_settings_get_number_up (GtkPrintSettings *settings
); void gtk_print_settings_set_number_up (GtkPrintSettings *settings
,gint number_up
); enum GtkNumberUpLayout; #define GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT GtkNumberUpLayout gtk_print_settings_get_number_up_layout (GtkPrintSettings *settings
); void gtk_print_settings_set_number_up_layout (GtkPrintSettings *settings
,GtkNumberUpLayout number_up_layout
); #define GTK_PRINT_SETTINGS_RESOLUTION gint gtk_print_settings_get_resolution (GtkPrintSettings *settings
); void gtk_print_settings_set_resolution (GtkPrintSettings *settings
,gint resolution
); void gtk_print_settings_set_resolution_xy (GtkPrintSettings *settings
,gint resolution_x
,gint resolution_y
); #define GTK_PRINT_SETTINGS_RESOLUTION_X gint gtk_print_settings_get_resolution_x (GtkPrintSettings *settings
); #define GTK_PRINT_SETTINGS_RESOLUTION_Y gint gtk_print_settings_get_resolution_y (GtkPrintSettings *settings
); #define GTK_PRINT_SETTINGS_PRINTER_LPI gdouble gtk_print_settings_get_printer_lpi (GtkPrintSettings *settings
); void gtk_print_settings_set_printer_lpi (GtkPrintSettings *settings
,gdouble lpi
); #define GTK_PRINT_SETTINGS_SCALE gdouble gtk_print_settings_get_scale (GtkPrintSettings *settings
); void gtk_print_settings_set_scale (GtkPrintSettings *settings
,gdouble scale
); enum GtkPrintPages; #define GTK_PRINT_SETTINGS_PRINT_PAGES GtkPrintPages gtk_print_settings_get_print_pages (GtkPrintSettings *settings
); void gtk_print_settings_set_print_pages (GtkPrintSettings *settings
,GtkPrintPages pages
); GtkPageRange; #define GTK_PRINT_SETTINGS_PAGE_RANGES GtkPageRange * gtk_print_settings_get_page_ranges (GtkPrintSettings *settings
,gint *num_ranges
); void gtk_print_settings_set_page_ranges (GtkPrintSettings *settings
,GtkPageRange *page_ranges
,gint num_ranges
); enum GtkPageSet; #define GTK_PRINT_SETTINGS_PAGE_SET GtkPageSet gtk_print_settings_get_page_set (GtkPrintSettings *settings
); void gtk_print_settings_set_page_set (GtkPrintSettings *settings
,GtkPageSet page_set
); #define GTK_PRINT_SETTINGS_DEFAULT_SOURCE const gchar * gtk_print_settings_get_default_source (GtkPrintSettings *settings
); void gtk_print_settings_set_default_source (GtkPrintSettings *settings
,const gchar *default_source
); #define GTK_PRINT_SETTINGS_MEDIA_TYPE const gchar * gtk_print_settings_get_media_type (GtkPrintSettings *settings
); void gtk_print_settings_set_media_type (GtkPrintSettings *settings
,const gchar *media_type
); #define GTK_PRINT_SETTINGS_DITHER const gchar * gtk_print_settings_get_dither (GtkPrintSettings *settings
); void gtk_print_settings_set_dither (GtkPrintSettings *settings
,const gchar *dither
); #define GTK_PRINT_SETTINGS_FINISHINGS const gchar * gtk_print_settings_get_finishings (GtkPrintSettings *settings
); void gtk_print_settings_set_finishings (GtkPrintSettings *settings
,const gchar *finishings
); #define GTK_PRINT_SETTINGS_OUTPUT_BIN const gchar * gtk_print_settings_get_output_bin (GtkPrintSettings *settings
); void gtk_print_settings_set_output_bin (GtkPrintSettings *settings
,const gchar *output_bin
); #define GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT #define GTK_PRINT_SETTINGS_OUTPUT_URI #define GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA #define GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION GtkPrintSettings * gtk_print_settings_new_from_file (const gchar *file_name
,GError **error
); GtkPrintSettings * gtk_print_settings_new_from_key_file (GKeyFile *key_file
,const gchar *group_name
,GError **error
); gboolean gtk_print_settings_load_file (GtkPrintSettings *settings
,const gchar *file_name
,GError **error
); gboolean gtk_print_settings_load_key_file (GtkPrintSettings *settings
,GKeyFile *key_file
,const gchar *group_name
,GError **error
); gboolean gtk_print_settings_to_file (GtkPrintSettings *settings
,const gchar *file_name
,GError **error
); void gtk_print_settings_to_key_file (GtkPrintSettings *settings
,GKeyFile *key_file
,const gchar *group_name
);
void (*GtkPrintSettingsFunc) (const gchar *key
,const gchar *value
,gpointer user_data
);
|
|
|
|
|
GtkPrintSettings * gtk_print_settings_new (void
);
Creates a new GtkPrintSettings object.
Returns : |
a new GtkPrintSettings object |
Since 2.10
GtkPrintSettings * gtk_print_settings_copy (GtkPrintSettings *other
);
Copies a GtkPrintSettings object.
|
a GtkPrintSettings |
Returns : |
a newly allocated copy of other . [transfer full]
|
Since 2.10
gboolean gtk_print_settings_has_key (GtkPrintSettings *settings
,const gchar *key
);
Returns TRUE
, if a value is associated with key
.
|
a GtkPrintSettings |
|
a key |
Returns : |
TRUE , if key has a value
|
Since 2.10
const gchar * gtk_print_settings_get (GtkPrintSettings *settings
,const gchar *key
);
Looks up the string value associated with key
.
|
a GtkPrintSettings |
|
a key |
Returns : |
the string value for key
|
Since 2.10
void gtk_print_settings_set (GtkPrintSettings *settings
,const gchar *key
,const gchar *value
);
Associates value
with key
.
|
a GtkPrintSettings |
|
a key |
|
a string value, or NULL . [allow-none]
|
Since 2.10
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
.
|
a GtkPrintSettings |
|
a key |
Since 2.10
void gtk_print_settings_foreach (GtkPrintSettings *settings
,GtkPrintSettingsFunc func
,gpointer user_data
);
Calls func
for each key-value pair of settings
.
|
a GtkPrintSettings |
|
the function to call. [scope call] |
|
user data for func
|
Since 2.10
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
.
|
a GtkPrintSettings |
|
a key |
Returns : |
TRUE , if key maps to a true value.
|
Since 2.10
void gtk_print_settings_set_bool (GtkPrintSettings *settings
,const gchar *key
,gboolean value
);
Sets key
to a boolean value.
|
a GtkPrintSettings |
|
a key |
|
a boolean |
Since 2.10
gdouble gtk_print_settings_get_double (GtkPrintSettings *settings
,const gchar *key
);
Returns the double value associated with key
, or 0.
|
a GtkPrintSettings |
|
a key |
Returns : |
the double value of key
|
Since 2.10
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()
.
|
a GtkPrintSettings |
|
a key |
|
the default value |
Returns : |
the floating point number associated with key
|
Since 2.10
void gtk_print_settings_set_double (GtkPrintSettings *settings
,const gchar *key
,gdouble value
);
Sets key
to a double value.
|
a GtkPrintSettings |
|
a key |
|
a double value |
Since 2.10
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
.
|
a GtkPrintSettings |
|
a key |
|
the unit of the return value |
Returns : |
the length value of key , converted to unit
|
Since 2.10
void gtk_print_settings_set_length (GtkPrintSettings *settings
,const gchar *key
,gdouble value
,GtkUnit unit
);
Associates a length in units of unit
with key
.
|
a GtkPrintSettings |
|
a key |
|
a length |
|
the unit of length
|
Since 2.10
gint gtk_print_settings_get_int (GtkPrintSettings *settings
,const gchar *key
);
Returns the integer value of key
, or 0.
|
a GtkPrintSettings |
|
a key |
Returns : |
the integer value of key
|
Since 2.10
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.
|
a GtkPrintSettings |
|
a key |
|
the default value |
Returns : |
the integer value of key
|
Since 2.10
void gtk_print_settings_set_int (GtkPrintSettings *settings
,const gchar *key
,gint value
);
Sets key
to an integer value.
|
a GtkPrintSettings |
|
a key |
|
an integer |
Since 2.10
const gchar * gtk_print_settings_get_printer (GtkPrintSettings *settings
);
Convenience function to obtain the value of
GTK_PRINT_SETTINGS_PRINTER
.
|
a GtkPrintSettings |
Returns : |
the printer name |
Since 2.10
void gtk_print_settings_set_printer (GtkPrintSettings *settings
,const gchar *printer
);
Convenience function to set GTK_PRINT_SETTINGS_PRINTER
to printer
.
|
a GtkPrintSettings |
|
the printer name |
Since 2.10
typedef enum { GTK_PAGE_ORIENTATION_PORTRAIT, GTK_PAGE_ORIENTATION_LANDSCAPE, GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT, GTK_PAGE_ORIENTATION_REVERSE_LANDSCAPE } GtkPageOrientation;
GtkPageOrientation gtk_print_settings_get_orientation (GtkPrintSettings *settings
);
Get the value of GTK_PRINT_SETTINGS_ORIENTATION
,
converted to a GtkPageOrientation.
|
a GtkPrintSettings |
Returns : |
the orientation |
Since 2.10
void gtk_print_settings_set_orientation (GtkPrintSettings *settings
,GtkPageOrientation orientation
);
Sets the value of GTK_PRINT_SETTINGS_ORIENTATION
.
|
a GtkPrintSettings |
|
a page orientation |
Since 2.10
GtkPaperSize * gtk_print_settings_get_paper_size (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_PAPER_FORMAT
,
converted to a GtkPaperSize.
|
a GtkPrintSettings |
Returns : |
the paper size |
Since 2.10
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
.
|
a GtkPrintSettings |
|
a paper size |
Since 2.10
gdouble gtk_print_settings_get_paper_width (GtkPrintSettings *settings
,GtkUnit unit
);
Gets the value of GTK_PRINT_SETTINGS_PAPER_WIDTH
,
converted to unit
.
|
a GtkPrintSettings |
|
the unit for the return value |
Returns : |
the paper width, in units of unit
|
Since 2.10
void gtk_print_settings_set_paper_width (GtkPrintSettings *settings
,gdouble width
,GtkUnit unit
);
Sets the value of GTK_PRINT_SETTINGS_PAPER_WIDTH
.
|
a GtkPrintSettings |
|
the paper width |
|
the units of width
|
Since 2.10
gdouble gtk_print_settings_get_paper_height (GtkPrintSettings *settings
,GtkUnit unit
);
Gets the value of GTK_PRINT_SETTINGS_PAPER_HEIGHT
,
converted to unit
.
|
a GtkPrintSettings |
|
the unit for the return value |
Returns : |
the paper height, in units of unit
|
Since 2.10
void gtk_print_settings_set_paper_height (GtkPrintSettings *settings
,gdouble height
,GtkUnit unit
);
Sets the value of GTK_PRINT_SETTINGS_PAPER_HEIGHT
.
|
a GtkPrintSettings |
|
the paper height |
|
the units of height
|
Since 2.10
gboolean gtk_print_settings_get_use_color (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_USE_COLOR
.
|
a GtkPrintSettings |
Returns : |
whether to use color |
Since 2.10
void gtk_print_settings_set_use_color (GtkPrintSettings *settings
,gboolean use_color
);
Sets the value of GTK_PRINT_SETTINGS_USE_COLOR
.
|
a GtkPrintSettings |
|
whether to use color |
Since 2.10
gboolean gtk_print_settings_get_collate (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_COLLATE
.
|
a GtkPrintSettings |
Returns : |
whether to collate the printed pages |
Since 2.10
void gtk_print_settings_set_collate (GtkPrintSettings *settings
,gboolean collate
);
Sets the value of GTK_PRINT_SETTINGS_COLLATE
.
|
a GtkPrintSettings |
|
whether to collate the output |
Since 2.10
gboolean gtk_print_settings_get_reverse (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_REVERSE
.
|
a GtkPrintSettings |
Returns : |
whether to reverse the order of the printed pages |
Since 2.10
void gtk_print_settings_set_reverse (GtkPrintSettings *settings
,gboolean reverse
);
Sets the value of GTK_PRINT_SETTINGS_REVERSE
.
|
a GtkPrintSettings |
|
whether to reverse the output |
Since 2.10
typedef enum { GTK_PRINT_DUPLEX_SIMPLEX, GTK_PRINT_DUPLEX_HORIZONTAL, GTK_PRINT_DUPLEX_VERTICAL } GtkPrintDuplex;
GtkPrintDuplex gtk_print_settings_get_duplex (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_DUPLEX
.
|
a GtkPrintSettings |
Returns : |
whether to print the output in duplex. |
Since 2.10
void gtk_print_settings_set_duplex (GtkPrintSettings *settings
,GtkPrintDuplex duplex
);
Sets the value of GTK_PRINT_SETTINGS_DUPLEX
.
|
a GtkPrintSettings |
|
a GtkPrintDuplex value |
Since 2.10
typedef enum { GTK_PRINT_QUALITY_LOW, GTK_PRINT_QUALITY_NORMAL, GTK_PRINT_QUALITY_HIGH, GTK_PRINT_QUALITY_DRAFT } GtkPrintQuality;
GtkPrintQuality gtk_print_settings_get_quality (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_QUALITY
.
|
a GtkPrintSettings |
Returns : |
the print quality |
Since 2.10
void gtk_print_settings_set_quality (GtkPrintSettings *settings
,GtkPrintQuality quality
);
Sets the value of GTK_PRINT_SETTINGS_QUALITY
.
|
a GtkPrintSettings |
|
a GtkPrintQuality value |
Since 2.10
gint gtk_print_settings_get_n_copies (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_N_COPIES
.
|
a GtkPrintSettings |
Returns : |
the number of copies to print |
Since 2.10
void gtk_print_settings_set_n_copies (GtkPrintSettings *settings
,gint num_copies
);
Sets the value of GTK_PRINT_SETTINGS_N_COPIES
.
|
a GtkPrintSettings |
|
the number of copies |
Since 2.10
gint gtk_print_settings_get_number_up (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_NUMBER_UP
.
|
a GtkPrintSettings |
Returns : |
the number of pages per sheet |
Since 2.10
void gtk_print_settings_set_number_up (GtkPrintSettings *settings
,gint number_up
);
Sets the value of GTK_PRINT_SETTINGS_NUMBER_UP
.
|
a GtkPrintSettings |
|
the number of pages per sheet |
Since 2.10
typedef enum { GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_TOP_TO_BOTTOM, /*< nick=lrtb >*/ GTK_NUMBER_UP_LAYOUT_LEFT_TO_RIGHT_BOTTOM_TO_TOP, /*< nick=lrbt >*/ GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_TOP_TO_BOTTOM, /*< nick=rltb >*/ GTK_NUMBER_UP_LAYOUT_RIGHT_TO_LEFT_BOTTOM_TO_TOP, /*< nick=rlbt >*/ GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_LEFT_TO_RIGHT, /*< nick=tblr >*/ GTK_NUMBER_UP_LAYOUT_TOP_TO_BOTTOM_RIGHT_TO_LEFT, /*< nick=tbrl >*/ GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_LEFT_TO_RIGHT, /*< nick=btlr >*/ GTK_NUMBER_UP_LAYOUT_BOTTOM_TO_TOP_RIGHT_TO_LEFT /*< nick=btrl >*/ } GtkNumberUpLayout;
GtkNumberUpLayout gtk_print_settings_get_number_up_layout
(GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT
.
|
a GtkPrintSettings |
Returns : |
layout of page in number-up mode |
Since 2.14
void gtk_print_settings_set_number_up_layout (GtkPrintSettings *settings
,GtkNumberUpLayout number_up_layout
);
Sets the value of GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT
.
|
a GtkPrintSettings |
|
a GtkNumberUpLayout value |
Since 2.14
gint gtk_print_settings_get_resolution (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_RESOLUTION
.
|
a GtkPrintSettings |
Returns : |
the resolution in dpi |
Since 2.10
void gtk_print_settings_set_resolution (GtkPrintSettings *settings
,gint resolution
);
Sets the values of GTK_PRINT_SETTINGS_RESOLUTION
,
GTK_PRINT_SETTINGS_RESOLUTION_X
and
GTK_PRINT_SETTINGS_RESOLUTION_Y
.
|
a GtkPrintSettings |
|
the resolution in dpi |
Since 2.10
void gtk_print_settings_set_resolution_xy (GtkPrintSettings *settings
,gint resolution_x
,gint resolution_y
);
Sets the values of GTK_PRINT_SETTINGS_RESOLUTION
,
GTK_PRINT_SETTINGS_RESOLUTION_X
and
GTK_PRINT_SETTINGS_RESOLUTION_Y
.
|
a GtkPrintSettings |
|
the horizontal resolution in dpi |
|
the vertical resolution in dpi |
Since 2.16
gint gtk_print_settings_get_resolution_x (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_RESOLUTION_X
.
|
a GtkPrintSettings |
Returns : |
the horizontal resolution in dpi |
Since 2.16
gint gtk_print_settings_get_resolution_y (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_RESOLUTION_Y
.
|
a GtkPrintSettings |
Returns : |
the vertical resolution in dpi |
Since 2.16
gdouble gtk_print_settings_get_printer_lpi (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_PRINTER_LPI
.
|
a GtkPrintSettings |
Returns : |
the resolution in lpi (lines per inch) |
Since 2.16
void gtk_print_settings_set_printer_lpi (GtkPrintSettings *settings
,gdouble lpi
);
Sets the value of GTK_PRINT_SETTINGS_PRINTER_LPI
.
|
a GtkPrintSettings |
|
the resolution in lpi (lines per inch) |
Since 2.16
gdouble gtk_print_settings_get_scale (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_SCALE
.
|
a GtkPrintSettings |
Returns : |
the scale in percent |
Since 2.10
void gtk_print_settings_set_scale (GtkPrintSettings *settings
,gdouble scale
);
Sets the value of GTK_PRINT_SETTINGS_SCALE
.
|
a GtkPrintSettings |
|
the scale in percent |
Since 2.10
typedef enum { GTK_PRINT_PAGES_ALL, GTK_PRINT_PAGES_CURRENT, GTK_PRINT_PAGES_RANGES, GTK_PRINT_PAGES_SELECTION } GtkPrintPages;
GtkPrintPages gtk_print_settings_get_print_pages (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_PRINT_PAGES
.
|
a GtkPrintSettings |
Returns : |
which pages to print |
Since 2.10
void gtk_print_settings_set_print_pages (GtkPrintSettings *settings
,GtkPrintPages pages
);
Sets the value of GTK_PRINT_SETTINGS_PRINT_PAGES
.
|
a GtkPrintSettings |
|
a GtkPrintPages value |
Since 2.10
GtkPageRange * gtk_print_settings_get_page_ranges (GtkPrintSettings *settings
,gint *num_ranges
);
Gets the value of GTK_PRINT_SETTINGS_PAGE_RANGES
.
|
a GtkPrintSettings |
|
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 length=num_ranges]
|
Since 2.10
void gtk_print_settings_set_page_ranges (GtkPrintSettings *settings
,GtkPageRange *page_ranges
,gint num_ranges
);
Sets the value of GTK_PRINT_SETTINGS_PAGE_RANGES
.
|
a GtkPrintSettings |
|
an array of GtkPageRanges. [array length=num_ranges] |
|
the length of page_ranges
|
Since 2.10
GtkPageSet gtk_print_settings_get_page_set (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_PAGE_SET
.
|
a GtkPrintSettings |
Returns : |
the set of pages to print |
Since 2.10
void gtk_print_settings_set_page_set (GtkPrintSettings *settings
,GtkPageSet page_set
);
Sets the value of GTK_PRINT_SETTINGS_PAGE_SET
.
|
a GtkPrintSettings |
|
a GtkPageSet value |
Since 2.10
const gchar * gtk_print_settings_get_default_source
(GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_DEFAULT_SOURCE
.
|
a GtkPrintSettings |
Returns : |
the default source |
Since 2.10
void gtk_print_settings_set_default_source (GtkPrintSettings *settings
,const gchar *default_source
);
Sets the value of GTK_PRINT_SETTINGS_DEFAULT_SOURCE
.
|
a GtkPrintSettings |
|
the default source |
Since 2.10
const gchar * 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.
|
a GtkPrintSettings |
Returns : |
the media type |
Since 2.10
void gtk_print_settings_set_media_type (GtkPrintSettings *settings
,const gchar *media_type
);
Sets the value of GTK_PRINT_SETTINGS_MEDIA_TYPE
.
The set of media types is defined in PWG 5101.1-2002 PWG.
|
a GtkPrintSettings |
|
the media type |
Since 2.10
const gchar * gtk_print_settings_get_dither (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_DITHER
.
|
a GtkPrintSettings |
Returns : |
the dithering that is used |
Since 2.10
void gtk_print_settings_set_dither (GtkPrintSettings *settings
,const gchar *dither
);
Sets the value of GTK_PRINT_SETTINGS_DITHER
.
|
a GtkPrintSettings |
|
the dithering that is used |
Since 2.10
const gchar * gtk_print_settings_get_finishings (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_FINISHINGS
.
|
a GtkPrintSettings |
Returns : |
the finishings |
Since 2.10
void gtk_print_settings_set_finishings (GtkPrintSettings *settings
,const gchar *finishings
);
Sets the value of GTK_PRINT_SETTINGS_FINISHINGS
.
|
a GtkPrintSettings |
|
the finishings |
Since 2.10
const gchar * gtk_print_settings_get_output_bin (GtkPrintSettings *settings
);
Gets the value of GTK_PRINT_SETTINGS_OUTPUT_BIN
.
|
a GtkPrintSettings |
Returns : |
the output bin |
Since 2.10
void gtk_print_settings_set_output_bin (GtkPrintSettings *settings
,const gchar *output_bin
);
Sets the value of GTK_PRINT_SETTINGS_OUTPUT_BIN
.
|
a GtkPrintSettings |
|
the output bin |
Since 2.10
#define GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT "output-file-format"
#define GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA "win32-driver-extra"
#define GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION "win32-driver-version"
GtkPrintSettings * gtk_print_settings_new_from_file (const gchar *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()
.
|
the filename to read the settings from. [type filename] |
|
return location for errors, or NULL . [allow-none]
|
Returns : |
the restored GtkPrintSettings |
Since 2.12
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.
|
the GKeyFile to retrieve the settings from |
|
the name of the group to use, or NULL to use
the default "Print Settings". [allow-none]
|
|
return location for errors, or NULL . [allow-none]
|
Returns : |
the restored GtkPrintSettings |
Since 2.12
gboolean gtk_print_settings_load_file (GtkPrintSettings *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 gtk_print_settings_to_file()
.
|
a GtkPrintSettings |
|
the filename to read the settings from. [type filename] |
|
return location for errors, or NULL . [allow-none]
|
Returns : |
TRUE on success
|
Since 2.14
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.
|
a GtkPrintSettings |
|
the GKeyFile to retrieve the settings from |
|
the name of the group to use, or NULL to use the default
"Print Settings". [allow-none]
|
|
return location for errors, or NULL . [allow-none]
|
Returns : |
TRUE on success
|
Since 2.14
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.
|
a GtkPrintSettings |
|
the file to save to. [type filename] |
|
return location for errors, or NULL . [allow-none]
|
Returns : |
TRUE on success
|
Since 2.12
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
.
|
a GtkPrintSettings |
|
the GKeyFile to save the print settings to |
|
the group to add the settings to in key_file , or
NULL to use the default "Print Settings"
|
Since 2.12