class: PrintContext

[40:7] extends: object

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 c 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); }

Members

• handleObj
• lib
• retainedCallbacks
• signalHandlerNames
• signalSetterHandlers

Methods

• PrintContext (Handle = null)

  Creates a new PrintContext by wrapping a native handle or another wrapper.

  • @p Handle is the native handle or another wrapper whose handle to adopt.

• toNativeHandle (Source)

  Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.

  • @p Source is the raw handle, raw buffer, wrapper, or null.
  • @r A raw pointer carrier or null when no pointer is present.

• getLib ()

  Returns the opened native library for this generated wrapper.

  • @r The opened native library.

• handle ()

  Returns the wrapped NativeHandle.

  • @r The wrapped NativeHandle.

• isNull ()

  Returns true when the wrapped handle is null.

  • @r A bool.

• describe ()

  Returns a small string for debugging generated wrappers.

  • @r A string.

• asObject ()

  Wraps this handle as Object.

  • @r A Object object.

• create_pango_context ()

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

• create_pango_layout ()

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

• get_cairo_context ()

  Obtains the cairo context that is associated with the GtkPrintContext.

• get_dpi_x ()

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

• get_dpi_y ()

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

• get_height ()

  Obtains the height of the GtkPrintContext, in pixels.

• get_page_setup ()

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

• get_pango_fontmap ()

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

• get_width ()

  Obtains the width of the GtkPrintContext, in pixels.

• set_cairo_context (object cr, double dpi_x, double dpi_y)

  Sets a new cairo context on a print context. This function is intended to be used when implementing an internal print preview, it is not needed for printing, since GTK itself creates a suitable cairo context in that case.

  • @p cr is the cairo context.
  • @p dpi_x is the horizontal resolution to use with @cr.
  • @p dpi_y is the vertical resolution to use with @cr.
  • @r None.