gtkprintoperation.h 13.7 KB
Newer Older
Cody Russell's avatar
Cody Russell committed
1
/* GTK - The GIMP Toolkit
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
 * gtkprintoperation.h: Print Operation
 * Copyright (C) 2006, Red Hat, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * 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.
 */

21
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
22 23 24
#error "Only <gtk/gtk.h> can be included directly."
#endif

25 26 27
#ifndef __GTK_PRINT_OPERATION_H__
#define __GTK_PRINT_OPERATION_H__

28

29
#include <cairo.h>
30 31 32 33 34 35
#include <gtk/gtkmain.h>
#include <gtk/gtkwindow.h>
#include <gtk/gtkpagesetup.h>
#include <gtk/gtkprintsettings.h>
#include <gtk/gtkprintcontext.h>
#include <gtk/gtkprintoperationpreview.h>
36

37

38 39
G_BEGIN_DECLS

Matthias Clasen's avatar
Matthias Clasen committed
40 41 42 43 44 45
#define GTK_TYPE_PRINT_OPERATION                (gtk_print_operation_get_type ())
#define GTK_PRINT_OPERATION(obj)                (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_PRINT_OPERATION, GtkPrintOperation))
#define GTK_PRINT_OPERATION_CLASS(klass)        (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_PRINT_OPERATION, GtkPrintOperationClass))
#define GTK_IS_PRINT_OPERATION(obj)             (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_PRINT_OPERATION))
#define GTK_IS_PRINT_OPERATION_CLASS(klass)     (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_PRINT_OPERATION))
#define GTK_PRINT_OPERATION_GET_CLASS(obj)      (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_PRINT_OPERATION, GtkPrintOperationClass))
46 47 48 49 50

typedef struct _GtkPrintOperationClass   GtkPrintOperationClass;
typedef struct _GtkPrintOperationPrivate GtkPrintOperationPrivate;
typedef struct _GtkPrintOperation        GtkPrintOperation;

51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
/**
 * GtkPrintStatus:
 * @GTK_PRINT_STATUS_INITIAL: The printing has not started yet; this
 *     status is set initially, and while the print dialog is shown.
 * @GTK_PRINT_STATUS_PREPARING: This status is set while the begin-print
 *     signal is emitted and during pagination.
 * @GTK_PRINT_STATUS_GENERATING_DATA: This status is set while the
 *     pages are being rendered.
 * @GTK_PRINT_STATUS_SENDING_DATA: The print job is being sent off to the
 *     printer.
 * @GTK_PRINT_STATUS_PENDING: The print job has been sent to the printer,
 *     but is not printed for some reason, e.g. the printer may be stopped.
 * @GTK_PRINT_STATUS_PENDING_ISSUE: Some problem has occurred during
 *     printing, e.g. a paper jam.
 * @GTK_PRINT_STATUS_PRINTING: The printer is processing the print job.
 * @GTK_PRINT_STATUS_FINISHED: The printing has been completed successfully.
 * @GTK_PRINT_STATUS_FINISHED_ABORTED: The printing has been aborted.
 *
 * The status gives a rough indication of the completion of a running
 * print operation.
 */
72 73 74 75 76 77 78 79 80 81 82 83
typedef enum {
  GTK_PRINT_STATUS_INITIAL,
  GTK_PRINT_STATUS_PREPARING,
  GTK_PRINT_STATUS_GENERATING_DATA,
  GTK_PRINT_STATUS_SENDING_DATA,
  GTK_PRINT_STATUS_PENDING,
  GTK_PRINT_STATUS_PENDING_ISSUE,
  GTK_PRINT_STATUS_PRINTING,
  GTK_PRINT_STATUS_FINISHED,
  GTK_PRINT_STATUS_FINISHED_ABORTED
} GtkPrintStatus;

84 85 86 87 88 89 90 91 92 93 94
/**
 * GtkPrintOperationResult:
 * @GTK_PRINT_OPERATION_RESULT_ERROR: An error has occured.
 * @GTK_PRINT_OPERATION_RESULT_APPLY: The print settings should be stored.
 * @GTK_PRINT_OPERATION_RESULT_CANCEL: The print operation has been canceled,
 *     the print settings should not be stored.
 * @GTK_PRINT_OPERATION_RESULT_IN_PROGRESS: The print operation is not complete
 *     yet. This value will only be returned when running asynchronously.
 *
 * A value of this type is returned by gtk_print_operation_run().
 */
95 96 97 98 99 100 101
typedef enum {
  GTK_PRINT_OPERATION_RESULT_ERROR,
  GTK_PRINT_OPERATION_RESULT_APPLY,
  GTK_PRINT_OPERATION_RESULT_CANCEL,
  GTK_PRINT_OPERATION_RESULT_IN_PROGRESS
} GtkPrintOperationResult;

