Gtk.PrintContext
Description: Reference for Gtk.PrintContext

### Class

# GtkPrintContext

since: 4.0

#### Description [src]

    final class Gtk.PrintContext : GObject.Object
    {
      /* No available fields */
    }

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 `PangoLayout` and `PangoContext` objects that match the font metrics of the cairo surface.

`GtkPrintContext` objects get passed to the `GtkPrintOperation::begin-print`, `GtkPrintOperation::end-print`, `GtkPrintOperation::request-page-setup` and `GtkPrintOperation::draw-page` signals on the `GtkPrintOperation` 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);
    }

Available since: 4.0

#### Ancestors

- GObject

#### Instance methods

###### gtk_print_context_create_pango_context

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

since: 4.0

###### gtk_print_context_create_pango_layout

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

since: 4.0

###### gtk_print_context_get_cairo_context

Obtains the cairo context that is associated with the `GtkPrintContext`.

since: 4.0

###### gtk_print_context_get_dpi_x

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

since: 4.0

###### gtk_print_context_get_dpi_y

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

since: 4.0

###### gtk_print_context_get_hard_margins

Obtains the hardware printer margins of the `GtkPrintContext`, in units.

since: 4.0

###### gtk_print_context_get_height

Obtains the height of the `GtkPrintContext`, in pixels.

since: 4.0

###### gtk_print_context_get_page_setup

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

since: 4.0

###### gtk_print_context_get_pango_fontmap

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

since: 4.0

###### gtk_print_context_get_width

Obtains the width of the `GtkPrintContext`, in pixels.

since: 4.0

###### gtk_print_context_set_cairo_context

Sets a new cairo context on a print context.

since: 4.0

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Signals

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

since: 2.0