← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/gtk-High-level-Printing-API.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/gtk-High-level-Printing-API.html
60
60
#define             <a class="link" href="gtk-High-level-Printing-API.html#GTK-PRINT-ERROR:CAPS" title="GTK_PRINT_ERROR">GTK_PRINT_ERROR</a>
61
61
<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="returnvalue">GtkPrintOperation</span></a> * <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-new" title="gtk_print_operation_new ()">gtk_print_operation_new</a>             (<em class="parameter"><code><span class="type">void</span></code></em>);
62
62
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-allow-async" title="gtk_print_operation_set_allow_async ()">gtk_print_operation_set_allow_async</a> (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
63
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> allow_async</code></em>);
 
63
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> allow_async</code></em>);
64
64
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-error" title="gtk_print_operation_get_error ()">gtk_print_operation_get_error</a>       (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
65
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
65
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
66
66
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-default-page-setup" title="gtk_print_operation_set_default_page_setup ()">gtk_print_operation_set_default_page_setup</a>
67
67
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
68
68
                                                         <em class="parameter"><code><a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> *default_page_setup</code></em>);
74
74
<a class="link" href="GtkPrintSettings.html" title="GtkPrintSettings"><span class="returnvalue">GtkPrintSettings</span></a> *  <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-print-settings" title="gtk_print_operation_get_print_settings ()">gtk_print_operation_get_print_settings</a>
75
75
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
76
76
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-job-name" title="gtk_print_operation_set_job_name ()">gtk_print_operation_set_job_name</a>    (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
77
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *job_name</code></em>);
 
77
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *job_name</code></em>);
78
78
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-n-pages" title="gtk_print_operation_set_n_pages ()">gtk_print_operation_set_n_pages</a>     (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
79
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_pages</code></em>);
80
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-n-pages-to-print" title="gtk_print_operation_get_n_pages_to_print ()">gtk_print_operation_get_n_pages_to_print</a>
 
79
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_pages</code></em>);
 
80
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-n-pages-to-print" title="gtk_print_operation_get_n_pages_to_print ()">gtk_print_operation_get_n_pages_to_print</a>
81
81
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
82
82
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-current-page" title="gtk_print_operation_set_current_page ()">gtk_print_operation_set_current_page</a>
83
83
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
84
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> current_page</code></em>);
 
84
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> current_page</code></em>);
85
85
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-use-full-page" title="gtk_print_operation_set_use_full_page ()">gtk_print_operation_set_use_full_page</a>
86
86
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
87
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> full_page</code></em>);
 
87
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> full_page</code></em>);
88
88
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-unit" title="gtk_print_operation_set_unit ()">gtk_print_operation_set_unit</a>        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
89
89
                                                         <em class="parameter"><code><a class="link" href="gtk-GtkPaperSize.html#GtkUnit" title="enum GtkUnit"><span class="type">GtkUnit</span></a> unit</code></em>);
90
90
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-export-filename" title="gtk_print_operation_set_export_filename ()">gtk_print_operation_set_export_filename</a>
91
91
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
92
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);
 
92
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);
93
93
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-show-progress" title="gtk_print_operation_set_show_progress ()">gtk_print_operation_set_show_progress</a>
94
94
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
95
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_progress</code></em>);
 
95
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_progress</code></em>);
96
96
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-track-print-status" title="gtk_print_operation_set_track_print_status ()">gtk_print_operation_set_track_print_status</a>
97
97
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
98
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_status</code></em>);
 
98
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_status</code></em>);
99
99
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-custom-tab-label" title="gtk_print_operation_set_custom_tab_label ()">gtk_print_operation_set_custom_tab_label</a>
100
100
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
101
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
 
101
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);
102
102
<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationResult" title="enum GtkPrintOperationResult"><span class="returnvalue">GtkPrintOperationResult</span></a>  <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-run" title="gtk_print_operation_run ()">gtk_print_operation_run</a>        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
103
103
                                                         <em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationAction" title="enum GtkPrintOperationAction"><span class="type">GtkPrintOperationAction</span></a> action</code></em>,
104
104
                                                         <em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
105
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
105
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
106
106
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-cancel" title="gtk_print_operation_cancel ()">gtk_print_operation_cancel</a>          (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
107
107
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-draw-page-finish" title="gtk_print_operation_draw_page_finish ()">gtk_print_operation_draw_page_finish</a>
108
108
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
109
109
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-defer-drawing" title="gtk_print_operation_set_defer_drawing ()">gtk_print_operation_set_defer_drawing</a>
110
110
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
111
111
<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintStatus" title="enum GtkPrintStatus"><span class="returnvalue">GtkPrintStatus</span></a>      <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-status" title="gtk_print_operation_get_status ()">gtk_print_operation_get_status</a>      (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
112
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-status-string" title="gtk_print_operation_get_status_string ()">gtk_print_operation_get_status_string</a>
 
112
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-status-string" title="gtk_print_operation_get_status_string ()">gtk_print_operation_get_status_string</a>
113
113
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
114
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-is-finished" title="gtk_print_operation_is_finished ()">gtk_print_operation_is_finished</a>     (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
 
114
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-is-finished" title="gtk_print_operation_is_finished ()">gtk_print_operation_is_finished</a>     (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
115
115
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-support-selection" title="gtk_print_operation_set_support_selection ()">gtk_print_operation_set_support_selection</a>
116
116
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
117
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> support_selection</code></em>);
118
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-support-selection" title="gtk_print_operation_get_support_selection ()">gtk_print_operation_get_support_selection</a>
 
117
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> support_selection</code></em>);
 
118
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-support-selection" title="gtk_print_operation_get_support_selection ()">gtk_print_operation_get_support_selection</a>
119
119
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
120
120
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-has-selection" title="gtk_print_operation_set_has_selection ()">gtk_print_operation_set_has_selection</a>
121
121
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
122
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_selection</code></em>);
123
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-has-selection" title="gtk_print_operation_get_has_selection ()">gtk_print_operation_get_has_selection</a>
 
122
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_selection</code></em>);
 
123
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-has-selection" title="gtk_print_operation_get_has_selection ()">gtk_print_operation_get_has_selection</a>
124
124
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
125
125
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-embed-page-setup" title="gtk_print_operation_set_embed_page_setup ()">gtk_print_operation_set_embed_page_setup</a>
126
126
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
127
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> embed</code></em>);
128
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-embed-page-setup" title="gtk_print_operation_get_embed_page_setup ()">gtk_print_operation_get_embed_page_setup</a>
 
127
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> embed</code></em>);
 
128
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-get-embed-page-setup" title="gtk_print_operation_get_embed_page_setup ()">gtk_print_operation_get_embed_page_setup</a>
129
129
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);
130
130
<a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="returnvalue">GtkPageSetup</span></a> *      <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-run-page-setup-dialog" title="gtk_print_run_page_setup_dialog ()">gtk_print_run_page_setup_dialog</a>     (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
131
131
                                                         <em class="parameter"><code><a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> *page_setup</code></em>,
132
132
                                                         <em class="parameter"><code><a class="link" href="GtkPrintSettings.html" title="GtkPrintSettings"><span class="type">GtkPrintSettings</span></a> *settings</code></em>);