102 103 104 105 106 107 108 109 110 111 112 113
/**
 * GtkPrintOperationAction:
 * @GTK_PRINT_OPERATION_ACTION_PRINT_DIALOG: Show the print dialog.
 * @GTK_PRINT_OPERATION_ACTION_PRINT: Start to print without showing
 *     the print dialog, based on the current print settings.
 * @GTK_PRINT_OPERATION_ACTION_PREVIEW: Show the print preview.
 * @GTK_PRINT_OPERATION_ACTION_EXPORT: Export to a file. This requires
 *     the export-filename property to be set.
 *
 * The @action parameter to gtk_print_operation_run()
 * determines what action the print operation should perform.
 */
114 115 116 117
typedef enum {
  GTK_PRINT_OPERATION_ACTION_PRINT_DIALOG,
  GTK_PRINT_OPERATION_ACTION_PRINT,
  GTK_PRINT_OPERATION_ACTION_PREVIEW,
Matthias Clasen's avatar
Matthias Clasen committed
118
  GTK_PRINT_OPERATION_ACTION_EXPORT
119 120 121
} GtkPrintOperationAction;


122 123 124
struct _GtkPrintOperation
{
  GObject parent_instance;
125

126
  /*< private >*/
127
  GtkPrintOperationPrivate *priv;
128 129 130 131 132
};

struct _GtkPrintOperationClass
{
  GObjectClass parent_class;
133

134
  void     (*done)               (GtkPrintOperation *operation,
Matthias Clasen's avatar
Matthias Clasen committed
135
                                  GtkPrintOperationResult result);
136
  void     (*begin_print)        (GtkPrintOperation *operation,
Matthias Clasen's avatar
Matthias Clasen committed
137
                                  GtkPrintContext   *context);
138
  gboolean (*paginate)           (GtkPrintOperation *operation,
Matthias Clasen's avatar
Matthias Clasen committed
139
                                  GtkPrintContext   *context);
140
  void     (*request_page_setup) (GtkPrintOperation *operation,
Matthias Clasen's avatar
Matthias Clasen committed
141 142 143
                                  GtkPrintContext   *context,
                                  gint               page_nr,
                                  GtkPageSetup      *setup);
144
  void     (*draw_page)          (GtkPrintOperation *operation,
Matthias Clasen's avatar
Matthias Clasen committed
145 146
                                  GtkPrintContext   *context,
                                  gint               page_nr);
147
  void     (*end_print)          (GtkPrintOperation *operation,
Matthias Clasen's avatar
Matthias Clasen committed
148
                                  GtkPrintContext   *context);
149
  void     (*status_changed)     (GtkPrintOperation *operation);
150 151 152

  GtkWidget *(*create_custom_widget) (GtkPrintOperation *operation);
  void       (*custom_widget_apply)  (GtkPrintOperation *operation,
Matthias Clasen's avatar
Matthias Clasen committed
153
                                      GtkWidget         *widget);
154

Matthias Clasen's avatar
Matthias Clasen committed
155 156 157 158
  gboolean (*preview)        (GtkPrintOperation        *operation,
                              GtkPrintOperationPreview *preview,
                              GtkPrintContext          *context,
                              GtkWindow                *parent);
159

160 161 162 163 164
  void     (*update_custom_widget) (GtkPrintOperation *operation,
                                    GtkWidget         *widget,
                                    GtkPageSetup      *setup,
                                    GtkPrintSettings  *settings);

165 166 167 168 169 170 171
  /* Padding for future expansion */
  void (*_gtk_reserved1) (void);
  void (*_gtk_reserved2) (void);
  void (*_gtk_reserved3) (void);
  void (*_gtk_reserved4) (void);
  void (*_gtk_reserved5) (void);
  void (*_gtk_reserved6) (void);
172 173
  void (*_gtk_reserved7) (void);
  void (*_gtk_reserved8) (void);
174 175
};

176 177 178 179 180
/**
 * GTK_PRINT_ERROR:
 *
 * The error domain for #GtkPrintError errors.
 */
181 182
#define GTK_PRINT_ERROR gtk_print_error_quark ()

183 184 185 186 187 188 189 190 191 192 193
/**
 * GtkPrintError:
 * @GTK_PRINT_ERROR_GENERAL: An unspecified error occurred.
 * @GTK_PRINT_ERROR_INTERNAL_ERROR: An internal error occurred.
 * @GTK_PRINT_ERROR_NOMEM: A memory allocation failed.
 * @GTK_PRINT_ERROR_INVALID_FILE: An error occurred while loading a page setup
 *     or paper size from a key file.
 *
 * Error codes that identify various errors that can occur while
 * using the GTK+ printing support.
 */
194 195 196 197
typedef enum
{
  GTK_PRINT_ERROR_GENERAL,
  GTK_PRINT_ERROR_INTERNAL_ERROR,
Matthias Clasen's avatar
Matthias Clasen committed
198 199
  GTK_PRINT_ERROR_NOMEM,
  GTK_PRINT_ERROR_INVALID_FILE
200 201 202 203 204 205 206
} GtkPrintError;

GQuark gtk_print_error_quark (void);

GType                   gtk_print_operation_get_type               (void) G_GNUC_CONST;
GtkPrintOperation *     gtk_print_operation_new                    (void);
void                    gtk_print_operation_set_default_page_setup (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
207
                                                                    GtkPageSetup       *default_page_setup);
