X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkprinter.h;h=595db5230513b0855da7bce70315911b1883220a;hb=cc0be1f949020de1562534fbc31ddf0af4651fe2;hp=e19224246192ee31b8e6a6693db897d3182549a4;hpb=c9b24c88173d5cf0404ac4f76d5e9115e8cbbb36;p=~andy%2Fgtk diff --git a/gtk/gtkprinter.h b/gtk/gtkprinter.h index e19224246..595db5230 100644 --- a/gtk/gtkprinter.h +++ b/gtk/gtkprinter.h @@ -17,15 +17,13 @@ * Boston, MA 02111-1307, USA. */ -#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_UNIX_PRINT_H_INSIDE__) && !defined (GTK_COMPILATION) +#if !defined (__GTK_UNIX_PRINT_H_INSIDE__) && !defined (GTK_COMPILATION) #error "Only can be included directly." #endif #ifndef __GTK_PRINTER_H__ #define __GTK_PRINTER_H__ -#include -#include #include #include @@ -36,17 +34,40 @@ G_BEGIN_DECLS /* Note, this type is manually registered with GObject in gtkprinter.c * If you add any flags, update the registration as well! */ +/** + * GtkPrintCapabilities: + * @GTK_PRINT_CAPABILITY_PAGE_SET: Print dialog will offer printing even/odd pages. + * @GTK_PRINT_CAPABILITY_COPIES: Print dialog will allow to print multiple copies. + * @GTK_PRINT_CAPABILITY_COLLATE: Print dialog will allow to collate multiple copies. + * @GTK_PRINT_CAPABILITY_REVERSE: Print dialog will allow to print pages in reverse order. + * @GTK_PRINT_CAPABILITY_SCALE: Print dialog will allow to scale the output. + * @GTK_PRINT_CAPABILITY_GENERATE_PDF: The program will send the document to + * the printer in PDF format + * @GTK_PRINT_CAPABILITY_GENERATE_PS: The program will send the document to + * the printer in Postscript format + * @GTK_PRINT_CAPABILITY_PREVIEW: Print dialog will offer a preview + * @GTK_PRINT_CAPABILITY_NUMBER_UP: Print dialog will offer printing multiple + * pages per sheet. Since 2.12 + * @GTK_PRINT_CAPABILITY_NUMBER_UP_LAYOUT: Print dialog will allow to rearrange + * pages when printing multiple pages per sheet. Since 2.14 + * + * An enum for specifying which features the print dialog should offer. + * If neither %GTK_PRINT_CAPABILITY_GENERATE_PDF nor + * %GTK_PRINT_CAPABILITY_GENERATE_PS is specified, GTK+ assumes that all + * formats are supported. + */ typedef enum { - GTK_PRINT_CAPABILITY_PAGE_SET = 1 << 0, - GTK_PRINT_CAPABILITY_COPIES = 1 << 1, - GTK_PRINT_CAPABILITY_COLLATE = 1 << 2, - GTK_PRINT_CAPABILITY_REVERSE = 1 << 3, - GTK_PRINT_CAPABILITY_SCALE = 1 << 4, - GTK_PRINT_CAPABILITY_GENERATE_PDF = 1 << 5, - GTK_PRINT_CAPABILITY_GENERATE_PS = 1 << 6, - GTK_PRINT_CAPABILITY_PREVIEW = 1 << 7, - GTK_PRINT_CAPABILITY_NUMBER_UP = 1 << 8 + GTK_PRINT_CAPABILITY_PAGE_SET = 1 << 0, + GTK_PRINT_CAPABILITY_COPIES = 1 << 1, + GTK_PRINT_CAPABILITY_COLLATE = 1 << 2, + GTK_PRINT_CAPABILITY_REVERSE = 1 << 3, + GTK_PRINT_CAPABILITY_SCALE = 1 << 4, + GTK_PRINT_CAPABILITY_GENERATE_PDF = 1 << 5, + GTK_PRINT_CAPABILITY_GENERATE_PS = 1 << 6, + GTK_PRINT_CAPABILITY_PREVIEW = 1 << 7, + GTK_PRINT_CAPABILITY_NUMBER_UP = 1 << 8, + GTK_PRINT_CAPABILITY_NUMBER_UP_LAYOUT = 1 << 9 } GtkPrintCapabilities; GType gtk_print_capabilities_get_type (void) G_GNUC_CONST; @@ -69,7 +90,8 @@ struct _GtkPrinter { GObject parent_instance; - GtkPrinterPrivate *GSEAL (priv); + /*< private >*/ + GtkPrinterPrivate *priv; }; struct _GtkPrinterClass @@ -87,6 +109,7 @@ struct _GtkPrinterClass void (*_gtk_reserved5) (void); void (*_gtk_reserved6) (void); void (*_gtk_reserved7) (void); + void (*_gtk_reserved8) (void); }; GType gtk_printer_get_type (void) G_GNUC_CONST; @@ -94,13 +117,15 @@ GtkPrinter *gtk_printer_new (const gchar *nam GtkPrintBackend *backend, gboolean virtual_); GtkPrintBackend *gtk_printer_get_backend (GtkPrinter *printer); -G_CONST_RETURN gchar *gtk_printer_get_name (GtkPrinter *printer); -G_CONST_RETURN gchar *gtk_printer_get_state_message (GtkPrinter *printer); -G_CONST_RETURN gchar *gtk_printer_get_description (GtkPrinter *printer); -G_CONST_RETURN gchar *gtk_printer_get_location (GtkPrinter *printer); -G_CONST_RETURN gchar *gtk_printer_get_icon_name (GtkPrinter *printer); +const gchar * gtk_printer_get_name (GtkPrinter *printer); +const gchar * gtk_printer_get_state_message (GtkPrinter *printer); +const gchar * gtk_printer_get_description (GtkPrinter *printer); +const gchar * gtk_printer_get_location (GtkPrinter *printer); +const gchar * gtk_printer_get_icon_name (GtkPrinter *printer); gint gtk_printer_get_job_count (GtkPrinter *printer); gboolean gtk_printer_is_active (GtkPrinter *printer); +gboolean gtk_printer_is_paused (GtkPrinter *printer); +gboolean gtk_printer_is_accepting_jobs (GtkPrinter *printer); gboolean gtk_printer_is_virtual (GtkPrinter *printer); gboolean gtk_printer_is_default (GtkPrinter *printer); gboolean gtk_printer_accepts_pdf (GtkPrinter *printer); @@ -112,7 +137,25 @@ gint gtk_printer_compare (GtkPrinter *a, gboolean gtk_printer_has_details (GtkPrinter *printer); void gtk_printer_request_details (GtkPrinter *printer); GtkPrintCapabilities gtk_printer_get_capabilities (GtkPrinter *printer); - +gboolean gtk_printer_get_hard_margins (GtkPrinter *printer, + gdouble *top, + gdouble *bottom, + gdouble *left, + gdouble *right); + +/** + * GtkPrinterFunc: + * @printer: a #GtkPrinter + * @data: (closure): user data passed to gtk_enumerate_printers() + * + * The type of function passed to gtk_enumerate_printers(). + * Note that you need to ref @printer, if you want to keep + * a reference to it after the function has returned. + * + * Returns: %TRUE to stop the enumeration, %FALSE to continue + * + * Since: 2.10 + */ typedef gboolean (*GtkPrinterFunc) (GtkPrinter *printer, gpointer data);