133
133
<span class="returnvalue">void</span>                (<a class="link" href="gtk-High-level-Printing-API.html#GtkPageSetupDoneFunc" title="GtkPageSetupDoneFunc ()">*GtkPageSetupDoneFunc</a>)             (<em class="parameter"><code><a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> *page_setup</code></em>,
134
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
134
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
135
135
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-run-page-setup-dialog-async" title="gtk_print_run_page_setup_dialog_async ()">gtk_print_run_page_setup_dialog_async</a>
136
136
                                                        (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
137
137
                                                         <em class="parameter"><code><a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> *page_setup</code></em>,
138
138
                                                         <em class="parameter"><code><a class="link" href="GtkPrintSettings.html" title="GtkPrintSettings"><span class="type">GtkPrintSettings</span></a> *settings</code></em>,
139
139
                                                         <em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPageSetupDoneFunc" title="GtkPageSetupDoneFunc ()"><span class="type">GtkPageSetupDoneFunc</span></a> done_cb</code></em>,
140
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
140
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
141
141
 
142
142
                    <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationPreview-struct" title="GtkPrintOperationPreview">GtkPrintOperationPreview</a>;
143
143
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-preview-end-preview" title="gtk_print_operation_preview_end_preview ()">gtk_print_operation_preview_end_preview</a>
144
144
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationPreview"><span class="type">GtkPrintOperationPreview</span></a> *preview</code></em>);
145
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-preview-is-selected" title="gtk_print_operation_preview_is_selected ()">gtk_print_operation_preview_is_selected</a>
 
145
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-preview-is-selected" title="gtk_print_operation_preview_is_selected ()">gtk_print_operation_preview_is_selected</a>
146
146
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationPreview"><span class="type">GtkPrintOperationPreview</span></a> *preview</code></em>,
147
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> page_nr</code></em>);
 
147
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> page_nr</code></em>);
148
148
<span class="returnvalue">void</span>                <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-preview-render-page" title="gtk_print_operation_preview_render_page ()">gtk_print_operation_preview_render_page</a>
149
149
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationPreview"><span class="type">GtkPrintOperationPreview</span></a> *preview</code></em>,
150
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> page_nr</code></em>);
 
150
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> page_nr</code></em>);
151
151
</pre>
152
152
</div>
153
153
<div class="refsect1" title="Object Hierarchy">
154
154
<a name="gtk-High-level-Printing-API.object-hierarchy"></a><h2>Object Hierarchy</h2>
155
155
<pre class="synopsis">
156
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
156
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
157
157
   +----GtkPrintOperation
158
158
</pre>
159
159
<pre class="synopsis">
165
165
<a name="gtk-High-level-Printing-API.prerequisites"></a><h2>Prerequisites</h2>
166
166
<p>
167
167
GtkPrintOperationPreview requires
168
 
 <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
 
168
 <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
169
169
</div>
170
170
<div class="refsect1" title="Implemented Interfaces">
171
171
<a name="gtk-High-level-Printing-API.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
182
182
<div class="refsect1" title="Properties">
183
183
<a name="gtk-High-level-Printing-API.properties"></a><h2>Properties</h2>
184
184
<pre class="synopsis">
185
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--allow-async" title='The "allow-async" property'>allow-async</a>"              <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
186
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--current-page" title='The "current-page" property'>current-page</a>"             <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
187
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--custom-tab-label" title='The "custom-tab-label" property'>custom-tab-label</a>"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
185
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--allow-async" title='The "allow-async" property'>allow-async</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
186
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--current-page" title='The "current-page" property'>current-page</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
187
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--custom-tab-label" title='The "custom-tab-label" property'>custom-tab-label</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
188
188
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--default-page-setup" title='The "default-page-setup" property'>default-page-setup</a>"       <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>*         : Read / Write
189
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--embed-page-setup" title='The "embed-page-setup" property'>embed-page-setup</a>"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
190
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--export-filename" title='The "export-filename" property'>export-filename</a>"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
191
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--has-selection" title='The "has-selection" property'>has-selection</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
192
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--job-name" title='The "job-name" property'>job-name</a>"                 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
193
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--n-pages" title='The "n-pages" property'>n-pages</a>"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
194
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--n-pages-to-print" title='The "n-pages-to-print" property'>n-pages-to-print</a>"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
189
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--embed-page-setup" title='The "embed-page-setup" property'>embed-page-setup</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
190
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--export-filename" title='The "export-filename" property'>export-filename</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
191
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--has-selection" title='The "has-selection" property'>has-selection</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
192
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--job-name" title='The "job-name" property'>job-name</a>"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
193
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--n-pages" title='The "n-pages" property'>n-pages</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
194
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--n-pages-to-print" title='The "n-pages-to-print" property'>n-pages-to-print</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
195
195
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--print-settings" title='The "print-settings" property'>print-settings</a>"           <a class="link" href="GtkPrintSettings.html" title="GtkPrintSettings"><span class="type">GtkPrintSettings</span></a>*     : Read / Write
196
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--show-progress" title='The "show-progress" property'>show-progress</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
196
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--show-progress" title='The "show-progress" property'>show-progress</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
197
197
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--status" title='The "status" property'>status</a>"                   <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintStatus" title="enum GtkPrintStatus"><span class="type">GtkPrintStatus</span></a>        : Read
198
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--status-string" title='The "status-string" property'>status-string</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read
199
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--support-selection" title='The "support-selection" property'>support-selection</a>"        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
200
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--track-print-status" title='The "track-print-status" property'>track-print-status</a>"       <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
198
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--status-string" title='The "status-string" property'>status-string</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read
 
199
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--support-selection" title='The "support-selection" property'>support-selection</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
200
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--track-print-status" title='The "track-print-status" property'>track-print-status</a>"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
201
201
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--unit" title='The "unit" property'>unit</a>"                     <a class="link" href="gtk-GtkPaperSize.html#GtkUnit" title="enum GtkUnit"><span class="type">GtkUnit</span></a>               : Read / Write
202
 
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--use-full-page" title='The "use-full-page" property'>use-full-page</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
202
  "<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation--use-full-page" title='The "use-full-page" property'>use-full-page</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
203
203
</pre>
204
204
</div>
205
205
<div class="refsect1" title="Signals">
245
245
to catch and render the page on the provided <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a> using Cairo.
246
246
</p>
247
247
<div class="example">
248
 
<a name="id1221896"></a><p class="title"><b>Example 46. The high-level printing API</b></p>
 
248
<a name="id1097871"></a><p class="title"><b>Example 46. The high-level printing API</b></p>
249
249
<div class="example-contents">
250
250
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
251
251
    <tbody>
271
271
19
272
272
20
273
273
21</pre></td>
274
 
        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="GtkPrintSettings.html">GtkPrintSettings</a> </span><span class="symbol">*</span><span class="normal">settings </span><span class="symbol">=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 
274
        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GtkPrintSettings</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">settings </span><span class="symbol">=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
275
275
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
276
276
<span class="function">do_print</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
277
277
<span class="cbracket">{</span>
278
 
<span class="normal">  <a href="gtk-High-level-Printing-API.html#GtkPrintOperation">GtkPrintOperation</a> </span><span class="symbol">*</span><span class="normal">print</span><span class="symbol">;</span>
279
 
<span class="normal">  <a href="gtk-High-level-Printing-API.html#GtkPrintOperationResult">GtkPrintOperationResult</a> res</span><span class="symbol">;</span>
 
278
<span class="normal">  </span><span class="usertype">GtkPrintOperation</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">print</span><span class="symbol">;</span>
 
279
<span class="normal">  </span><span class="usertype">GtkPrintOperationResult</span><span class="normal"> res</span><span class="symbol">;</span>
280
280
<span class="normal">  print </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-new">gtk_print_operation_new</a></span><span class="normal"> </span><span class="symbol">();</span>
281
 
<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings </span><span class="symbol">!=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
 
281
<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings </span><span class="symbol">!=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
282
282
<span class="normal">    </span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-set-print-settings">gtk_print_operation_set_print_settings</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> settings</span><span class="symbol">);</span>
283
 
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"begin_print"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">begin_print</span><span class="symbol">),</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
284
 
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"draw_page"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">draw_page</span><span class="symbol">),</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
283
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"begin_print"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">begin_print</span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
284
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"draw_page"</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">draw_page</span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
285
285
<span class="normal">  res </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-run">gtk_print_operation_run</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> <a href="gtk-High-level-Printing-API.html#GTK-PRINT-OPERATION-ACTION-PRINT-DIALOG:CAPS">GTK_PRINT_OPERATION_ACTION_PRINT_DIALOG</a></span><span class="symbol">,</span>
286
 
<span class="normal">                                 </span><span class="function">GTK_WINDOW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">main_window</span><span class="symbol">),</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
286
<span class="normal">                                 </span><span class="function">GTK_WINDOW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">main_window</span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
287
287
<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">res </span><span class="symbol">==</span><span class="normal"> <a href="gtk-High-level-Printing-API.html#GTK-PRINT-OPERATION-RESULT-APPLY:CAPS">GTK_PRINT_OPERATION_RESULT_APPLY</a></span><span class="symbol">)</span>
288
288
<span class="normal">    </span><span class="cbracket">{</span>
289
 
<span class="normal">      </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings </span><span class="symbol">!=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
290
 
<span class="normal">        </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings</span><span class="symbol">);</span>
291
 
<span class="normal">      settings </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-get-print-settings">gtk_print_operation_get_print_settings</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">));</span>
 
