PrintContext

open class PrintContext(val gtkPrintContextPointer: <Error class: unknown class><<Error class: unknown class>>)(source)

A GtkPrintContext encapsulates context information that is required when drawing pages for printing.

This includes the cairo context and important parameters like page size and resolution. It also lets you easily create class@Pango.Layout and class@Pango.Context objects that match the font metrics of the cairo surface.

GtkPrintContext objects get passed to the signal@Gtk.PrintOperation::begin-print, signal@Gtk.PrintOperation::end-print, signal@Gtk.PrintOperation::request-page-setup and signal@Gtk.PrintOperation::draw-page signals on the class@Gtk.PrintOperation object.

Using GtkPrintContext in a ::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);
}

Skipped during bindings generation

  • parameter top: top: Out parameter is not supported

Constructors

Link copied to clipboard
constructor(gtkPrintContextPointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Link copied to clipboard
object Companion

Properties

Link copied to clipboard
val gtkPrintContextPointer: <Error class: unknown class><<Error class: unknown class>>

Functions

Link copied to clipboard
open fun createPangoContext(): <Error class: unknown class>

Creates a new PangoContext that can be used with the GtkPrintContext.

Link copied to clipboard
open fun createPangoLayout(): <Error class: unknown class>

Creates a new PangoLayout that is suitable for use with the GtkPrintContext.

Link copied to clipboard
open fun getCairoContext(): <Error class: unknown class>

Obtains the cairo context that is associated with the GtkPrintContext.

Link copied to clipboard
open fun getDpiX(): <Error class: unknown class>

Obtains the horizontal resolution of the GtkPrintContext, in dots per inch.

Link copied to clipboard
open fun getDpiY(): <Error class: unknown class>

Obtains the vertical resolution of the GtkPrintContext, in dots per inch.

Link copied to clipboard
open fun getHeight(): <Error class: unknown class>

Obtains the height of the GtkPrintContext, in pixels.

Link copied to clipboard

Obtains the GtkPageSetup that determines the page dimensions of the GtkPrintContext.

Link copied to clipboard
open fun getPangoFontmap(): <Error class: unknown class>

Returns a PangoFontMap that is suitable for use with the GtkPrintContext.

Link copied to clipboard
open fun getWidth(): <Error class: unknown class>

Obtains the width of the GtkPrintContext, in pixels.

Link copied to clipboard
open fun setCairoContext(cr: <Error class: unknown class>, dpiX: <Error class: unknown class>, dpiY: <Error class: unknown class>)

Sets a new cairo context on a print context.