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

   1 <!-- ##### SECTION Title ##### -->
   2 GtkPrintUnixDialog
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 A print dialog
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 GtkPrintUnixDialog implements a print dialog for platforms
  10 which don't provide a native print dialog, like Unix. It can
  11 be used very much like any other GTK+ dialog, at the cost of
  12 the portability offered by the <link
  13 linkend="gtk-High-level-Printing-API">high-level printing API</link>
  14 </para>
  15 <para>
  16 In order to print something with #GtkPrintUnixDialog, you need
  17 to use gtk_print_unix_dialog_get_selected_printer() to obtain
  18 a #GtkPrinter object and use it to construct a #GtkPrintJob using
  19 gtk_print_job_new().
  20 </para>
  21 <para>
  22 #GtkPrintUnixDialog uses the following response values:
  23 <variablelist>
  24   <varlistentry><term>%GTK_RESPONSE_OK</term>
  25     <listitem><para>for the "Print" button</para></listitem>
  26   </varlistentry>
  27   <varlistentry><term>%GTK_RESPONSE_APPLY</term>
  28     <listitem><para>for the "Preview" button</para></listitem>
  29   </varlistentry>
  30   <varlistentry><term>%GTK_RESPONSE_CANCEL</term>
  31     <listitem><para>for the "Cancel" button</para></listitem>
  32   </varlistentry>
  33 </variablelist>
  34 </para>
  35
  36 <!-- FIXME example here -->
  37
  38 <para>
  39 Printing support was added in GTK+ 2.10.
  40 </para>
  41
  42 <refsect2 id="GtkPrintUnixDialog-BUILDER-UI"><title>GtkPrintUnixDialog as GtkBuildable</title>
  43 <para>
  44 The GtkPrintUnixDialog implementation of the GtkBuildable interface exposes its
  45 @notebook internal children with the name "notebook".
  46 </para>
  47 <example>
  48 <title>A <structname>GtkPrintUnixDialog</structname> UI definition fragment.</title>
  49 <programlisting><![CDATA[
  50 <object class="GtkPrintUnixDialog" id="dialog1">
  51   <child internal-child="notebook">
  52     <object class="GtkNotebook" id="notebook">
  53       <child>
  54         <object class="GtkLabel" id="tabcontent">
  55         <property name="label">Content on notebook tab</property>
  56         </object>
  57       </child>
  58       <child type="tab">
  59         <object class="GtkLabel" id="tablabel">
  60           <property name="label">Tab label</property>
  61         </object>
  62         <packing>
  63           <property name="tab_expand">False</property>
  64           <property name="tab_fill">False</property>
  65         </packing>
  66       </child>
  67     </object>
  68   </child>
  69 </object>
  70 ]]></programlisting>
  71 </example>
  72 </refsect2>
  73
  74 <!-- ##### SECTION See_Also ##### -->
  75 <para>
  76 #GtkPageSetupUnixDialog, #GtkPrinter, #GtkPrintJob
  77 </para>
  78
  79 <!-- ##### SECTION Stability_Level ##### -->
  80
  81
  82 <!-- ##### STRUCT GtkPrintUnixDialog ##### -->
  83 <para>
  84
  85 </para>
  86
  87
  88 <!-- ##### ARG GtkPrintUnixDialog:current-page ##### -->
  89 <para>
  90
  91 </para>
  92
  93 <!-- ##### ARG GtkPrintUnixDialog:has-selection ##### -->
  94 <para>
  95
  96 </para>
  97
  98 <!-- ##### ARG GtkPrintUnixDialog:manual-capabilities ##### -->
  99 <para>
 100
 101 </para>
 102
 103 <!-- ##### ARG GtkPrintUnixDialog:page-setup ##### -->
 104 <para>
 105
 106 </para>
 107
 108 <!-- ##### ARG GtkPrintUnixDialog:print-settings ##### -->
 109 <para>
 110
 111 </para>
 112
 113 <!-- ##### ARG GtkPrintUnixDialog:selected-printer ##### -->
 114 <para>
 115
 116 </para>
 117
 118 <!-- ##### ARG GtkPrintUnixDialog:support-selection ##### -->
 119 <para>
 120
 121 </para>
 122
 123 <!-- ##### FUNCTION gtk_print_unix_dialog_new ##### -->
 124 <para>
 125
 126 </para>
 127
 128 @title:
 129 @parent:
 130 @Returns:
 131
 132
 133 <!-- ##### FUNCTION gtk_print_unix_dialog_set_page_setup ##### -->
 134 <para>
 135
 136 </para>
 137
 138 @dialog:
 139 @page_setup:
 140
 141
 142 <!-- ##### FUNCTION gtk_print_unix_dialog_get_page_setup ##### -->
 143 <para>
 144
 145 </para>
 146
 147 @dialog:
 148 @Returns:
 149
 150
 151 <!-- ##### FUNCTION gtk_print_unix_dialog_set_current_page ##### -->
 152 <para>
 153
 154 </para>
 155
 156 @dialog:
 157 @current_page:
 158
 159
 160 <!-- ##### FUNCTION gtk_print_unix_dialog_get_current_page ##### -->
 161 <para>
 162
 163 </para>
 164
 165 @dialog:
 166 @Returns:
 167
 168
 169 <!-- ##### FUNCTION gtk_print_unix_dialog_set_settings ##### -->
 170 <para>
 171
 172 </para>
 173
 174 @dialog:
 175 @settings:
 176
 177
 178 <!-- ##### FUNCTION gtk_print_unix_dialog_get_settings ##### -->
 179 <para>
 180
 181 </para>
 182
 183 @dialog:
 184 @Returns:
 185
 186
 187 <!-- ##### FUNCTION gtk_print_unix_dialog_get_selected_printer ##### -->
 188 <para>
 189
 190 </para>
 191
 192 @dialog:
 193 @Returns:
 194
 195
 196 <!-- ##### FUNCTION gtk_print_unix_dialog_add_custom_tab ##### -->
 197 <para>
 198
 199 </para>
 200
 201 @dialog:
 202 @child:
 203 @tab_label:
 204
 205
 206 <!-- ##### FUNCTION gtk_print_unix_dialog_set_support_selection ##### -->
 207 <para>
 208
 209 </para>
 210
 211 @dialog:
 212 @support_selection:
 213
 214
 215 <!-- ##### FUNCTION gtk_print_unix_dialog_get_support_selection ##### -->
 216 <para>
 217
 218 </para>
 219
 220 @dialog:
 221 @Returns:
 222
 223
 224 <!-- ##### FUNCTION gtk_print_unix_dialog_set_has_selection ##### -->
 225 <para>
 226
 227 </para>
 228
 229 @dialog:
 230 @has_selection:
 231
 232
 233 <!-- ##### FUNCTION gtk_print_unix_dialog_get_has_selection ##### -->
 234 <para>
 235
 236 </para>
 237
 238 @dialog:
 239 @Returns:
 240
 241
 242 <!-- ##### ENUM GtkPrintCapabilities ##### -->
 243 <para>
 244 An enum for specifying which features the print dialog should offer.
 245 If neither %GTK_PRINT_CAPABILITY_GENERATE_PDF nor
 246 %GTK_PRINT_CAPABILITY_GENERATE_PS is specified, GTK+ assumes that all
 247 formats are supported.
 248 </para>
 249
 250 @GTK_PRINT_CAPABILITY_PAGE_SET: Print dialog will offer printing even/odd pages.
 251 @GTK_PRINT_CAPABILITY_COPIES: Print dialog will allow to print multiple copies.
 252 @GTK_PRINT_CAPABILITY_COLLATE: Print dialog will allow to collate multiple copies.
 253 @GTK_PRINT_CAPABILITY_REVERSE: Print dialog will allow to print pages in reverse order.
 254 @GTK_PRINT_CAPABILITY_SCALE: Print dialog will allow to scale the output.
 255 @GTK_PRINT_CAPABILITY_GENERATE_PDF: The program will send the document to
 256     the printer in PDF format
 257 @GTK_PRINT_CAPABILITY_GENERATE_PS: The program will send the document to
 258     the printer in Postscript format
 259 @GTK_PRINT_CAPABILITY_PREVIEW: Print dialog will offer a previe
 260 @GTK_PRINT_CAPABILITY_NUMBER_UP: Print dialog will offer printing multiple
 261     pages per sheet. Since 2.12
 262 @GTK_PRINT_CAPABILITY_NUMBER_UP_LAYOUT: Print dialog will allow to rearrange
 263     pages when printing multiple pages per sheet. Since 2.14
 264
 265 <!-- ##### FUNCTION gtk_print_unix_dialog_set_manual_capabilities ##### -->
 266 <para>
 267
 268 </para>
 269
 270 @dialog:
 271 @capabilities:
 272
 273
 274 <!-- ##### FUNCTION gtk_print_unix_dialog_get_manual_capabilities ##### -->
 275 <para>
 276
 277 </para>
 278
 279 @dialog:
 280 @Returns:
 281
 282