289
<span class="normal">      </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings </span><span class="symbol">!=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
 
290
<span class="normal">        </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings</span><span class="symbol">);</span>
 
291
<span class="normal">      settings </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-get-print-settings">gtk_print_operation_get_print_settings</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">));</span>
292
292
<span class="normal">    </span><span class="cbracket">}</span>
293
 
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">);</span>
 
293
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">);</span>
294
294
<span class="cbracket">}</span></pre></td>
295
295
      </tr>
296
296
    </tbody>
526
526
<pre class="programlisting">#define GTK_PRINT_ERROR gtk_print_error_quark ()
527
527
</pre>
528
528
<p>
529
 
The <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> used for <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintError" title="enum GtkPrintError"><span class="type">GtkPrintError</span></a> errors.
 
529
The <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> used for <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintError" title="enum GtkPrintError"><span class="type">GtkPrintError</span></a> errors.
530
530
</p>
531
531
</div>
532
532
<hr>
551
551
<div class="refsect2" title="gtk_print_operation_set_allow_async ()">
552
552
<a name="gtk-print-operation-set-allow-async"></a><h3>gtk_print_operation_set_allow_async ()</h3>
553
553
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_allow_async (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
554
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> allow_async</code></em>);</pre>
 
554
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> allow_async</code></em>);</pre>
555
555
<p>
556
556
Sets whether the <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-run" title="gtk_print_operation_run ()"><code class="function">gtk_print_operation_run()</code></a> may return
557
557
before the print operation is completed. Note that
568
568
<tr>
569
569
<td><p><span class="term"><em class="parameter"><code>allow_async</code></em> :</span></p></td>
570
570
<td>
571
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to allow asynchronous operation
 
571
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to allow asynchronous operation
572
572
</td>
573
573
</tr>
574
574
</tbody>
579
579
<div class="refsect2" title="gtk_print_operation_get_error ()">
580
580
<a name="gtk-print-operation-get-error"></a><h3>gtk_print_operation_get_error ()</h3>
581
581
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_get_error       (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
582
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
582
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
583
583
<p>
584
584
Call this when the result of a print operation is
585
585
<a class="link" href="gtk-High-level-Printing-API.html#GTK-PRINT-OPERATION-RESULT-ERROR:CAPS"><code class="literal">GTK_PRINT_OPERATION_RESULT_ERROR</code></a>, either as returned by 
586
586
<a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-run" title="gtk_print_operation_run ()"><code class="function">gtk_print_operation_run()</code></a>, or in the <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation-done" title='The "done" signal'><span class="type">"done"</span></a> signal 
587
 
handler. The returned <a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> will contain more details on what went wrong.
 
587
handler. The returned <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> will contain more details on what went wrong.
588
588
</p>
589
589
<div class="variablelist"><table border="0">
590
590
<col align="left" valign="top">
627
627
</tr>
628
628
<tr>
629
629
<td><p><span class="term"><em class="parameter"><code>default_page_setup</code></em> :</span></p></td>
630
 
<td> a <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
630
<td> a <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
631
631
</td>
632
632
</tr>
633
633
</tbody>
698
698
Returns the current print settings. 
699
699
</p>
700
700
<p>
701
 
Note that the return value is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> until either 
 
701
Note that the return value is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> until either 
702
702
<a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-print-settings" title="gtk_print_operation_set_print_settings ()"><code class="function">gtk_print_operation_set_print_settings()</code></a> or 
703
703
<a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-run" title="gtk_print_operation_run ()"><code class="function">gtk_print_operation_run()</code></a> have been called.
704
704
</p>
724
724
<div class="refsect2" title="gtk_print_operation_set_job_name ()">
725
725
<a name="gtk-print-operation-set-job-name"></a><h3>gtk_print_operation_set_job_name ()</h3>
726
726
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_job_name    (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
727
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *job_name</code></em>);</pre>
 
727
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *job_name</code></em>);</pre>
728
728
<p>
729
729
Sets the name of the print job. The name is used to identify 
730
730
the job (e.g. in monitoring applications like eggcups). 
754
754
<div class="refsect2" title="gtk_print_operation_set_n_pages ()">
755
755
<a name="gtk-print-operation-set-n-pages"></a><h3>gtk_print_operation_set_n_pages ()</h3>
756
756
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_n_pages     (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
757
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_pages</code></em>);</pre>
 
757
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_pages</code></em>);</pre>
758
758
<p>
759
759
Sets the number of pages in the document. 
760
760
</p>
790
790
<hr>
791
791
<div class="refsect2" title="gtk_print_operation_get_n_pages_to_print ()">
792
792
<a name="gtk-print-operation-get-n-pages-to-print"></a><h3>gtk_print_operation_get_n_pages_to_print ()</h3>
793
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_print_operation_get_n_pages_to_print
 
793
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_print_operation_get_n_pages_to_print
794
794
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);</pre>
795
795
<p>
796
796
Returns the number of pages that will be printed.
827
827
<a name="gtk-print-operation-set-current-page"></a><h3>gtk_print_operation_set_current_page ()</h3>
828
828
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_current_page
829
829
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
830
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> current_page</code></em>);</pre>
 
830
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> current_page</code></em>);</pre>
831
831
<p>
832
832
Sets the current page.
833
833
</p>
860
860
<a name="gtk-print-operation-set-use-full-page"></a><h3>gtk_print_operation_set_use_full_page ()</h3>
861
861
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_use_full_page
862
862
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
863
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> full_page</code></em>);</pre>
 
863
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> full_page</code></em>);</pre>
864
864
<p>
865
 
If <em class="parameter"><code>full_page</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the transformation for the cairo context 
 
865
If <em class="parameter"><code>full_page</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the transformation for the cairo context 
866
866
obtained from <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a> puts the origin at the top left 
867
867
corner of the page (which may not be the top left corner of the 
868
868
sheet, depending on page orientation and the number of pages per 
880
880
<tr>
881
881
<td><p><span class="term"><em class="parameter"><code>full_page</code></em> :</span></p></td>
882
882
<td>
883
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to set up the <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a> for the full page
 
883
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to set up the <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a> for the full page
884
884
</td>
885
885
</tr>
886
886
</tbody>
919
919
<a name="gtk-print-operation-set-export-filename"></a><h3>gtk_print_operation_set_export_filename ()</h3>
920
920
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_export_filename
921
921
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
922
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
 
922
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
923
923
<p>
924
924
Sets up the <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> to generate a file instead
925
925
of showing the print dialog. The indended use of this function
953
953
<a name="gtk-print-operation-set-show-progress"></a><h3>gtk_print_operation_set_show_progress ()</h3>
954
954
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_show_progress
955
955
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
956
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_progress</code></em>);</pre>
 
956
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_progress</code></em>);</pre>
957
957
<p>
958
 
If <em class="parameter"><code>show_progress</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the print operation will show a 
 
