gtk.print_context
Module for [PrintContext] class
Types 3
A GtkPrintContext encapsulates context information that is required when drawing pages for printing, such as the cairo context and important parameters like page size and resolution. It also lets you easily create #PangoLayout and #PangoContext objects that match the font metrics of the cairo surface.
GtkPrintContext objects gets passed to the #GtkPrintOperation::begin-print, #GtkPrintOperation::end-print, #GtkPrintOperation::request-page-setup and #GtkPrintOperation::draw-page signals on the #GtkPrintOperation.
Using GtkPrintContext in a #GtkPrintOperation::draw-page callback
static void
draw_page (GtkPrintOperation *operation,
GtkPrintContext *context,
int page_nr)
{
cairo_t *cr;
PangoLayout *layout;
PangoFontDescription *desc;
cr = gtk_print_context_get_cairo_context (context);
// Draw a red rectangle, as wide as the paper (inside the margins)
cairo_set_source_rgb (cr, 1.0, 0, 0);
cairo_rectangle (cr, 0, 0, gtk_print_context_get_width (context), 50);
cairo_fill (cr);
// Draw some lines
cairo_move_to (cr, 20, 10);
cairo_line_to (cr, 40, 20);
cairo_arc (cr, 60, 60, 20, 0, M_PI);
cairo_line_to (cr, 80, 20);
cairo_set_source_rgb (cr, 0, 0, 0);
cairo_set_line_width (cr, 5);
cairo_set_line_cap (cr, CAIRO_LINE_CAP_ROUND);
cairo_set_line_join (cr, CAIRO_LINE_JOIN_ROUND);
cairo_stroke (cr);
// Draw some text
layout = gtk_print_context_create_pango_layout (context);
pango_layout_set_text (layout, "Hello World! Printing is easy", -1);
desc = pango_font_description_from_string ("sans 28");
pango_layout_set_font_description (layout, desc);
pango_font_description_free (desc);
cairo_move_to (cr, 30, 20);
pango_cairo_layout_path (cr, layout);
// Font Outline
cairo_set_source_rgb (cr, 0.93, 1.0, 0.47);
cairo_set_line_width (cr, 0.5);
cairo_stroke_preserve (cr);
// Font Fill
cairo_set_source_rgb (cr, 0, 0.0, 1.0);
cairo_fill (cr);
g_object_unref (layout);
}Printing support was added in GTK+ 2.10.
Methods
PrintContext self()Returns `this`, for use in `with` statements.PrintContextGidBuilder builder()Get builder for [gtk.print_context.PrintContext] Returns: New builder objectpango.context.Context createPangoContext()Creates a new #PangoContext that can be used with the #GtkPrintContext. Returns: a new Pango context for contextpango.layout.Layout createPangoLayout()Creates a new #PangoLayout that is suitable for use with the #GtkPrintContext. Returns: a new Pango layout for contextcairo.context.Context getCairoContext()Obtains the cairo context that is associated with the #GtkPrintContext. Returns: the cairo context of contextdouble getDpiX()Obtains the horizontal resolution of the #GtkPrintContext, in dots per inch. Returns: the horizontal resolution of contextdouble getDpiY()Obtains the vertical resolution of the #GtkPrintContext, in dots per inch. Returns: the vertical resolution of contextbool getHardMargins(out double top, out double bottom, out double left, out double right)Obtains the hardware printer margins of the #GtkPrintContext, in units.double getHeight()Obtains the height of the #GtkPrintContext, in pixels. Returns: the height of contextgtk.page_setup.PageSetup getPageSetup()Obtains the #GtkPageSetup that determines the page dimensions of the #GtkPrintContext. Returns: the page setup of contextpango.font_map.FontMap getPangoFontmap()Returns a #PangoFontMap that is suitable for use with the #GtkPrintContext. Returns: the font map of contextdouble getWidth()Obtains the width of the #GtkPrintContext, in pixels. Returns: the width of contextvoid setCairoContext(cairo.context.Context cr, double dpiX, double dpiY)Sets a new cairo context on a print context.Fluent builder for [gtk.print_context.PrintContext]
Methods