Gtk2::PrintOperation(3)

NAME
Gtk2::PrintOperation

HIERARCHY
  Glib::Object
  +----Gtk2::PrintOperation

INTERFACES
  Gtk2::PrintOperationPreview

METHODS

  printoperation = Gtk2::PrintOperation->new

  $op->set_allow_async ($allow_async)

    * $allow_async (boolean)

  $op->cancel

  $op->set_current_page ($current_page)
    * $current_page (integer)

  $op->set_custom_tab_label ($label)

    * $label (string)

  pagesetup or undef = $op->get_default_page_setup

  $op->set_default_page_setup ($default_page_setup)
    * $default_page_setup (Gtk2::PageSetup or undef)

  scalar = $op->get_error

  $op->set_export_filename ($filename)

    * $filename (string)

  boolean = $op->is_finished

  $op->set_job_name ($job_name)
    * $job_name (string)

  $op->set_n_pages ($n_pages)

    * $n_pages (integer)

  printsettings or undef = $op->get_print_settings

  $op->set_print_settings ($print_settings)
    * $print_settings (Gtk2::PrintSettings or undef)

  printoperationresult = $op->run ($action, $parent)

    * $action (Gtk2::PrintOperationAction)
    * $parent (Gtk2::Window or undef)

    May croak with a Glib::Error in $@ on failure.

  $op->set_show_progress ($show_progress)

    * $show_progress (boolean)

  printstatus = $op->get_status

  string = $op->get_status_string

  $op->set_track_print_status ($track_status)
    * $track_status (boolean)

  $op->set_unit ($unit)

    * $unit (Gtk2::Unit)

  $op->set_use_full_page ($full_page)
    * $full_page (boolean)

PROPERTIES

'allow-async' (boolean : readable / writable / private)
    TRUE if print process may run asynchronous.

'current-page' (integer : readable / writable / private)
    The current page in the document

'custom-tab-label' (string : readable / writable / private)
    Label for the tab containing custom widgets.

'default-page-setup' (Gtk2::PageSetup : readable / writable / private)
    The GtkPageSetup used by default

'export-filename' (string : readable / writable / private)
    Export filename

'job-name' (string : readable / writable / private)
    A string used for identifying the print job.

'n-pages' (integer : readable / writable / private)
    The number of pages in the document.

'print-settings' (Gtk2::PrintSettings : readable / writable / private)
    The GtkPrintSettings used for initializing the dialog

'show-progress' (boolean : readable / writable / private)
    TRUE if a progress dialog is shown while printing.

'status' (Gtk2::PrintStatus : readable / private)
    The status of the print operation

'status-string' (string : readable / private)
    A human-readable description of the status

'track-print-status' (boolean : readable / writable / private)
    TRUE if the print operation will continue to report on the print job status after the print data has been sent to the printer or print server.

'unit' (Gtk2::Unit : readable / writable / private)
    The unit in which distances can be measured in the context

'use-full-page' (boolean : readable / writable / private)
    TRUE if the origin of the context should be at the corner of the page and not the corner of the imageable area

SIGNALS

done (Gtk2::PrintOperation, Gtk2::PrintOperationResult)
begin-print (Gtk2::PrintOperation, Gtk2::PrintContext)
boolean = paginate (Gtk2::PrintOperation, Gtk2::PrintContext)
request-page-setup (Gtk2::PrintOperation, Gtk2::PrintContext, integer, Gtk2::PageSetup)
draw-page (Gtk2::PrintOperation, Gtk2::PrintContext, integer)
end-print (Gtk2::PrintOperation, Gtk2::PrintContext)
status-changed (Gtk2::PrintOperation)
Glib::Object = create-custom-widget (Gtk2::PrintOperation)
custom-widget-apply (Gtk2::PrintOperation, Gtk2::Widget)
boolean = preview (Gtk2::PrintOperation, Gtk2::PrintOperationPreview, Gtk2::PrintContext, Gtk2::Window)

ENUMS AND FLAGS

  enum Gtk2::PrintOperationAction

* 'print-dialog' / 'GTK_PRINT_OPERATION_ACTION_PRINT_DIALOG'
* 'print' / 'GTK_PRINT_OPERATION_ACTION_PRINT'
* 'preview' / 'GTK_PRINT_OPERATION_ACTION_PREVIEW'
* 'export' / 'GTK_PRINT_OPERATION_ACTION_EXPORT'

  enum Gtk2::PrintOperationResult

* 'error' / 'GTK_PRINT_OPERATION_RESULT_ERROR'
* 'apply' / 'GTK_PRINT_OPERATION_RESULT_APPLY'
* 'cancel' / 'GTK_PRINT_OPERATION_RESULT_CANCEL'
* 'in-progress' / 'GTK_PRINT_OPERATION_RESULT_IN_PROGRESS'

  enum Gtk2::PrintStatus

* 'initial' / 'GTK_PRINT_STATUS_INITIAL'
* 'preparing' / 'GTK_PRINT_STATUS_PREPARING'
* 'generating-data' / 'GTK_PRINT_STATUS_GENERATING_DATA'
* 'sending-data' / 'GTK_PRINT_STATUS_SENDING_DATA'
* 'pending' / 'GTK_PRINT_STATUS_PENDING'
* 'pending-issue' / 'GTK_PRINT_STATUS_PENDING_ISSUE'
* 'printing' / 'GTK_PRINT_STATUS_PRINTING'
* 'finished' / 'GTK_PRINT_STATUS_FINISHED'
* 'finished-aborted' / 'GTK_PRINT_STATUS_FINISHED_ABORTED'

  enum Gtk2::Unit

* 'pixel' / 'GTK_UNIT_PIXEL'
* 'points' / 'GTK_UNIT_POINTS'
* 'inch' / 'GTK_UNIT_INCH'
* 'mm' / 'GTK_UNIT_MM'

SEE ALSO
Gtk2, Glib::Object

COPYRIGHT
Copyright (C) 2003-2008 by the gtk2-perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.