958
If <em class="parameter"><code>show_progress</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the print operation will show a 
959
959
progress dialog during the print operation.
960
960
</p>
961
961
<div class="variablelist"><table border="0">
969
969
<tr>
970
970
<td><p><span class="term"><em class="parameter"><code>show_progress</code></em> :</span></p></td>
971
971
<td>
972
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to show a progress dialog
 
972
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to show a progress dialog
973
973
</td>
974
974
</tr>
975
975
</tbody>
981
981
<a name="gtk-print-operation-set-track-print-status"></a><h3>gtk_print_operation_set_track_print_status ()</h3>
982
982
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_track_print_status
983
983
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
984
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_status</code></em>);</pre>
 
984
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> track_status</code></em>);</pre>
985
985
<p>
986
 
If track_status is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the print operation will try to continue report
 
986
If track_status is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the print operation will try to continue report
987
987
on the status of the print job in the printer queues and printer. This
988
988
can allow your application to show things like "out of paper" issues,
989
989
and when the print job actually reaches the printer.
1003
1003
<tr>
1004
1004
<td><p><span class="term"><em class="parameter"><code>track_status</code></em> :</span></p></td>
1005
1005
<td>
1006
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to track status after printing
 
1006
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to track status after printing
1007
1007
</td>
1008
1008
</tr>
1009
1009
</tbody>
1015
1015
<a name="gtk-print-operation-set-custom-tab-label"></a><h3>gtk_print_operation_set_custom_tab_label ()</h3>
1016
1016
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_custom_tab_label
1017
1017
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
1018
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
 
1018
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *label</code></em>);</pre>
1019
1019
<p>
1020
1020
Sets the label for the tab holding custom widgets.
1021
1021
</p>
1029
1029
</tr>
1030
1030
<tr>
1031
1031
<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
1032
 
<td> the label to use, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the default label. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
1032
<td> the label to use, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the default label. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1033
1033
</td>
1034
1034
</tr>
1035
1035
</tbody>
1042
1042
<pre class="programlisting"><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationResult" title="enum GtkPrintOperationResult"><span class="returnvalue">GtkPrintOperationResult</span></a>  gtk_print_operation_run        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
1043
1043
                                                         <em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationAction" title="enum GtkPrintOperationAction"><span class="type">GtkPrintOperationAction</span></a> action</code></em>,
1044
1044
                                                         <em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
1045
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 
1045
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
1046
1046
<p>
1047
1047
Runs the print operation, by first letting the user modify
1048
1048
print settings in the print dialog, and then print the document.
1101
1101
33
1102
1102
34
1103
1103
35</pre></td>
1104
 
        <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings </span><span class="symbol">!=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
 
1104
        <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings </span><span class="symbol">!=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
1105
1105
<span class="normal">  </span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-set-print-settings">gtk_print_operation_set_print_settings</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> settings</span><span class="symbol">);</span>
1106
1106
<span class="normal">  </span>
1107
 
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">page_setup </span><span class="symbol">!=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
 
1107
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">page_setup </span><span class="symbol">!=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
1108
1108
<span class="normal">  </span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-set-default-page-setup">gtk_print_operation_set_default_page_setup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> page_setup</span><span class="symbol">);</span>
1109
1109
<span class="normal">  </span>
1110
 
<span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"begin-print"</span><span class="symbol">,</span><span class="normal"> </span>
1111
 
<span class="normal">                  </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">begin_print</span><span class="symbol">),</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">data</span><span class="symbol">);</span>
1112
 
<span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"draw-page"</span><span class="symbol">,</span><span class="normal"> </span>
1113
 
<span class="normal">                  </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">draw_page</span><span class="symbol">),</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">data</span><span class="symbol">);</span>
 
1110
<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"begin-print"</span><span class="symbol">,</span><span class="normal"> </span>
 
1111
<span class="normal">                  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">begin_print</span><span class="symbol">),</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">data</span><span class="symbol">);</span>
 
1112
<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"draw-page"</span><span class="symbol">,</span><span class="normal"> </span>
 
1113
<span class="normal">                  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">draw_page</span><span class="symbol">),</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">data</span><span class="symbol">);</span>
1114
1114
<span class="normal"> </span>
1115
1115
<span class="normal">res </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-run">gtk_print_operation_run</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">,</span><span class="normal"> </span>
1116
1116
<span class="normal">                               GTK_PRINT_OPERATION_ACTION_PRINT_DIALOG</span><span class="symbol">,</span><span class="normal"> </span>
1120
1120
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">res </span><span class="symbol">==</span><span class="normal"> <a href="gtk-High-level-Printing-API.html#GTK-PRINT-OPERATION-RESULT-ERROR:CAPS">GTK_PRINT_OPERATION_RESULT_ERROR</a></span><span class="symbol">)</span>
1121
1121
<span class="normal"> </span><span class="cbracket">{</span>
1122
1122
<span class="normal">   error_dialog </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkMessageDialog.html#gtk-message-dialog-new">gtk_message_dialog_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WINDOW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">parent</span><span class="symbol">),</span>
1123
 
<span class="normal">                                        <a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a></span><span class="symbol">,</span>
1124
 
<span class="normal">                                        <a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a></span><span class="symbol">,</span>
1125
 
<span class="normal">                                        <a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a></span><span class="symbol">,</span>
1126
 
<span class="normal">                                        </span><span class="string">"Error printing file:</span><span class="specialchar">\n</span><span class="string">%s"</span><span class="symbol">,</span>
1127
 
<span class="normal">                                        error</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
1128
 
<span class="normal">   </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error_dialog</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"response"</span><span class="symbol">,</span><span class="normal"> </span>
1129
 
<span class="normal">                     </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="symbol">),</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
1123
<span class="normal">                                 <a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a></span><span class="symbol">,</span>
 
1124
<span class="normal">                         <a href="GtkMessageDialog.html#GTK-MESSAGE-ERROR:CAPS">GTK_MESSAGE_ERROR</a></span><span class="symbol">,</span>
 
1125
<span class="normal">                         <a href="GtkMessageDialog.html#GTK-BUTTONS-CLOSE:CAPS">GTK_BUTTONS_CLOSE</a></span><span class="symbol">,</span>
 
1126
<span class="normal">                         </span><span class="string">"Error printing file:</span><span class="specialchar">\n</span><span class="string">%s"</span><span class="symbol">,</span>
 
1127
<span class="normal">                         error</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
 
1128
<span class="normal">   </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error_dialog</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"response"</span><span class="symbol">,</span><span class="normal"> </span>
 
1129
<span class="normal">                     </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
1130
1130
<span class="normal">   </span><span class="function"><a href="GtkWidget.html#gtk-widget-show">gtk_widget_show</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error_dialog</span><span class="symbol">);</span>
1131
 
<span class="normal">   </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">);</span>
 
1131
<span class="normal">   </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">);</span>
1132
1132
<span class="normal"> </span><span class="cbracket">}</span>
1133
1133
<span class="keyword">else</span><span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">res </span><span class="symbol">==</span><span class="normal"> <a href="gtk-High-level-Printing-API.html#GTK-PRINT-OPERATION-RESULT-APPLY:CAPS">GTK_PRINT_OPERATION_RESULT_APPLY</a></span><span class="symbol">)</span>
1134
1134
<span class="normal"> </span><span class="cbracket">{</span>
1135
 
<span class="normal">   </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings </span><span class="symbol">!=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
1136
 
<span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings</span><span class="symbol">);</span>
1137
 
<span class="normal">   settings </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-get-print-settings">gtk_print_operation_get_print_settings</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">));</span>
 
1135
<span class="normal">   </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings </span><span class="symbol">!=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span>
 
1136
<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">settings</span><span class="symbol">);</span>
 
1137
<span class="normal">   settings </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gtk-High-level-Printing-API.html#gtk-print-operation-get-print-settings">gtk_print_operation_get_print_settings</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">print</span><span class="symbol">));</span>
1138
1138
<span class="normal"> </span><span class="cbracket">}</span></pre></td>
1139
1139
      </tr>
1140
1140
    </tbody>
