svn path=/trunk/; revision=22006
+2008-12-30 Matthias Clasen <mclasen@redhat.com>
+
+ * gtk/gtkprintoperationpreview.c: Doc additions
+
2008-12-29 Matthias Clasen <mclasen@redhat.com>
2008-12-29 Matthias Clasen <mclasen@redhat.com>
* gtk/gtklabel.c:
* gtk/gtkentry.c:
* gtk/gtktextview.c:
* gtk/gtklabel.c:
* gtk/gtkentry.c:
* gtk/gtktextview.c:
+ /**
+ * GtkPrintOperationPreview::ready:
+ * @preview: the object on which the signal is emitted
+ * @context: the current #GtkPrintContext
+ *
+ * The ::ready signal gets emitted once per preview operation,
+ * before the first page is rendered.
+ *
+ * A handler for this signal can be used for setup tasks.
+ */
g_signal_new (I_("ready"),
GTK_TYPE_PRINT_OPERATION_PREVIEW,
G_SIGNAL_RUN_LAST,
g_signal_new (I_("ready"),
GTK_TYPE_PRINT_OPERATION_PREVIEW,
G_SIGNAL_RUN_LAST,
G_TYPE_NONE, 1,
GTK_TYPE_PRINT_CONTEXT);
G_TYPE_NONE, 1,
GTK_TYPE_PRINT_CONTEXT);
+ /**
+ * GtkPrintOperationPreview::got-page-size:
+ * @preview: the object on which the signal is emitted
+ * @context: the current #GtkPrintContext
+ * @page_setup: the #GtkPageSetup for the current page
+ *
+ * The ::got-page-size signal is emitted once for each page
+ * that gets rendered to the preview.
+ *
+ * A handler for this signal should update the @context
+ * according to @page_setup and set up a suitable cairo
+ * context, using gtk_print_context_set_cairo_context().
+ */
g_signal_new (I_("got-page-size"),
GTK_TYPE_PRINT_OPERATION_PREVIEW,
G_SIGNAL_RUN_LAST,
g_signal_new (I_("got-page-size"),
GTK_TYPE_PRINT_OPERATION_PREVIEW,
G_SIGNAL_RUN_LAST,
* was passed to the #GtkPrintOperation::preview handler together
* with @preview.
*
* was passed to the #GtkPrintOperation::preview handler together
* with @preview.
*
+ * A custom iprint preview should use this function in its ::expose
+ * handler to render the currently selected page.
+ *
* Note that this function requires a suitable cairo context to
* be associated with the print context.
*
* Note that this function requires a suitable cairo context to
* be associated with the print context.
*