summaryrefslogtreecommitdiff
path: root/gtk/gtkprinter.c
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2007-04-29 04:42:13 +0000
committerMatthias Clasen <matthiasc@src.gnome.org>2007-04-29 04:42:13 +0000
commitbcbbbe51014219d72afff61cd20aa28ced37947d (patch)
tree319b81c3d9c89bd461c26632077d0467fc24f33a /gtk/gtkprinter.c
parent6c1d4a2104e0060d96b8673364df7fc4152724d3 (diff)
downloadgtk+-bcbbbe51014219d72afff61cd20aa28ced37947d.tar.gz
Make gtk_printer_has_details() and gtk_printer_request_details() public.
2007-04-29 Matthias Clasen <mclasen@redhat.com> * gtk/gtk.symbols: * gtk/gtkprinter-private.h: * gtk/gtkprinter.[hc]: Make gtk_printer_has_details() and gtk_printer_request_details() public. * gtk/gtkpagesetupunixdialog.c: * gtk/gtkprintunixdialog.c: Update callers. (#389203, Christian Persch) svn path=/trunk/; revision=17690
Diffstat (limited to 'gtk/gtkprinter.c')
-rw-r--r--gtk/gtkprinter.c35
1 files changed, 31 insertions, 4 deletions
diff --git a/gtk/gtkprinter.c b/gtk/gtkprinter.c
index b8200b8c10..7de8ada7f3 100644
--- a/gtk/gtkprinter.c
+++ b/gtk/gtkprinter.c
@@ -582,9 +582,21 @@ gtk_printer_set_job_count (GtkPrinter *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;
}
@@ -727,10 +739,23 @@ gtk_printer_set_is_default (GtkPrinter *printer,
printer->priv->is_default = TRUE;
}
+/**
+ * gtk_printer_request_details:
+ * @printer: a #GtkPrinter
+ *
+ * Requests the printer details. When the details are available,
+ * the "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);
}
@@ -788,7 +813,9 @@ _gtk_printer_create_cairo_surface (GtkPrinter *printer,
* gtk_printer_list_papers:
* @printer:
*
- * Lists all the page sizes @printer supports.
+ * 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.
*