]> Pileus Git - ~andy/gtk/blob - gtk/gtkprinteroption.h
Merge the gtk-printing branch. For more detailed ChangeLog entries, see
[~andy/gtk] / gtk / gtkprinteroption.h
1 /* GTK - The GIMP Toolkit
2  * gtkprinteroption.h: printer option
3  * Copyright (C) 2006, Red Hat, Inc.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with this library; if not, write to the
17  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18  * Boston, MA 02111-1307, USA.
19  */
20
21 #ifndef __GTK_PRINTER_OPTION_H__
22 #define __GTK_PRINTER_OPTION_H__
23
24 /* This is a "semi-private" header; it is meant only for
25  * alternate GtkPrintDialog backend modules; no stability guarantees 
26  * are made at this point
27  */
28 #ifndef GTK_PRINT_BACKEND_ENABLE_UNSUPPORTED
29 #error "GtkPrintBackend is not supported API for general use"
30 #endif
31
32 #include <glib-object.h>
33
34 G_BEGIN_DECLS
35
36 #define GTK_TYPE_PRINTER_OPTION             (gtk_printer_option_get_type ())
37 #define GTK_PRINTER_OPTION(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_PRINTER_OPTION, GtkPrinterOption))
38 #define GTK_IS_PRINTER_OPTION(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_PRINTER_OPTION))
39
40 typedef struct _GtkPrinterOption       GtkPrinterOption;
41 typedef struct _GtkPrinterOptionClass  GtkPrinterOptionClass;
42
43 #define GTK_PRINTER_OPTION_GROUP_IMAGE_QUALITY "ImageQuality"
44 #define GTK_PRINTER_OPTION_GROUP_FINISHING "Finishing"
45
46 typedef enum {
47   GTK_PRINTER_OPTION_TYPE_BOOLEAN,
48   GTK_PRINTER_OPTION_TYPE_PICKONE,
49   GTK_PRINTER_OPTION_TYPE_STRING,
50   GTK_PRINTER_OPTION_TYPE_FILESAVE
51 } GtkPrinterOptionType;
52
53 struct _GtkPrinterOption
54 {
55   GObject parent_instance;
56
57   char *name;
58   char *display_text;
59   GtkPrinterOptionType type;
60
61   char *value;
62   
63   int num_choices;
64   char **choices;
65   char **choices_display;
66   
67   gboolean has_conflict;
68   char *group;
69 };
70
71 struct _GtkPrinterOptionClass
72 {
73   GObjectClass parent_class;
74
75   void (*changed) (GtkPrinterOption *option);
76
77   /* Padding for future expansion */
78   void (*_gtk_reserved1) (void);
79   void (*_gtk_reserved2) (void);
80   void (*_gtk_reserved3) (void);
81   void (*_gtk_reserved4) (void);
82   void (*_gtk_reserved5) (void);
83   void (*_gtk_reserved6) (void);
84   void (*_gtk_reserved7) (void);
85 };
86
87 GType   gtk_printer_option_get_type       (void) G_GNUC_CONST;
88
89 GtkPrinterOption *gtk_printer_option_new                (const char           *name,
90                                                          const char           *display_text,
91                                                          GtkPrinterOptionType  type);
92 void              gtk_printer_option_set                (GtkPrinterOption     *option,
93                                                          const char           *value);
94 void              gtk_printer_option_set_has_conflict   (GtkPrinterOption     *option,
95                                                          gboolean              has_conflict);
96 void              gtk_printer_option_clear_has_conflict (GtkPrinterOption     *option);
97 void              gtk_printer_option_set_boolean        (GtkPrinterOption     *option,
98                                                          gboolean              value);
99 void              gtk_printer_option_allocate_choices   (GtkPrinterOption     *option,
100                                                          int                   num);
101 void              gtk_printer_option_choices_from_array (GtkPrinterOption     *option,
102                                                          int                   num_choices,
103                                                          char                 *choices[],
104                                                          char                 *choices_display[]);
105 gboolean          gtk_printer_option_has_choice         (GtkPrinterOption     *option,
106                                                          const char           *choice);
107
108
109 G_END_DECLS
110
111 #endif /* __GTK_PRINTER_OPTION_H__ */
112
113