1167
1167
</tr>
1168
1168
<tr>
1169
1169
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1170
 
<td> Return location for errors, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
1170
<td> Return location for errors, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1171
1171
</td>
1172
1172
</tr>
1173
1173
<tr>
1285
1285
<hr>
1286
1286
<div class="refsect2" title="gtk_print_operation_get_status_string ()">
1287
1287
<a name="gtk-print-operation-get-status-string"></a><h3>gtk_print_operation_get_status_string ()</h3>
1288
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_print_operation_get_status_string
 
1288
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_print_operation_get_status_string
1289
1289
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);</pre>
1290
1290
<p>
1291
1291
Returns a string representation of the status of the 
1318
1318
<hr>
1319
1319
<div class="refsect2" title="gtk_print_operation_is_finished ()">
1320
1320
<a name="gtk-print-operation-is-finished"></a><h3>gtk_print_operation_is_finished ()</h3>
1321
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_is_finished     (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);</pre>
 
1321
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_is_finished     (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);</pre>
1322
1322
<p>
1323
1323
A convenience function to find out if the print operation
1324
1324
is finished, either successfully (<a class="link" href="gtk-High-level-Printing-API.html#GTK-PRINT-STATUS-FINISHED:CAPS"><code class="literal">GTK_PRINT_STATUS_FINISHED</code></a>)
1339
1339
</tr>
1340
1340
<tr>
1341
1341
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1342
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if the print operation is finished.
 
1342
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if the print operation is finished.
1343
1343
 
1344
1344
</td>
1345
1345
</tr>
1352
1352
<a name="gtk-print-operation-set-support-selection"></a><h3>gtk_print_operation_set_support_selection ()</h3>
1353
1353
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_support_selection
1354
1354
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
1355
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> support_selection</code></em>);</pre>
 
1355
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> support_selection</code></em>);</pre>
1356
1356
<p>
1357
1357
Sets whether selection is supported by <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>.
1358
1358
</p>
1367
1367
<tr>
1368
1368
<td><p><span class="term"><em class="parameter"><code>support_selection</code></em> :</span></p></td>
1369
1369
<td>
1370
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to support selection
 
1370
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to support selection
1371
1371
</td>
1372
1372
</tr>
1373
1373
</tbody>
1377
1377
<hr>
1378
1378
<div class="refsect2" title="gtk_print_operation_get_support_selection ()">
1379
1379
<a name="gtk-print-operation-get-support-selection"></a><h3>gtk_print_operation_get_support_selection ()</h3>
1380
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_get_support_selection
 
1380
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_get_support_selection
1381
1381
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);</pre>
1382
1382
<p>
1383
1383
Gets the value of <span class="type">"support-selection"</span> property.
1405
1405
<a name="gtk-print-operation-set-has-selection"></a><h3>gtk_print_operation_set_has_selection ()</h3>
1406
1406
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_has_selection
1407
1407
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
1408
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_selection</code></em>);</pre>
 
1408
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> has_selection</code></em>);</pre>
1409
1409
<p>
1410
1410
Sets whether there is a selection to print.
1411
1411
</p>
1425
1425
<tr>
1426
1426
<td><p><span class="term"><em class="parameter"><code>has_selection</code></em> :</span></p></td>
1427
1427
<td>
1428
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> indicates that a selection exists
 
1428
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> indicates that a selection exists
1429
1429
</td>
1430
1430
</tr>
1431
1431
</tbody>
1435
1435
<hr>
1436
1436
<div class="refsect2" title="gtk_print_operation_get_has_selection ()">
1437
1437
<a name="gtk-print-operation-get-has-selection"></a><h3>gtk_print_operation_get_has_selection ()</h3>
1438
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_get_has_selection
 
1438
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_get_has_selection
1439
1439
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);</pre>
1440
1440
<p>
1441
1441
Gets the value of <span class="type">"has-selection"</span> property.
1463
1463
<a name="gtk-print-operation-set-embed-page-setup"></a><h3>gtk_print_operation_set_embed_page_setup ()</h3>
1464
1464
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_set_embed_page_setup
1465
1465
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>,
1466
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> embed</code></em>);</pre>
 
1466
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> embed</code></em>);</pre>
1467
1467
<p>
1468
1468
Embed page size combo box and orientation combo box into page setup page.
1469
1469
Selected page setup is stored as default page setup in <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>.
1479
1479
<tr>
1480
1480
<td><p><span class="term"><em class="parameter"><code>embed</code></em> :</span></p></td>
1481
1481
<td>
1482
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to embed page setup selection in the <span class="type">GtkPrintDialog</span>
 
1482
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to embed page setup selection in the <span class="type">GtkPrintDialog</span>
1483
1483
</td>
1484
1484
</tr>
1485
1485
</tbody>
1489
1489
<hr>
1490
1490
<div class="refsect2" title="gtk_print_operation_get_embed_page_setup ()">
1491
1491
<a name="gtk-print-operation-get-embed-page-setup"></a><h3>gtk_print_operation_get_embed_page_setup ()</h3>
1492
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_get_embed_page_setup
 
1492
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_get_embed_page_setup
1493
1493
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *op</code></em>);</pre>
1494
1494
<p>
1495
1495
Gets the value of <span class="type">"embed-page-setup"</span> property.
1561
1561
<div class="refsect2" title="GtkPageSetupDoneFunc ()">
1562
1562
<a name="GtkPageSetupDoneFunc"></a><h3>GtkPageSetupDoneFunc ()</h3>
1563
1563
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkPageSetupDoneFunc)             (<em class="parameter"><code><a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> *page_setup</code></em>,
1564
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
1564
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1565
1565
<p>
1566
1566
The type of function that is passed to <a class="link" href="gtk-High-level-Printing-API.html#gtk-print-run-page-setup-dialog-async" title="gtk_print_run_page_setup_dialog_async ()"><code class="function">gtk_print_run_page_setup_dialog_async()</code></a>.
1567
1567
This function will be called when the page setup dialog is dismissed, and
1592
1592
                                                         <em class="parameter"><code><a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a> *page_setup</code></em>,
1593
1593
                                                         <em class="parameter"><code><a class="link" href="GtkPrintSettings.html" title="GtkPrintSettings"><span class="type">GtkPrintSettings</span></a> *settings</code></em>,
1594
1594
                                                         <em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPageSetupDoneFunc" title="GtkPageSetupDoneFunc ()"><span class="type">GtkPageSetupDoneFunc</span></a> done_cb</code></em>,
1595
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
 
1595
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1596
1596
<p>
1597
1597
Runs a page setup dialog, letting the user modify the values from <em class="parameter"><code>page_setup</code></em>. 
1598
1598
</p>
1606
1606
<tbody>
1607
1607
<tr>
1608
1608
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
1609
 
<td> transient parent, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
1609
<td> transient parent, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1610
1610
</td>
1611
1611
</tr>
1612
1612
<tr>
1613
1613
<td><p><span class="term"><em class="parameter"><code>page_setup</code></em> :</span></p></td>
1614
 
<td> an existing <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
1614
<td> an existing <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1615
1615
</td>
1616
1616
</tr>
1617
1617
<tr>
1664
1664
<hr>
1665
1665
<div class="refsect2" title="gtk_print_operation_preview_is_selected ()">
1666
1666
<a name="gtk-print-operation-preview-is-selected"></a><h3>gtk_print_operation_preview_is_selected ()</h3>
1667
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_preview_is_selected
 
1667
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_print_operation_preview_is_selected
1668
1668
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationPreview"><span class="type">GtkPrintOperationPreview</span></a> *preview</code></em>,
1669
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> page_nr</code></em>);</pre>
 
1669
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> page_nr</code></em>);</pre>
1670
1670
<p>
1671
1671
Returns whether the given page is included in the set of pages that
1672
1672
have been selected for printing.
1686
1686
</tr>
1687
1687
<tr>
1688
1688
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1689
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the page has been selected for printing
 
