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 <!-- ##### SECTION See_Also ##### -->
  43 <para>
  44 #GtkPageSetupUnixDialog, #GtkPrinter, #GtkPrintJob
  45 </para>
  46
  47 <!-- ##### SECTION Stability_Level ##### -->
  48
  49
  50 <!-- ##### STRUCT GtkPrintUnixDialog ##### -->
  51 <para>
  52
  53 </para>
  54
  55
  56 <!-- ##### ARG GtkPrintUnixDialog:current-page ##### -->
  57 <para>
  58
  59 </para>
  60
  61 <!-- ##### ARG GtkPrintUnixDialog:page-setup ##### -->
  62 <para>
  63
  64 </para>
  65
  66 <!-- ##### ARG GtkPrintUnixDialog:print-settings ##### -->
  67 <para>
  68
  69 </para>
  70
  71 <!-- ##### ARG GtkPrintUnixDialog:selected-printer ##### -->
  72 <para>
  73
  74 </para>
  75
  76 <!-- ##### FUNCTION gtk_print_unix_dialog_new ##### -->
  77 <para>
  78
  79 </para>
  80
  81 @title:
  82 @parent:
  83 @Returns:
  84
  85
  86 <!-- ##### FUNCTION gtk_print_unix_dialog_set_page_setup ##### -->
  87 <para>
  88
  89 </para>
  90
  91 @dialog:
  92 @page_setup:
  93
  94
  95 <!-- ##### FUNCTION gtk_print_unix_dialog_get_page_setup ##### -->
  96 <para>
  97
  98 </para>
  99
 100 @dialog:
 101 @Returns:
 102
 103
 104 <!-- ##### FUNCTION gtk_print_unix_dialog_set_current_page ##### -->
 105 <para>
 106
 107 </para>
 108
 109 @dialog:
 110 @current_page:
 111
 112
 113 <!-- ##### FUNCTION gtk_print_unix_dialog_get_current_page ##### -->
 114 <para>
 115
 116 </para>
 117
 118 @dialog:
 119 @Returns:
 120
 121
 122 <!-- ##### FUNCTION gtk_print_unix_dialog_set_settings ##### -->
 123 <para>
 124
 125 </para>
 126
 127 @dialog:
 128 @settings:
 129
 130
 131 <!-- ##### FUNCTION gtk_print_unix_dialog_get_settings ##### -->
 132 <para>
 133
 134 </para>
 135
 136 @dialog:
 137 @Returns:
 138
 139
 140 <!-- ##### FUNCTION gtk_print_unix_dialog_get_selected_printer ##### -->
 141 <para>
 142
 143 </para>
 144
 145 @dialog:
 146 @Returns:
 147
 148
 149 <!-- ##### FUNCTION gtk_print_unix_dialog_add_custom_tab ##### -->
 150 <para>
 151
 152 </para>
 153
 154 @dialog:
 155 @child:
 156 @tab_label:
 157
 158
 159 <!-- ##### ENUM GtkPrintCapabilities ##### -->
 160 <para>
 161 An enum for specifying which features the print dialog should offer.
 162 I neither %GTK_PRINT_CAPABILITY_GENERATE_PDF nor %GTK_PRINT_CAPABILITY_GENERATE_PS is
 163 specified, GTK+ assumes that all formats are supported.
 164 </para>
 165
 166 @GTK_PRINT_CAPABILITY_PAGE_SET:
 167 @GTK_PRINT_CAPABILITY_COPIES:
 168 @GTK_PRINT_CAPABILITY_COLLATE:
 169 @GTK_PRINT_CAPABILITY_REVERSE:
 170 @GTK_PRINT_CAPABILITY_SCALE:
 171 @GTK_PRINT_CAPABILITY_GENERATE_PDF: The program will send the document to the printer in PDF format
 172 @GTK_PRINT_CAPABILITY_GENERATE_PS: The program will send the document to the printer in Postscript format
 173 @GTK_PRINT_CAPABILITY_PREVIEW:
 174
 175 <!-- ##### FUNCTION gtk_print_unix_dialog_set_manual_capabilities ##### -->
 176 <para>
 177
 178 </para>
 179
 180 @dialog:
 181 @capabilities:
 182
 183