g_param_spec_string ("name",
P_("Name"),
P_("Name of the printer"),
- NULL,
+ "",
GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY));
g_object_class_install_property (G_OBJECT_CLASS (class),
PROP_BACKEND,
g_param_spec_string ("state-message",
P_("State Message"),
P_("String giving the current state of the printer"),
- NULL,
+ "",
GTK_PARAM_READABLE));
g_object_class_install_property (G_OBJECT_CLASS (class),
PROP_LOCATION,
g_param_spec_string ("location",
P_("Location"),
P_("The location of the printer"),
- NULL,
+ "",
GTK_PARAM_READABLE));
g_object_class_install_property (G_OBJECT_CLASS (class),
PROP_ICON_NAME,
g_param_spec_string ("icon-name",
P_("Icon Name"),
P_("The icon name to use for the printer"),
- NULL,
+ "",
GTK_PARAM_READABLE));
g_object_class_install_property (G_OBJECT_CLASS (class),
PROP_JOB_COUNT,
if (priv->name)
g_value_set_string (value, priv->name);
else
- g_value_set_string (value, "");
+ g_value_set_static_string (value, "");
break;
case PROP_BACKEND:
g_value_set_object (value, priv->backend);
if (priv->state_message)
g_value_set_string (value, priv->state_message);
else
- g_value_set_string (value, "");
+ g_value_set_static_string (value, "");
break;
case PROP_LOCATION:
if (priv->location)
g_value_set_string (value, priv->location);
else
- g_value_set_string (value, "");
+ g_value_set_static_string (value, "");
break;
case PROP_ICON_NAME:
if (priv->icon_name)
g_value_set_string (value, priv->icon_name);
else
- g_value_set_string (value, "");
+ g_value_set_static_string (value, "");
break;
case PROP_JOB_COUNT:
g_value_set_int (value, priv->job_count);
* gtk_printer_get_location:
* @printer: a #GtkPrinter
*
- * Returns a description of the location of the printer.
+ * Returns a description of the location of the printer.
*
* Return value: the location of @printer
*
return TRUE;
}
+/**
+ * gtk_printer_has_details:
+ * @printer: a #GtkPrinter
+ *
+ * Returns whether the printer details are available.
+ *
+ * Return value: %TRUE if @printer details are available
+ *
+ * Since: 2.12
+ */
gboolean
-_gtk_printer_has_details (GtkPrinter *printer)
+gtk_printer_has_details (GtkPrinter *printer)
{
+ g_return_val_if_fail (GTK_IS_PRINTER (printer), FALSE);
+
return printer->priv->has_details;
}
return printer->priv->is_virtual;
}
+/**
+ * gtk_printer_accepts_pdf:
+ * @printer: a #GtkPrinter
+ *
+ * Returns whether the printer accepts input in
+ * PDF format.
+ *
+ * Return value: %TRUE if @printer accepts PDF
+ *
+ * Since: 2.10
+ */
gboolean
gtk_printer_accepts_pdf (GtkPrinter *printer)
{
return printer->priv->accepts_pdf;
}
+/**
+ * gtk_printer_accepts_ps:
+ * @printer: a #GtkPrinter
+ *
+ * Returns whether the printer accepts input in
+ * PostScript format.
+ *
+ * Return value: %TRUE if @printer accepts PostScript
+ *
+ * Since: 2.10
+ */
gboolean
gtk_printer_accepts_ps (GtkPrinter *printer)
{
printer->priv->is_default = TRUE;
}
+/**
+ * gtk_printer_request_details:
+ * @printer: a #GtkPrinter
+ *
+ * Requests the printer details. When the details are available,
+ * the #GtkPrinter::details-acquired signal will be emitted on @printer.
+ *
+ * Since: 2.12
+ */
void
-_gtk_printer_request_details (GtkPrinter *printer)
+gtk_printer_request_details (GtkPrinter *printer)
{
- GtkPrintBackendClass *backend_class = GTK_PRINT_BACKEND_GET_CLASS (printer->priv->backend);
+ GtkPrintBackendClass *backend_class;
+
+ g_return_if_fail (GTK_IS_PRINTER (printer));
+
+ backend_class = GTK_PRINT_BACKEND_GET_CLASS (printer->priv->backend);
backend_class->printer_request_details (printer);
}
GtkPrintSettings *settings,
gdouble width,
gdouble height,
- gint cache_fd)
+ GIOChannel *cache_io)
{
GtkPrintBackendClass *backend_class = GTK_PRINT_BACKEND_GET_CLASS (printer->priv->backend);
return backend_class->printer_create_cairo_surface (printer, settings,
- width, height, cache_fd);
+ width, height, cache_io);
}
+/**
+ * gtk_printer_list_papers:
+ * @printer: a #GtkPrinter
+ *
+ * Lists all the paper sizes @printer supports.
+ * This will return and empty list unless the printer's details are
+ * available, see gtk_printer_has_details() and gtk_printer_request_details().
+ *
+ * Return value: a newly allocated list of newly allocated #GtkPageSetup s.
+ *
+ * Since: 2.12
+ */
GList *
-_gtk_printer_list_papers (GtkPrinter *printer)
+gtk_printer_list_papers (GtkPrinter *printer)
{
- GtkPrintBackendClass *backend_class = GTK_PRINT_BACKEND_GET_CLASS (printer->priv->backend);
+ GtkPrintBackendClass *backend_class;
+ g_return_val_if_fail (GTK_IS_PRINTER (printer), NULL);
+
+ backend_class = GTK_PRINT_BACKEND_GET_CLASS (printer->priv->backend);
return backend_class->printer_list_papers (printer);
}
backend_class->printer_get_hard_margins (printer, top, bottom, left, right);
}
+/**
+ * gtk_printer_get_capabilities:
+ * @printer: a #GtkPrinter
+ *
+ * Returns the printer's capabilities.
+ *
+ * This is useful when you're using #GtkPrintUnixDialog's manual-capabilities
+ * setting and need to know which settings the printer can handle and which
+ * you must handle yourself.
+ *
+ * This will return 0 unless the printer's details are available, see
+ * gtk_printer_has_details() and gtk_printer_request_details().
+ * *
+ * Return value: the printer's capabilities
+ *
+ * Since: 2.12
+ */
GtkPrintCapabilities
-_gtk_printer_get_capabilities (GtkPrinter *printer)
+gtk_printer_get_capabilities (GtkPrinter *printer)
{
- GtkPrintBackendClass *backend_class = GTK_PRINT_BACKEND_GET_CLASS (printer->priv->backend);
+ GtkPrintBackendClass *backend_class;
+
+ g_return_val_if_fail (GTK_IS_PRINTER (printer), 0);
+ backend_class = GTK_PRINT_BACKEND_GET_CLASS (printer->priv->backend);
return backend_class->printer_get_capabilities (printer);
}
+/**
+ * gtk_printer_compare:
+ * @a: a #GtkPrinter
+ * @b: another #GtkPrinter
+ *
+ * Compares two printers.
+ *
+ * Return value: 0 if the printer match, a negative value if @a < @b,
+ * or a positive value if @a > @b
+ *
+ * Since: 2.10
+ */
gint
-gtk_printer_compare (GtkPrinter *a, GtkPrinter *b)
+gtk_printer_compare (GtkPrinter *a,
+ GtkPrinter *b)
{
const char *name_a, *name_b;
return g_ascii_strcasecmp (name_a, name_b);
}
+
+typedef struct
+{
+ GList *backends;
+ GtkPrinterFunc func;
+ gpointer data;
+ GDestroyNotify destroy;
+ GMainLoop *loop;
+} PrinterList;
+
+static void list_done_cb (GtkPrintBackend *backend,
+ PrinterList *printer_list);
+
+static void
+stop_enumeration (PrinterList *printer_list)
+{
+ GList *list, *next;
+ GtkPrintBackend *backend;
+
+ for (list = printer_list->backends; list; list = next)
+ {
+ next = list->next;
+ backend = GTK_PRINT_BACKEND (list->data);
+ list_done_cb (backend, printer_list);
+ }
+}
+
+static void
+free_printer_list (PrinterList *printer_list)
+{
+ if (printer_list->destroy)
+ printer_list->destroy (printer_list->data);
+
+ if (printer_list->loop)
+ {
+ g_main_loop_quit (printer_list->loop);
+ g_main_loop_unref (printer_list->loop);
+ }
+
+ g_free (printer_list);
+}
+
+static gboolean
+list_added_cb (GtkPrintBackend *backend,
+ GtkPrinter *printer,
+ PrinterList *printer_list)
+{
+ if (printer_list->func (printer, printer_list->data))
+ {
+ stop_enumeration (printer_list);
+ return TRUE;
+ }
+
+ return FALSE;
+}
+
+static void
+list_done_cb (GtkPrintBackend *backend,
+ PrinterList *printer_list)
+{
+ printer_list->backends = g_list_remove (printer_list->backends, backend);
+
+ g_signal_handlers_disconnect_by_func (backend, list_added_cb, printer_list);
+ g_signal_handlers_disconnect_by_func (backend, list_done_cb, printer_list);
+
+ gtk_print_backend_destroy (backend);
+ g_object_unref (backend);
+
+ if (printer_list->backends == NULL)
+ free_printer_list (printer_list);
+}
+
+static gboolean
+list_printers_init (PrinterList *printer_list,
+ GtkPrintBackend *backend)
+{
+ GList *list, *node;
+
+ list = gtk_print_backend_get_printer_list (backend);
+
+ for (node = list; node != NULL; node = node->next)
+ {
+ if (list_added_cb (backend, node->data, printer_list))
+ {
+ g_list_free (list);
+ return TRUE;
+ }
+ }
+
+ g_list_free (list);
+
+ if (gtk_print_backend_printer_list_is_done (backend))
+ {
+ printer_list->backends = g_list_remove (printer_list->backends, backend);
+ gtk_print_backend_destroy (backend);
+ g_object_unref (backend);
+ }
+ else
+ {
+ g_signal_connect (backend, "printer-added",
+ (GCallback) list_added_cb,
+ printer_list);
+ g_signal_connect (backend, "printer-list-done",
+ (GCallback) list_done_cb,
+ printer_list);
+ }
+
+ return FALSE;
+}
+
+/**
+ * gtk_enumerate_printers:
+ * @func: a function to call for each printer
+ * @data: user data to pass to @func
+ * @destroy: function to call if @data is no longer needed
+ * @wait: if %TRUE, wait in a recursive mainloop until
+ * all printers are enumerated; otherwise return early
+ *
+ * Calls a function for all #GtkPrinter<!-- -->s.
+ * If @func returns %TRUE, the enumeration is stopped.
+ *
+ * Since: 2.10
+ */
+void
+gtk_enumerate_printers (GtkPrinterFunc func,
+ gpointer data,
+ GDestroyNotify destroy,
+ gboolean wait)
+{
+ PrinterList *printer_list;
+ GList *node, *next;
+ GtkPrintBackend *backend;
+
+ printer_list = g_new0 (PrinterList, 1);
+
+ printer_list->func = func;
+ printer_list->data = data;
+ printer_list->destroy = destroy;
+
+ if (g_module_supported ())
+ printer_list->backends = gtk_print_backend_load_modules ();
+
+ if (printer_list->backends == NULL)
+ {
+ free_printer_list (printer_list);
+ return;
+ }
+
+ for (node = printer_list->backends; node != NULL; node = next)
+ {
+ next = node->next;
+ backend = GTK_PRINT_BACKEND (node->data);
+ if (list_printers_init (printer_list, backend))
+ return;
+ }
+
+ if (wait && printer_list->backends)
+ {
+ printer_list->loop = g_main_loop_new (NULL, FALSE);
+
+ GDK_THREADS_LEAVE ();
+ g_main_loop_run (printer_list->loop);
+ GDK_THREADS_ENTER ();
+ }
+}
+
+GType
+gtk_print_capabilities_get_type (void)
+{
+ static GType etype = 0;
+
+ if (G_UNLIKELY (etype == 0))
+ {
+ static const GFlagsValue values[] = {
+ { GTK_PRINT_CAPABILITY_PAGE_SET, "GTK_PRINT_CAPABILITY_PAGE_SET", "page-set" },
+ { GTK_PRINT_CAPABILITY_COPIES, "GTK_PRINT_CAPABILITY_COPIES", "copies" },
+ { GTK_PRINT_CAPABILITY_COLLATE, "GTK_PRINT_CAPABILITY_COLLATE", "collate" },
+ { GTK_PRINT_CAPABILITY_REVERSE, "GTK_PRINT_CAPABILITY_REVERSE", "reverse" },
+ { GTK_PRINT_CAPABILITY_SCALE, "GTK_PRINT_CAPABILITY_SCALE", "scale" },
+ { GTK_PRINT_CAPABILITY_GENERATE_PDF, "GTK_PRINT_CAPABILITY_GENERATE_PDF", "generate-pdf" },
+ { GTK_PRINT_CAPABILITY_GENERATE_PS, "GTK_PRINT_CAPABILITY_GENERATE_PS", "generate-ps" },
+ { GTK_PRINT_CAPABILITY_PREVIEW, "GTK_PRINT_CAPABILITY_PREVIEW", "preview" },
+ { GTK_PRINT_CAPABILITY_NUMBER_UP, "GTK_PRINT_CAPABILITY_NUMBER_UP", "number-up"},
+ { 0, NULL, NULL }
+ };
+
+ etype = g_flags_register_static (I_("GtkPrintCapabilities"), values);
+ }
+
+ return etype;
+}
+
+
#define __GTK_PRINTER_C__
#include "gtkaliasdef.c"