* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
+
#ifndef __GTK_PRINT_SETTINGS_H__
#define __GTK_PRINT_SETTINGS_H__
-#include <glib-object.h>
-#include "gtkpapersize.h"
+#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
+#error "Only <gtk/gtk.h> can be included directly."
+#endif
+
+#include <gtk/gtkpapersize.h>
G_BEGIN_DECLS
const gchar *value,
gpointer user_data);
-typedef struct
+typedef struct _GtkPageRange GtkPageRange;
+struct _GtkPageRange
{
gint start;
gint end;
-} GtkPageRange;
+};
-GType gtk_print_settings_get_type (void) G_GNUC_CONST;
-GtkPrintSettings *gtk_print_settings_new (void);
+GType gtk_print_settings_get_type (void) G_GNUC_CONST;
+GtkPrintSettings *gtk_print_settings_new (void);
GtkPrintSettings *gtk_print_settings_copy (GtkPrintSettings *other);
+
+GtkPrintSettings *gtk_print_settings_new_from_file (const gchar *file_name,
+ GError **error);
+gboolean gtk_print_settings_load_file (GtkPrintSettings *settings,
+ const gchar *file_name,
+ GError **error);
+gboolean gtk_print_settings_to_file (GtkPrintSettings *settings,
+ 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_key_file (GtkPrintSettings *settings,
+ GKeyFile *key_file,
+ const gchar *group_name,
+ GError **error);
+void gtk_print_settings_to_key_file (GtkPrintSettings *settings,
+ GKeyFile *key_file,
+ const gchar *group_name);
gboolean gtk_print_settings_has_key (GtkPrintSettings *settings,
const gchar *key);
-G_CONST_RETURN gchar *gtk_print_settings_get (GtkPrintSettings *settings,
+const gchar * gtk_print_settings_get (GtkPrintSettings *settings,
const gchar *key);
void gtk_print_settings_set (GtkPrintSettings *settings,
const gchar *key,
const gchar *key,
gint value);
-#define GTK_PRINT_SETTINGS_PRINTER "printer"
-#define GTK_PRINT_SETTINGS_ORIENTATION "orientation"
-#define GTK_PRINT_SETTINGS_PAPER_FORMAT "paper-format"
-#define GTK_PRINT_SETTINGS_PAPER_WIDTH "paper-width"
-#define GTK_PRINT_SETTINGS_PAPER_HEIGHT "paper-height"
-#define GTK_PRINT_SETTINGS_NUM_COPIES "num-copies"
-#define GTK_PRINT_SETTINGS_DEFAULT_SOURCE "default-source"
-#define GTK_PRINT_SETTINGS_QUALITY "quality"
-#define GTK_PRINT_SETTINGS_RESOLUTION "resolution"
-#define GTK_PRINT_SETTINGS_USE_COLOR "use-color"
-#define GTK_PRINT_SETTINGS_DUPLEX "duplex"
-#define GTK_PRINT_SETTINGS_COLLATE "collate"
-#define GTK_PRINT_SETTINGS_REVERSE "reverse"
-#define GTK_PRINT_SETTINGS_MEDIA_TYPE "media-type"
-#define GTK_PRINT_SETTINGS_DITHER "dither"
-#define GTK_PRINT_SETTINGS_SCALE "scale"
-#define GTK_PRINT_SETTINGS_PRINT_PAGES "print-pages"
-#define GTK_PRINT_SETTINGS_PAGE_RANGES "page-ranges"
-#define GTK_PRINT_SETTINGS_PAGE_SET "page-set"
-#define GTK_PRINT_SETTINGS_PRINT_TO_FILE "print-to-file"
-#define GTK_PRINT_SETTINGS_FINISHINGS "finishings"
-#define GTK_PRINT_SETTINGS_NUMBER_UP "number-up"
-#define GTK_PRINT_SETTINGS_OUTPUT_BIN "output-bin"
+#define GTK_PRINT_SETTINGS_PRINTER "printer"
+#define GTK_PRINT_SETTINGS_ORIENTATION "orientation"
+#define GTK_PRINT_SETTINGS_PAPER_FORMAT "paper-format"
+#define GTK_PRINT_SETTINGS_PAPER_WIDTH "paper-width"
+#define GTK_PRINT_SETTINGS_PAPER_HEIGHT "paper-height"
+#define GTK_PRINT_SETTINGS_N_COPIES "n-copies"
+#define GTK_PRINT_SETTINGS_DEFAULT_SOURCE "default-source"
+#define GTK_PRINT_SETTINGS_QUALITY "quality"
+#define GTK_PRINT_SETTINGS_RESOLUTION "resolution"
+#define GTK_PRINT_SETTINGS_USE_COLOR "use-color"
+#define GTK_PRINT_SETTINGS_DUPLEX "duplex"
+#define GTK_PRINT_SETTINGS_COLLATE "collate"
+#define GTK_PRINT_SETTINGS_REVERSE "reverse"
+#define GTK_PRINT_SETTINGS_MEDIA_TYPE "media-type"
+#define GTK_PRINT_SETTINGS_DITHER "dither"
+#define GTK_PRINT_SETTINGS_SCALE "scale"
+#define GTK_PRINT_SETTINGS_PRINT_PAGES "print-pages"
+#define GTK_PRINT_SETTINGS_PAGE_RANGES "page-ranges"
+#define GTK_PRINT_SETTINGS_PAGE_SET "page-set"
+#define GTK_PRINT_SETTINGS_FINISHINGS "finishings"
+#define GTK_PRINT_SETTINGS_NUMBER_UP "number-up"
+#define GTK_PRINT_SETTINGS_NUMBER_UP_LAYOUT "number-up-layout"
+#define GTK_PRINT_SETTINGS_OUTPUT_BIN "output-bin"
+#define GTK_PRINT_SETTINGS_RESOLUTION_X "resolution-x"
+#define GTK_PRINT_SETTINGS_RESOLUTION_Y "resolution-y"
+#define GTK_PRINT_SETTINGS_PRINTER_LPI "printer-lpi"
+#define GTK_PRINT_SETTINGS_OUTPUT_DIR "output-dir"
+#define GTK_PRINT_SETTINGS_OUTPUT_BASENAME "output-basename"
+
+/**
+ * GTK_PRINT_SETTINGS_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".
+ */
+#define GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT "output-file-format"
+
+/**
+ * GTK_PRINT_SETTINGS_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.
+ */
+#define GTK_PRINT_SETTINGS_OUTPUT_URI "output-uri"
#define GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION "win32-driver-version"
#define GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA "win32-driver-extra"
/* Helpers: */
-G_CONST_RETURN gchar *gtk_print_settings_get_printer (GtkPrintSettings *settings);
-void gtk_print_settings_set_printer (GtkPrintSettings *settings,
- const gchar *printer);
-GtkPageOrientation gtk_print_settings_get_orientation (GtkPrintSettings *settings);
-void gtk_print_settings_set_orientation (GtkPrintSettings *settings,
- GtkPageOrientation orientation);
-GtkPaperSize * gtk_print_settings_get_paper_size (GtkPrintSettings *settings);
-void gtk_print_settings_set_paper_size (GtkPrintSettings *settings,
- GtkPaperSize *paper_size);
-gdouble gtk_print_settings_get_paper_width (GtkPrintSettings *settings,
- GtkUnit unit);
-void gtk_print_settings_set_paper_width (GtkPrintSettings *settings,
- gdouble width,
- GtkUnit unit);
-gdouble gtk_print_settings_get_paper_height (GtkPrintSettings *settings,
- GtkUnit unit);
-void gtk_print_settings_set_paper_height (GtkPrintSettings *settings,
- gdouble width,
- GtkUnit unit);
-gboolean gtk_print_settings_get_use_color (GtkPrintSettings *settings);
-void gtk_print_settings_set_use_color (GtkPrintSettings *settings,
- gboolean use_color);
-gboolean gtk_print_settings_get_collate (GtkPrintSettings *settings);
-void gtk_print_settings_set_collate (GtkPrintSettings *settings,
- gboolean collate);
-gboolean gtk_print_settings_get_reverse (GtkPrintSettings *settings);
-void gtk_print_settings_set_reverse (GtkPrintSettings *settings,
- gboolean reverse);
-GtkPrintDuplex gtk_print_settings_get_duplex (GtkPrintSettings *settings);
-void gtk_print_settings_set_duplex (GtkPrintSettings *settings,
- GtkPrintDuplex duplex);
-GtkPrintQuality gtk_print_settings_get_quality (GtkPrintSettings *settings);
-void gtk_print_settings_set_quality (GtkPrintSettings *settings,
- GtkPrintQuality quality);
-gint gtk_print_settings_get_num_copies (GtkPrintSettings *settings);
-void gtk_print_settings_set_num_copies (GtkPrintSettings *settings,
- gint num_copies);
-gint gtk_print_settings_get_number_up (GtkPrintSettings *settings);
-void gtk_print_settings_set_number_up (GtkPrintSettings *settings,
- gint number_up);
-gint gtk_print_settings_get_resolution (GtkPrintSettings *settings);
-void gtk_print_settings_set_resolution (GtkPrintSettings *settings,
- gint resolution);
-gdouble gtk_print_settings_get_scale (GtkPrintSettings *settings);
-void gtk_print_settings_set_scale (GtkPrintSettings *settings,
- gdouble scale);
-gboolean gtk_print_settings_get_print_to_file (GtkPrintSettings *settings);
-void gtk_print_settings_set_print_to_file (GtkPrintSettings *settings,
- gboolean print_to_file);
-GtkPrintPages gtk_print_settings_get_print_pages (GtkPrintSettings *settings);
-void gtk_print_settings_set_print_pages (GtkPrintSettings *settings,
- GtkPrintPages pages);
-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);
-GtkPageSet gtk_print_settings_get_page_set (GtkPrintSettings *settings);
-void gtk_print_settings_set_page_set (GtkPrintSettings *settings,
- GtkPageSet page_set);
-G_CONST_RETURN gchar *gtk_print_settings_get_default_source (GtkPrintSettings *settings);
-void gtk_print_settings_set_default_source (GtkPrintSettings *settings,
- const gchar *default_source);
-G_CONST_RETURN gchar *gtk_print_settings_get_media_type (GtkPrintSettings *settings);
-void gtk_print_settings_set_media_type (GtkPrintSettings *settings,
- const gchar *media_type);
-G_CONST_RETURN gchar *gtk_print_settings_get_dither (GtkPrintSettings *settings);
-void gtk_print_settings_set_dither (GtkPrintSettings *settings,
- const gchar *dither);
-G_CONST_RETURN gchar *gtk_print_settings_get_finishings (GtkPrintSettings *settings);
-void gtk_print_settings_set_finishings (GtkPrintSettings *settings,
- const gchar *finishings);
-G_CONST_RETURN gchar *gtk_print_settings_get_output_bin (GtkPrintSettings *settings);
-void gtk_print_settings_set_output_bin (GtkPrintSettings *settings,
- const gchar *output_bin);
+const gchar * gtk_print_settings_get_printer (GtkPrintSettings *settings);
+void gtk_print_settings_set_printer (GtkPrintSettings *settings,
+ const gchar *printer);
+GtkPageOrientation gtk_print_settings_get_orientation (GtkPrintSettings *settings);
+void gtk_print_settings_set_orientation (GtkPrintSettings *settings,
+ GtkPageOrientation orientation);
+GtkPaperSize * gtk_print_settings_get_paper_size (GtkPrintSettings *settings);
+void gtk_print_settings_set_paper_size (GtkPrintSettings *settings,
+ GtkPaperSize *paper_size);
+gdouble gtk_print_settings_get_paper_width (GtkPrintSettings *settings,
+ GtkUnit unit);
+void gtk_print_settings_set_paper_width (GtkPrintSettings *settings,
+ gdouble width,
+ GtkUnit unit);
+gdouble gtk_print_settings_get_paper_height (GtkPrintSettings *settings,
+ GtkUnit unit);
+void gtk_print_settings_set_paper_height (GtkPrintSettings *settings,
+ gdouble height,
+ GtkUnit unit);
+gboolean gtk_print_settings_get_use_color (GtkPrintSettings *settings);
+void gtk_print_settings_set_use_color (GtkPrintSettings *settings,
+ gboolean use_color);
+gboolean gtk_print_settings_get_collate (GtkPrintSettings *settings);
+void gtk_print_settings_set_collate (GtkPrintSettings *settings,
+ gboolean collate);
+gboolean gtk_print_settings_get_reverse (GtkPrintSettings *settings);
+void gtk_print_settings_set_reverse (GtkPrintSettings *settings,
+ gboolean reverse);
+GtkPrintDuplex gtk_print_settings_get_duplex (GtkPrintSettings *settings);
+void gtk_print_settings_set_duplex (GtkPrintSettings *settings,
+ GtkPrintDuplex duplex);
+GtkPrintQuality gtk_print_settings_get_quality (GtkPrintSettings *settings);
+void gtk_print_settings_set_quality (GtkPrintSettings *settings,
+ GtkPrintQuality quality);
+gint gtk_print_settings_get_n_copies (GtkPrintSettings *settings);
+void gtk_print_settings_set_n_copies (GtkPrintSettings *settings,
+ gint num_copies);
+gint gtk_print_settings_get_number_up (GtkPrintSettings *settings);
+void gtk_print_settings_set_number_up (GtkPrintSettings *settings,
+ gint number_up);
+GtkNumberUpLayout gtk_print_settings_get_number_up_layout (GtkPrintSettings *settings);
+void gtk_print_settings_set_number_up_layout (GtkPrintSettings *settings,
+ GtkNumberUpLayout number_up_layout);
+gint gtk_print_settings_get_resolution (GtkPrintSettings *settings);
+void gtk_print_settings_set_resolution (GtkPrintSettings *settings,
+ gint resolution);
+gint gtk_print_settings_get_resolution_x (GtkPrintSettings *settings);
+gint gtk_print_settings_get_resolution_y (GtkPrintSettings *settings);
+void gtk_print_settings_set_resolution_xy (GtkPrintSettings *settings,
+ gint resolution_x,
+ gint resolution_y);
+gdouble gtk_print_settings_get_printer_lpi (GtkPrintSettings *settings);
+void gtk_print_settings_set_printer_lpi (GtkPrintSettings *settings,
+ gdouble lpi);
+gdouble gtk_print_settings_get_scale (GtkPrintSettings *settings);
+void gtk_print_settings_set_scale (GtkPrintSettings *settings,
+ gdouble scale);
+GtkPrintPages gtk_print_settings_get_print_pages (GtkPrintSettings *settings);
+void gtk_print_settings_set_print_pages (GtkPrintSettings *settings,
+ GtkPrintPages pages);
+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);
+GtkPageSet gtk_print_settings_get_page_set (GtkPrintSettings *settings);
+void gtk_print_settings_set_page_set (GtkPrintSettings *settings,
+ GtkPageSet page_set);
+const gchar * gtk_print_settings_get_default_source (GtkPrintSettings *settings);
+void gtk_print_settings_set_default_source (GtkPrintSettings *settings,
+ const gchar *default_source);
+const gchar * gtk_print_settings_get_media_type (GtkPrintSettings *settings);
+void gtk_print_settings_set_media_type (GtkPrintSettings *settings,
+ const gchar *media_type);
+const gchar * gtk_print_settings_get_dither (GtkPrintSettings *settings);
+void gtk_print_settings_set_dither (GtkPrintSettings *settings,
+ const gchar *dither);
+const gchar * gtk_print_settings_get_finishings (GtkPrintSettings *settings);
+void gtk_print_settings_set_finishings (GtkPrintSettings *settings,
+ const gchar *finishings);
+const gchar * gtk_print_settings_get_output_bin (GtkPrintSettings *settings);
+void gtk_print_settings_set_output_bin (GtkPrintSettings *settings,
+ const gchar *output_bin);
G_END_DECLS