1689
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the page has been selected for printing
1690
1690
 
1691
1691
</td>
1692
1692
</tr>
1699
1699
<a name="gtk-print-operation-preview-render-page"></a><h3>gtk_print_operation_preview_render_page ()</h3>
1700
1700
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_print_operation_preview_render_page
1701
1701
                                                        (<em class="parameter"><code><a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationPreview"><span class="type">GtkPrintOperationPreview</span></a> *preview</code></em>,
1702
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> page_nr</code></em>);</pre>
 
1702
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> page_nr</code></em>);</pre>
1703
1703
<p>
1704
1704
Renders a page to the preview, using the print context that
1705
1705
was passed to the <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation-preview" title='The "preview" signal'><span class="type">"preview"</span></a> handler together
1735
1735
<a name="gtk-High-level-Printing-API.property-details"></a><h2>Property Details</h2>
1736
1736
<div class="refsect2" title='The "allow-async" property'>
1737
1737
<a name="GtkPrintOperation--allow-async"></a><h3>The <code class="literal">"allow-async"</code> property</h3>
1738
 
<pre class="programlisting">  "allow-async"              <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1738
<pre class="programlisting">  "allow-async"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1739
1739
<p>
1740
1740
Determines whether the print operation may run asynchronously or not.
1741
1741
</p>
1756
1756
<hr>
1757
1757
<div class="refsect2" title='The "current-page" property'>
1758
1758
<a name="GtkPrintOperation--current-page"></a><h3>The <code class="literal">"current-page"</code> property</h3>
1759
 
<pre class="programlisting">  "current-page"             <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1759
<pre class="programlisting">  "current-page"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1760
1760
<p>
1761
1761
The current page in the document.
1762
1762
</p>
1774
1774
<hr>
1775
1775
<div class="refsect2" title='The "custom-tab-label" property'>
1776
1776
<a name="GtkPrintOperation--custom-tab-label"></a><h3>The <code class="literal">"custom-tab-label"</code> property</h3>
1777
 
<pre class="programlisting">  "custom-tab-label"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
1777
<pre class="programlisting">  "custom-tab-label"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
1778
1778
<p>
1779
1779
Used as the label of the tab containing custom widgets.
1780
1780
Note that this property may be ignored on some platforms.
1781
1781
</p>
1782
1782
<p>
1783
 
If this is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, GTK+ uses a default label.
 
1783
If this is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, GTK+ uses a default label.
1784
1784
</p>
1785
1785
<p>Default value: NULL</p>
1786
1786
<p class="since">Since 2.10</p>
1802
1802
<hr>
1803
1803
<div class="refsect2" title='The "embed-page-setup" property'>
1804
1804
<a name="GtkPrintOperation--embed-page-setup"></a><h3>The <code class="literal">"embed-page-setup"</code> property</h3>
1805
 
<pre class="programlisting">  "embed-page-setup"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1805
<pre class="programlisting">  "embed-page-setup"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1806
1806
<p>
1807
 
If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, page size combo box and orientation combo box are embedded into page setup page.
 
1807
If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, page size combo box and orientation combo box are embedded into page setup page.
1808
1808
</p>
1809
1809
<p>Default value: FALSE</p>
1810
1810
<p class="since">Since 2.18</p>
1812
1812
<hr>
1813
1813
<div class="refsect2" title='The "export-filename" property'>
1814
1814
<a name="GtkPrintOperation--export-filename"></a><h3>The <code class="literal">"export-filename"</code> property</h3>
1815
 
<pre class="programlisting">  "export-filename"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
1815
<pre class="programlisting">  "export-filename"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
1816
1816
<p>
1817
1817
The name of a file to generate instead of showing the print dialog. 
1818
1818
Currently, PDF is the only supported format.
1832
1832
<hr>
1833
1833
<div class="refsect2" title='The "has-selection" property'>
1834
1834
<a name="GtkPrintOperation--has-selection"></a><h3>The <code class="literal">"has-selection"</code> property</h3>
1835
 
<pre class="programlisting">  "has-selection"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1835
<pre class="programlisting">  "has-selection"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1836
1836
<p>
1837
1837
Determines whether there is a selection in your application.
1838
1838
This can allow your application to print the selection.
1844
1844
<hr>
1845
1845
<div class="refsect2" title='The "job-name" property'>
1846
1846
<a name="GtkPrintOperation--job-name"></a><h3>The <code class="literal">"job-name"</code> property</h3>
1847
 
<pre class="programlisting">  "job-name"                 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
1847
<pre class="programlisting">  "job-name"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
1848
1848
<p>
1849
1849
A string used to identify the job (e.g. in monitoring 
1850
1850
applications like eggcups). 
1859
1859
<hr>
1860
1860
<div class="refsect2" title='The "n-pages" property'>
1861
1861
<a name="GtkPrintOperation--n-pages"></a><h3>The <code class="literal">"n-pages"</code> property</h3>
1862
 
<pre class="programlisting">  "n-pages"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1862
<pre class="programlisting">  "n-pages"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1863
1863
<p>
1864
1864
The number of pages in the document. 
1865
1865
</p>
1882
1882
<hr>
1883
1883
<div class="refsect2" title='The "n-pages-to-print" property'>
1884
1884
<a name="GtkPrintOperation--n-pages-to-print"></a><h3>The <code class="literal">"n-pages-to-print"</code> property</h3>
1885
 
<pre class="programlisting">  "n-pages-to-print"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
1885
<pre class="programlisting">  "n-pages-to-print"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1886
1886
<p>
1887
1887
The number of pages that will be printed.
1888
1888
</p>
1916
1916
<hr>
1917
1917
<div class="refsect2" title='The "show-progress" property'>
1918
1918
<a name="GtkPrintOperation--show-progress"></a><h3>The <code class="literal">"show-progress"</code> property</h3>
1919
 
<pre class="programlisting">  "show-progress"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1919
<pre class="programlisting">  "show-progress"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1920
1920
<p>
1921
1921
Determines whether to show a progress dialog during the 
1922
1922
print operation.
1937
1937
<hr>
1938
1938
<div class="refsect2" title='The "status-string" property'>
1939
1939
<a name="GtkPrintOperation--status-string"></a><h3>The <code class="literal">"status-string"</code> property</h3>
1940
 
<pre class="programlisting">  "status-string"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read</pre>
 
1940
<pre class="programlisting">  "status-string"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read</pre>
1941
1941
<p>
1942
1942
A string representation of the status of the print operation. 
1943
1943
The string is translated and suitable for displaying the print 
1953
1953
<hr>
1954
1954
<div class="refsect2" title='The "support-selection" property'>
1955
1955
<a name="GtkPrintOperation--support-selection"></a><h3>The <code class="literal">"support-selection"</code> property</h3>
1956
 
<pre class="programlisting">  "support-selection"        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1956
<pre class="programlisting">  "support-selection"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1957
1957
<p>
1958
 
If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the print operation will support print of selection.
 
1958
If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the print operation will support print of selection.
1959
1959
This allows the print dialog to show a "Selection" button.
1960
1960
</p>
1961
1961
<p>Default value: FALSE</p>
1964
1964
<hr>
1965
1965
<div class="refsect2" title='The "track-print-status" property'>
1966
1966
<a name="GtkPrintOperation--track-print-status"></a><h3>The <code class="literal">"track-print-status"</code> property</h3>
1967
 
<pre class="programlisting">  "track-print-status"       <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1967
<pre class="programlisting">  "track-print-status"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1968
1968
<p>
1969
 
If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the print operation will try to continue report on 
 
1969
If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the print operation will try to continue report on 
1970
1970
the status of the print job in the printer queues and printer. 
1971
1971
This can allow your application to show things like "out of paper" 
1972
1972
issues, and when the print job actually reaches the printer. 
1991
1991
<hr>
1992
1992
<div class="refsect2" title='The "use-full-page" property'>
1993
1993
<a name="GtkPrintOperation--use-full-page"></a><h3>The <code class="literal">"use-full-page"</code> property</h3>
1994
 