208 209
GtkPageSetup *          gtk_print_operation_get_default_page_setup (GtkPrintOperation  *op);
void                    gtk_print_operation_set_print_settings     (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
210
                                                                    GtkPrintSettings   *print_settings);
211 212
GtkPrintSettings *      gtk_print_operation_get_print_settings     (GtkPrintOperation  *op);
void                    gtk_print_operation_set_job_name           (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
213
                                                                    const gchar        *job_name);
Alexander Larsson's avatar
Alexander Larsson committed
214
void                    gtk_print_operation_set_n_pages            (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
215
                                                                    gint                n_pages);
216
void                    gtk_print_operation_set_current_page       (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
217
                                                                    gint                current_page);
218
void                    gtk_print_operation_set_use_full_page      (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
219
                                                                    gboolean            full_page);
220
void                    gtk_print_operation_set_unit               (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
221
                                                                    GtkUnit             unit);
222
void                    gtk_print_operation_set_export_filename    (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
223
                                                                    const gchar        *filename);
224
void                    gtk_print_operation_set_track_print_status (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
225
                                                                    gboolean            track_status);
226
void                    gtk_print_operation_set_show_progress      (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
227
                                                                    gboolean            show_progress);
228
void                    gtk_print_operation_set_allow_async        (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
229
                                                                    gboolean            allow_async);
Matthias Clasen's avatar
Matthias Clasen committed
230
void                    gtk_print_operation_set_custom_tab_label   (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
231
                                                                    const gchar        *label);
232
GtkPrintOperationResult gtk_print_operation_run                    (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
233 234 235
                                                                    GtkPrintOperationAction action,
                                                                    GtkWindow          *parent,
                                                                    GError            **error);
236
void                    gtk_print_operation_get_error              (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
237
                                                                    GError            **error);
238
GtkPrintStatus          gtk_print_operation_get_status             (GtkPrintOperation  *op);
239
const gchar *           gtk_print_operation_get_status_string      (GtkPrintOperation  *op);
240
gboolean                gtk_print_operation_is_finished            (GtkPrintOperation  *op);
241
void                    gtk_print_operation_cancel                 (GtkPrintOperation  *op);
242 243
void                    gtk_print_operation_draw_page_finish       (GtkPrintOperation  *op);
void                    gtk_print_operation_set_defer_drawing      (GtkPrintOperation  *op);
244 245 246 247 248 249
void                    gtk_print_operation_set_support_selection  (GtkPrintOperation  *op,
                                                                    gboolean            support_selection);
gboolean                gtk_print_operation_get_support_selection  (GtkPrintOperation  *op);
void                    gtk_print_operation_set_has_selection      (GtkPrintOperation  *op,
                                                                    gboolean            has_selection);
gboolean                gtk_print_operation_get_has_selection      (GtkPrintOperation  *op);
250
void                    gtk_print_operation_set_embed_page_setup   (GtkPrintOperation  *op,
Matthias Clasen's avatar
Matthias Clasen committed
251
                                                                    gboolean            embed);
252
gboolean                gtk_print_operation_get_embed_page_setup   (GtkPrintOperation  *op);
253
gint                    gtk_print_operation_get_n_pages_to_print   (GtkPrintOperation  *op);
254 255

GtkPageSetup           *gtk_print_run_page_setup_dialog            (GtkWindow          *parent,
Matthias Clasen's avatar
Matthias Clasen committed
256 257
                                                                    GtkPageSetup       *page_setup,
                                                                    GtkPrintSettings   *settings);
258

259 260 261
/**
 * GtkPageSetupDoneFunc:
 * @page_setup: the #GtkPageSetup that has been
Matthias Clasen's avatar
Matthias Clasen committed
262 263
 * @data: (closure): user data that has been passed to
 *     gtk_print_run_page_setup_dialog_async()
264 265
 *
 * The type of function that is passed to
Matthias Clasen's avatar
Matthias Clasen committed
266 267 268 269
 * gtk_print_run_page_setup_dialog_async().
 *
 * This function will be called when the page setup dialog
 * is dismissed, and also serves as destroy notify for @data.
270
 */
271
typedef void  (* GtkPageSetupDoneFunc) (GtkPageSetup *page_setup,
Matthias Clasen's avatar
Matthias Clasen committed
272
                                        gpointer      data);
Matthias Clasen's avatar
Matthias Clasen committed
273 274

void                    gtk_print_run_page_setup_dialog_async      (GtkWindow            *parent,
Matthias Clasen's avatar
Matthias Clasen committed
275 276
                                                                    GtkPageSetup         *page_setup,
                                                                    GtkPrintSettings     *settings,
Matthias Clasen's avatar
Matthias Clasen committed
277 278 279
                                                                    GtkPageSetupDoneFunc  done_cb,
                                                                    gpointer              data);

280 281 282
G_END_DECLS

#endif /* __GTK_PRINT_OPERATION_H__ */