← 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/tmpl/gtkprintcontext.sgml

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-05-04 12:24:25 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070504122425-0m8midgzrp40y8w2
Tags: 2.10.12-1ubuntu1
* Sync with Debian
* New upstream version:
  Fixed bugs:
  - 379414 file chooser warnings when changing path in the entry
  - 418585 GtkFileChooserDefault sizing code is not DPI independent
  - 419568 Crash in search if start with special letter
  - 435062 build dies with icon cache validation
  - 379399 Segfault to call gtk_print_operation_run twice.
  - 387889 cups backend has problems when there are too many printers
  - 418531 invalid read to gtkicontheme.c gtk_icon_theme_lookup_icon...
  - 423916 crash in color scheme code
  - 424042 Segmentation fault while quickly pressing Alt+arrows
  - 415260 Protect against negative indices when setting values in G...
  - 419171 XGetVisualInfo() may not set nxvisuals
  - 128852 Gdk cursors don't look good on win32
  - 344657 Ctrl-H doesn't toggle "Show Hidden Files" setting
  - 345345 PrintOperation::paginate is not emitted for class handler
  - 347567 GtkPrintOperation::end-print is not emitted if it's cance...
  - 369112 gtk_ui_manager_add_ui should accept unnamed separator
  - 392015 Selected menu item invisible on Windows Vista
  - 399253 MS-Windows Theme Bottom Tab placement rendering glitches
  - 399425 gtk_input_dialog_fill_axes() adds child to gtkscrolledwin...
  - 403251 [patch] little memory leak in GtkPrintJob
  - 403267 [patch] memory leak in GtkPageSetupUnixDialog
  - 403470 MS-Windows Theme tab placement other than on top leaks a ...
  - 404506 Windows system fonts that have multi-byte font names cann...
  - 405089 Incorrect window placement for GtkEventBox private window
  - 405515 Minor leak in gtkfilesystemmodel.c
  - 405539 gdk_pixbuf_save() for PNG saver can return FALSE without ...
  - 415681 gdk_window_clear_area includes an extra line and column o...
  - 418219 GtkRecentChooser should apply filter before sorting and c...
  - 418403 Scroll to printer after selecting it from settings
  - 421985 _gtk_print_operation_platform_backend_launch_preview
  - 421990 gtk_print_job_get_surface
  - 421993 gtk_print_operation_init
  - 423064 Conditional jump or move depends on uninitialised value(s...
  - 423722 Fix printing header in gtk-demo
  - 424168 gtk_print_operation_run on async preview
  - 425655 Don't install gtk+-unix-print-2.0.pc on non-UNIX platforms
  - 425786 GDK segfaults if XineramaQueryScreens fails
  - 428665 Lpr Backend gets stuck in infinite loop during gtk_enumer...
  - 429902 GtkPrintOperation leaks cairo contextes
  - 431997 First delay of GdkPixbufAnimationIter is wrong
  - 433242 Inconsistent scroll arrow position calculations
  - 433972 Placing gtk.Expander inside a gtk.TextView() changes gtk....
  - 434261 _gtk_toolbar_elide_underscores incorrectly handles some s...
  - 383354 ctrl-L should make 'Location' entry disappear
  - 418673 gtk_recent_manager_add_item
  - 429732 gtk_accel_group_finalize accesses invalid memory
  - 435028 WM_CLIENT_LEADER is wrong on the leader_window
  - 431067 Background of the header window is not updated
  - 338843 add recent files support inside the ui manager
  - 148535 add drop shadow to menus, tooltips, etc. under Windows XP
* debian/control.in:
  - Conflicts on ubuntulooks (<= 0.9.11-1)
* debian/patches/15_default-fallback-icon-theme.patch:
  - patch from Debian, fallback on gnome icon theme

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/tmpl/gtkprintcontext.sgml
 
1
<!-- ##### SECTION Title ##### -->
 
2
GtkPrintContext
 
3
 
 
4
<!-- ##### SECTION Short_Description ##### -->
 
5
Encapsulates context for drawing pages
 
6
 
 
7
<!-- ##### SECTION Long_Description ##### -->
 
8
<para>
 
9
A GtkPrintContext encapsulates context information that is required when
 
10
drawing pages for printing, such as the cairo context and important 
 
11
parameters like page size and resolution. It also lets you easily
 
12
create #PangoLayout and #PangoContext objects that match the font metrics 
 
13
of the cairo surface.
 
14
</para>
 
15
<para>
 
16
GtkPrintContext objects gets passed to the ::begin-print, ::end-print, 
 
17
::request-page-setup and ::draw-page signals on the #GtkPrintOperation.
 
18
</para>
 
19
 
 
20
<example>
 
21
<title>Using GtkPrintContext in a ::draw-page callback</title>
 
22
<programlisting>
 
23
static void
 
24
draw_page (GtkPrintOperation *operation,
 
25
           GtkPrintContext   *context,
 
26
           int                page_nr)
 
27
{
 
28
  cairo_t *cr;
 
29
  PangoLayout *layout;
 
30
  PangoFontDescription *desc;
 
31
  
 
32
  cr = gtk_print_context_get_cairo_context (context);
 
33
 
 
34
  /* Draw a red rectangle, as wide as the paper (inside the margins) */
 
35
  cairo_set_source_rgb (cr, 1.0, 0, 0);
 
36
  cairo_rectangle (cr, 0, 0, gtk_print_context_get_width (context), 50);
 
37
  
 
38
  cairo_fill (cr);
 
39
 
 
40
  /* Draw some lines */
 
41
  cairo_move_to (cr, 20, 10);
 
42
  cairo_line_to (cr, 40, 20);
 
43
  cairo_arc (cr, 60, 60, 20, 0, M_PI);
 
44
  cairo_line_to (cr, 80, 20);
 
45
  
 
46
  cairo_set_source_rgb (cr, 0, 0, 0);
 
47
  cairo_set_line_width (cr, 5);
 
48
  cairo_set_line_cap (cr, CAIRO_LINE_CAP_ROUND);
 
49
  cairo_set_line_join (cr, CAIRO_LINE_JOIN_ROUND);
 
50
  
 
51
  cairo_stroke (cr);
 
52
 
 
53
  /* Draw some text */ 
 
54
  layout = gtk_print_context_create_layout (context);
 
55
  pango_layout_set_text (layout, "Hello World! Printing is easy", -1);
 
56
  desc = pango_font_description_from_string ("sans 28");
 
57
  pango_layout_set_font_description (layout, desc);
 
58
  pango_font_description_free (desc);
 
59
 
 
60
  cairo_move_to (cr, 30, 20);
 
61
  pango_cairo_layout_path (cr, layout);
 
62
 
 
63
  /* Font Outline */
 
64
  cairo_set_source_rgb (cr, 0.93, 1.0, 0.47);
 
65
  cairo_set_line_width (cr, 0.5);
 
66
  cairo_stroke_preserve (cr);
 
67
 
 
68
  /* Font Fill */
 
69
  cairo_set_source_rgb (cr, 0, 0.0, 1.0);
 
70
  cairo_fill (cr);
 
71
  
 
72
  g_object_unref (layout);
 
73
}
 
74
</programlisting>
 
75
</example>
 
76
 
 
77
<para>
 
78
Printing support was added in GTK+ 2.10.
 
79
</para>
 
80
 
 
81
<!-- ##### SECTION See_Also ##### -->
 
82
<para>
 
83
 
 
84
</para>
 
85
 
 
86
<!-- ##### SECTION Stability_Level ##### -->
 
87
 
 
88
 
 
89
<!-- ##### STRUCT GtkPrintContext ##### -->
 
90
<para>
 
91
 
 
92
</para>
 
93
 
 
94
 
 
95
<!-- ##### FUNCTION gtk_print_context_get_cairo_context ##### -->
 
96
<para>
 
97
 
 
98
</para>
 
99
 
 
100
@context: 
 
101
@Returns: 
 
102
 
 
103
 
 
104
<!-- ##### FUNCTION gtk_print_context_set_cairo_context ##### -->
 
105
<para>
 
106
 
 
107
</para>
 
108
 
 
109
@context: 
 
110
@cr: 
 
111
@dpi_x: 
 
112
@dpi_y: 
 
113
 
 
114
 
 
115
<!-- ##### FUNCTION gtk_print_context_get_page_setup ##### -->
 
116
<para>
 
117
 
 
118
</para>
 
119
 
 
120
@context: 
 
121
@Returns: 
 
122
 
 
123
 
 
124
<!-- ##### FUNCTION gtk_print_context_get_width ##### -->
 
125
<para>
 
126
 
 
127
</para>
 
128
 
 
129
@context: 
 
130
@Returns: 
 
131
 
 
132
 
 
133
<!-- ##### FUNCTION gtk_print_context_get_height ##### -->
 
134
<para>
 
135
 
 
136
</para>
 
137
 
 
138
@context: 
 
139
@Returns: 
 
140
 
 
141
 
 
142
<!-- ##### FUNCTION gtk_print_context_get_dpi_x ##### -->
 
143
<para>
 
144
 
 
145
</para>
 
146
 
 
147
@context: 
 
148
@Returns: 
 
149
 
 
150
 
 
151
<!-- ##### FUNCTION gtk_print_context_get_dpi_y ##### -->
 
152
<para>
 
153
 
 
154
</para>
 
155
 
 
156
@context: 
 
157
@Returns: 
 
158
 
 
159
 
 
160
<!-- ##### FUNCTION gtk_print_context_get_pango_fontmap ##### -->
 
161
<para>
 
162
 
 
163
</para>
 
164
 
 
165
@context: 
 
166
@Returns: 
 
167
 
 
168
 
 
169
<!-- ##### FUNCTION gtk_print_context_create_pango_context ##### -->
 
170
<para>
 
171
 
 
172
</para>
 
173
 
 
174
@context: 
 
175
@Returns: 
 
176
 
 
177
 
 
178
<!-- ##### FUNCTION gtk_print_context_create_pango_layout ##### -->
 
179
<para>
 
180
 
 
181
</para>
 
182
 
 
183
@context: 
 
184
@Returns: 
 
185
 
 
186