<pre class="programlisting">  "use-full-page"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1994
<pre class="programlisting">  "use-full-page"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1995
1995
<p>
1996
 
If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the transformation for the cairo context obtained 
 
1996
If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the transformation for the cairo context obtained 
1997
1997
from <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a> puts the origin at the top left corner 
1998
1998
of the page (which may not be the top left corner of the sheet, 
1999
1999
depending on page orientation and the number of pages per sheet). 
2010
2010
<a name="GtkPrintOperation-begin-print"></a><h3>The <code class="literal">"begin-print"</code> signal</h3>
2011
2011
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
2012
2012
                                                        <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a>   *context,
2013
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
 
2013
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
2014
2014
<p>
2015
2015
Emitted after the user has finished changing print settings
2016
2016
in the dialog, before the actual rendering starts.
2044
2044
<hr>
2045
2045
<div class="refsect2" title='The "create-custom-widget" signal'>
2046
2046
<a name="GtkPrintOperation-create-custom-widget"></a><h3>The <code class="literal">"create-custom-widget"</code> signal</h3>
2047
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a>*            user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
2048
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
 
2047
<pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="returnvalue">GObject</span></a>*            user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
 
2048
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
2049
2049
<p>
2050
2050
Emitted when displaying the print dialog. If you return a
2051
2051
widget in a handler for this signal it will be added to a custom
2074
2074
<tr>
2075
2075
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2076
2076
<td> A custom widget that gets embedded in the print dialog,
2077
 
         or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
2077
         or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2078
2078
 
2079
2079
</td>
2080
2080
</tr>
2087
2087
<a name="GtkPrintOperation-custom-widget-apply"></a><h3>The <code class="literal">"custom-widget-apply"</code> signal</h3>
2088
2088
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
2089
2089
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>         *widget,
2090
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
 
2090
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
2091
2091
<p>
2092
2092
Emitted right before <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation-begin-print" title='The "begin-print" signal'><span class="type">"begin-print"</span></a> if you added
2093
2093
a custom widget in the <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation-create-custom-widget" title='The "create-custom-widget" signal'><span class="type">"create-custom-widget"</span></a> handler. 
2121
2121
<a name="GtkPrintOperation-done"></a><h3>The <code class="literal">"done"</code> signal</h3>
2122
2122
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>      *operation,
2123
2123
                                                        <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationResult" title="enum GtkPrintOperationResult"><span class="type">GtkPrintOperationResult</span></a> result,
2124
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>                user_data)      : Run Last</pre>
 
2124
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>                user_data)      : Run Last</pre>
2125
2125
<p>
2126
2126
Emitted when the print operation run has finished doing
2127
2127
everything required for printing. 
2133
2133
</p>
2134
2134
<p>
2135
2135
If you enabled print status tracking then 
2136
 
<a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-is-finished" title="gtk_print_operation_is_finished ()"><code class="function">gtk_print_operation_is_finished()</code></a> may still return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
 
2136
<a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-is-finished" title="gtk_print_operation_is_finished ()"><code class="function">gtk_print_operation_is_finished()</code></a> may still return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> 
2137
2137
after <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation-done" title='The "done" signal'><span class="type">"done"</span></a> was emitted.
2138
2138
</p>
2139
2139
<div class="variablelist"><table border="0">
2162
2162
<a name="GtkPrintOperation-draw-page"></a><h3>The <code class="literal">"draw-page"</code> signal</h3>
2163
2163
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
2164
2164
                                                        <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a>   *context,
2165
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>               page_nr,
2166
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
 
2165
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>               page_nr,
 
2166
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
2167
2167
<p>
2168
2168
Emitted for every page that is printed. The signal handler
2169
2169
must render the <em class="parameter"><code>page_nr</code></em>'s page onto the cairo context obtained
2212
2212
37
2213
2213
38</pre></td>
2214
2214
        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
2215
 
<span class="function">draw_page</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gtk-High-level-Printing-API.html#GtkPrintOperation">GtkPrintOperation</a> </span><span class="symbol">*</span><span class="normal">operation</span><span class="symbol">,</span>
2216
 
<span class="normal">           <a href="GtkPrintContext.html">GtkPrintContext</a>   </span><span class="symbol">*</span><span class="normal">context</span><span class="symbol">,</span>
2217
 
<span class="normal">           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a>               page_nr</span><span class="symbol">,</span>
2218
 
<span class="normal">           <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a>           user_data</span><span class="symbol">)</span>
 
2215
<span class="function">draw_page</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkPrintOperation</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">operation</span><span class="symbol">,</span>
 
2216
<span class="normal">           </span><span class="usertype">GtkPrintContext</span><span class="normal">   </span><span class="symbol">*</span><span class="normal">context</span><span class="symbol">,</span>
 
2217
<span class="normal">           </span><span class="usertype">gint</span><span class="normal">               page_nr</span><span class="symbol">,</span>
 
2218
<span class="normal">           </span><span class="usertype">gpointer</span><span class="normal">           user_data</span><span class="symbol">)</span>
2219
2219
<span class="cbracket">{</span>
2220
 
<span class="normal">  <a href="/usr/share/gtk-doc/html/cairo/cairo-context.html#cairo-t">cairo_t</a> </span><span class="symbol">*</span><span class="normal">cr</span><span class="symbol">;</span>
2221
 
<span class="normal">  <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout">PangoLayout</a> </span><span class="symbol">*</span><span class="normal">layout</span><span class="symbol">;</span>
2222
 
<span class="normal">  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a> width</span><span class="symbol">,</span><span class="normal"> text_height</span><span class="symbol">;</span>
2223
 
<span class="normal">  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> layout_height</span><span class="symbol">;</span>
2224
 
<span class="normal">  <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> </span><span class="symbol">*</span><span class="normal">desc</span><span class="symbol">;</span>
 
2220
<span class="normal">  </span><span class="usertype">cairo_t</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cr</span><span class="symbol">;</span>
 
2221
<span class="normal">  </span><span class="usertype">PangoLayout</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">layout</span><span class="symbol">;</span>
 
2222
<span class="normal">  </span><span class="usertype">gdouble</span><span class="normal"> width</span><span class="symbol">,</span><span class="normal"> text_height</span><span class="symbol">;</span>
 
2223
<span class="normal">  </span><span class="usertype">gint</span><span class="normal"> layout_height</span><span class="symbol">;</span>
 
2224
<span class="normal">  </span><span class="usertype">PangoFontDescription</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">desc</span><span class="symbol">;</span>
2225
2225
<span class="normal">  </span>
2226
2226
<span class="normal">  cr </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkPrintContext.html#gtk-print-context-get-cairo-context">gtk_print_context_get_cairo_context</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">);</span>
2227
2227
<span class="normal">  width </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkPrintContext.html#gtk-print-context-get-width">gtk_print_context_get_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">context</span><span class="symbol">);</span>
2240
2240
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-set-text">pango_layout_set_text</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"some text"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">-</span><span class="number">1</span><span class="symbol">);</span>
2241
2241
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-set-width">pango_layout_set_width</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">,</span><span class="normal"> width </span><span class="symbol">*</span><span class="normal"> <a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS">PANGO_SCALE</a></span><span class="symbol">);</span>
2242
2242
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-set-alignment">pango_layout_set_alignment</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PANGO-ALIGN-CENTER:CAPS">PANGO_ALIGN_CENTER</a></span><span class="symbol">);</span>
2243
 
<span class="normal">                         </span>
2244
 
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-size">pango_layout_get_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">layout_height</span><span class="symbol">);</span>
2245
 
<span class="normal">  text_height </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gdouble">gdouble</a></span><span class="symbol">)</span><span class="normal">layout_height </span><span class="symbol">/</span><span class="normal"> <a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS">PANGO_SCALE</a></span><span class="symbol">;</span>
 
