Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkprintjob.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 GtkPrintJob
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 Represents a print job
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 A #GtkPrintJob object represents a job that is sent to a
  10 printer. You only need to deal directly with print jobs if
  11 you use the non-portable #GtkPrintUnixDialog API.
  12 </para>
  13 <para>
  14 Use gtk_print_job_get_surface() to obtain the cairo surface
  15 onto which the pages must be drawn. Use gtk_print_job_send()
  16 to send the finished job to the printer. If you don't use cairo
  17 #GtkPrintJob also supports printing of manually generated postscript,
  18 via gtk_print_job_set_source_file().
  19 <!-- FIXME more details needed here -->
  20 </para>
  21 <!-- FIXME examples ? -->
  22
  23 <para>
  24 Printing support was added in GTK+ 2.10.
  25 </para>
  26
  27 <!-- ##### SECTION See_Also ##### -->
  28 <para>
  29
  30 </para>
  31
  32 <!-- ##### SECTION Stability_Level ##### -->
  33
  34
  35 <!-- ##### SECTION Image ##### -->
  36
  37
  38 <!-- ##### STRUCT GtkPrintJob ##### -->
  39 <para>
  40 The GtkPrintJob struct contains only private members
  41 and should not be directly accessed.
  42 </para>
  43
  44
  45 <!-- ##### SIGNAL GtkPrintJob::status-changed ##### -->
  46 <para>
  47
  48 </para>
  49
  50 @printjob: the object which received the signal.
  51
  52 <!-- ##### ARG GtkPrintJob:page-setup ##### -->
  53 <para>
  54
  55 </para>
  56
  57 <!-- ##### ARG GtkPrintJob:printer ##### -->
  58 <para>
  59
  60 </para>
  61
  62 <!-- ##### ARG GtkPrintJob:settings ##### -->
  63 <para>
  64
  65 </para>
  66
  67 <!-- ##### ARG GtkPrintJob:title ##### -->
  68 <para>
  69
  70 </para>
  71
  72 <!-- ##### ARG GtkPrintJob:track-print-status ##### -->
  73 <para>
  74
  75 </para>
  76
  77 <!-- ##### USER_FUNCTION GtkPrintJobCompleteFunc ##### -->
  78 <para>
  79 The type of callback that is passed to gtk_print_job_send().
  80 It is called when the print job has been completely sent.
  81 </para>
  82
  83 @print_job: the #GtkPrintJob
  84 @user_data: user data that has been passed to gtk_print_job_send()
  85 @error: a #GError that contains error information if the sending
  86   of the print job failed, otherwise %NULL
  87
  88
  89 <!-- ##### FUNCTION gtk_print_job_new ##### -->
  90 <para>
  91
  92 </para>
  93
  94 @title:
  95 @printer:
  96 @settings:
  97 @page_setup:
  98 @Returns:
  99
 100
 101 <!-- ##### FUNCTION gtk_print_job_get_settings ##### -->
 102 <para>
 103
 104 </para>
 105
 106 @job:
 107 @Returns:
 108
 109
 110 <!-- ##### FUNCTION gtk_print_job_get_printer ##### -->
 111 <para>
 112
 113 </para>
 114
 115 @job:
 116 @Returns:
 117
 118
 119 <!-- ##### FUNCTION gtk_print_job_get_title ##### -->
 120 <para>
 121
 122 </para>
 123
 124 @job:
 125 @Returns:
 126
 127
 128 <!-- ##### FUNCTION gtk_print_job_get_status ##### -->
 129 <para>
 130
 131 </para>
 132
 133 @job:
 134 @Returns:
 135
 136
 137 <!-- ##### FUNCTION gtk_print_job_set_source_file ##### -->
 138 <para>
 139
 140 </para>
 141
 142 @job:
 143 @filename:
 144 @error:
 145 @Returns:
 146
 147
 148 <!-- ##### FUNCTION gtk_print_job_get_surface ##### -->
 149 <para>
 150
 151 </para>
 152
 153 @job:
 154 @error:
 155 @Returns:
 156
 157
 158 <!-- ##### FUNCTION gtk_print_job_send ##### -->
 159 <para>
 160
 161 </para>
 162
 163 @job:
 164 @callback:
 165 @user_data:
 166 @dnotify:
 167
 168
 169 <!-- ##### FUNCTION gtk_print_job_set_track_print_status ##### -->
 170 <para>
 171
 172 </para>
 173
 174 @job:
 175 @track_status:
 176
 177
 178 <!-- ##### FUNCTION gtk_print_job_get_track_print_status ##### -->
 179 <para>
 180
 181 </para>
 182
 183 @job:
 184 @Returns:
 185
 186