2243
<span class="normal">                  </span>
 
2244
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-size">pango_layout_get_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">layout_height</span><span class="symbol">);</span>
 
2245
<span class="normal">  text_height </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble">gdouble</a></span><span class="symbol">)</span><span class="normal">layout_height </span><span class="symbol">/</span><span class="normal"> <a href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS">PANGO_SCALE</a></span><span class="symbol">;</span>
2246
2246
<span class="normal">  </span>
2247
2247
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/cairo/cairo-paths.html#cairo-move-to">cairo_move_to</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> width </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">,</span><span class="normal">  </span><span class="symbol">(</span><span class="normal">HEADER_HEIGHT </span><span class="symbol">-</span><span class="normal"> text_height</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">/</span><span class="normal"> </span><span class="number">2</span><span class="symbol">);</span>
2248
2248
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/pango/pango-Cairo-Rendering.html#pango-cairo-show-layout">pango_cairo_show_layout</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">cr</span><span class="symbol">,</span><span class="normal"> layout</span><span class="symbol">);</span>
2249
2249
<span class="normal">  </span>
2250
 
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">);</span>
 
2250
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">layout</span><span class="symbol">);</span>
2251
2251
<span class="cbracket">}</span></pre></td>
2252
2252
      </tr>
2253
2253
    </tbody>
2293
2293
<a name="GtkPrintOperation-end-print"></a><h3>The <code class="literal">"end-print"</code> signal</h3>
2294
2294
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
2295
2295
                                                        <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a>   *context,
2296
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
 
2296
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
2297
2297
<p>
2298
2298
Emitted after all pages have been rendered. 
2299
2299
A handler for this signal can clean up any resources that have
2323
2323
<hr>
2324
2324
<div class="refsect2" title='The "paginate" signal'>
2325
2325
<a name="GtkPrintOperation-paginate"></a><h3>The <code class="literal">"paginate"</code> signal</h3>
2326
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
 
2326
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
2327
2327
                                                        <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a>   *context,
2328
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
 
2328
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
2329
2329
<p>
2330
2330
Emitted after the <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation-begin-print" title='The "begin-print" signal'><span class="type">"begin-print"</span></a> signal, but before 
2331
2331
the actual rendering starts. It keeps getting emitted until a connected 
2332
 
signal handler returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
 
2332
signal handler returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
2333
2333
</p>
2334
2334
<p>
2335
2335
The ::paginate signal is intended to be used for paginating a document
2336
2336
in small chunks, to avoid blocking the user interface for a long
2337
2337
time. The signal handler should update the number of pages using
2338
 
<a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-n-pages" title="gtk_print_operation_set_n_pages ()"><code class="function">gtk_print_operation_set_n_pages()</code></a>, and return <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the document
 
2338
<a class="link" href="gtk-High-level-Printing-API.html#gtk-print-operation-set-n-pages" title="gtk_print_operation_set_n_pages ()"><code class="function">gtk_print_operation_set_n_pages()</code></a>, and return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the document
2339
2339
has been completely paginated.
2340
2340
</p>
2341
2341
<p>
2362
2362
</tr>
2363
2363
<tr>
2364
2364
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2365
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if pagination is complete
 
2365
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if pagination is complete
2366
2366
 
2367
2367
</td>
2368
2368
</tr>
2373
2373
<hr>
2374
2374
<div class="refsect2" title='The "preview" signal'>
2375
2375
<a name="GtkPrintOperation-preview"></a><h3>The <code class="literal">"preview"</code> signal</h3>
2376
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>        *operation,
 
2376
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a>        *operation,
2377
2377
                                                        <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationPreview"><span class="type">GtkPrintOperationPreview</span></a> *preview,
2378
2378
                                                        <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a>          *context,
2379
2379
                                                        <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a>                *parent,
2380
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>                  user_data)      : Run Last</pre>
 
2380
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>                  user_data)      : Run Last</pre>
2381
2381
<p>
2382
2382
Gets emitted when a preview is requested from the native dialog.
2383
2383
</p>
2387
2387
</p>
2388
2388
<p>
2389
2389
To implement a custom print preview, an application must return
2390
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> from its handler for this signal. In order to use the
 
2390
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> from its handler for this signal. In order to use the
2391
2391
provided <em class="parameter"><code>context</code></em> for the preview implementation, it must be
2392
2392
given a suitable cairo context with <a class="link" href="GtkPrintContext.html#gtk-print-context-set-cairo-context" title="gtk_print_context_set_cairo_context ()"><code class="function">gtk_print_context_set_cairo_context()</code></a>.
2393
2393
</p>
2419
2419
</tr>
2420
2420
<tr>
2421
2421
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
2422
 
<td> the <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> to use as window parent, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
2422
<td> the <a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> to use as window parent, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2423
2423
</td>
2424
2424
</tr>
2425
2425
<tr>
2428
2428
</tr>
2429
2429
<tr>
2430
2430
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2431
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the listener wants to take over control of the preview
 
2431
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the listener wants to take over control of the preview
2432
2432
 
2433
2433
</td>
2434
2434
</tr>
2441
2441
<a name="GtkPrintOperation-request-page-setup"></a><h3>The <code class="literal">"request-page-setup"</code> signal</h3>
2442
2442
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
2443
2443
                                                        <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a>   *context,
2444
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>               page_nr,
 
2444
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>               page_nr,
2445
2445
                                                        <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>      *setup,
2446
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
 
2446
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
2447
2447
<p>
2448
2448
Emitted once for every page that is printed, to give
2449
2449
the application a chance to modify the page setup. Any changes 
2484
2484
<div class="refsect2" title='The "status-changed" signal'>
2485
2485
<a name="GtkPrintOperation-status-changed"></a><h3>The <code class="literal">"status-changed"</code> signal</h3>
2486
2486
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperation"><span class="type">GtkPrintOperation</span></a> *operation,
2487
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
 
2487
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
2488
2488
<p>
2489
2489
Emitted at between the various phases of the print operation.
2490
2490
See <a class="link" href="gtk-High-level-Printing-API.html#GtkPrintStatus" title="enum GtkPrintStatus"><span class="type">GtkPrintStatus</span></a> for the phases that are being discriminated.
2514
2514
                                                        <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>         *widget,
2515
2515
                                                        <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>      *setup,
2516
2516
                                                        <a class="link" href="GtkPrintSettings.html" title="GtkPrintSettings"><span class="type">GtkPrintSettings</span></a>  *settings,
2517
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
 
2517
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : Run Last</pre>
2518
2518
<p>
2519
2519
Emitted after change of selected printer. The actual page setup and
2520
2520
print settings are passed to the custom widget, which can actualize
2557
2557
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationPreview"><span class="type">GtkPrintOperationPreview</span></a> *preview,
2558
2558
                                                        <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a>          *context,
2559
2559
                                                        <a class="link" href="GtkPageSetup.html" title="GtkPageSetup"><span class="type">GtkPageSetup</span></a>             *page_setup,
2560
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>                  user_data)       : Run Last</pre>
 
2560
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>                  user_data)       : Run Last</pre>
2561
2561
<p>
2562
2562
The ::got-page-size signal is emitted once for each page
2563
2563
that gets rendered to the preview. 
2597
2597
<a name="GtkPrintOperationPreview-ready"></a><h3>The <code class="literal">"ready"</code> signal</h3>
2598
2598
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gtk-High-level-Printing-API.html#GtkPrintOperationPreview"><span class="type">GtkPrintOperationPreview</span></a> *preview,
2599
2599
                                                        <a class="link" href="GtkPrintContext.html" title="GtkPrintContext"><span class="type">GtkPrintContext</span></a>          *context,
2600
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>                  user_data)      : Run Last</pre>
 
2600
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>                  user_data)      : Run Last</pre>
2601
2601
<p>
2602
2602
The ::ready signal gets emitted once per preview operation,
2603
2603
before the first page is rendered.