← Back to branch summary

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

« back to all changes in this revision

Viewing changes to docs/tutorial/html/x1941.html

  • 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/tutorial/html/x1941.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>Functions</TITLE
 
6
><META
 
7
NAME="GENERATOR"
 
8
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 
9
REL="HOME"
 
10
TITLE="GTK+ 2.0 Tutorial"
 
11
HREF="book1.html"><LINK
 
12
REL="UP"
 
13
TITLE="Drag-and-drop (DND)"
 
14
HREF="c1901.html"><LINK
 
15
REL="PREVIOUS"
 
16
TITLE="Properties"
 
17
HREF="x1923.html"><LINK
 
18
REL="NEXT"
 
19
TITLE="GLib"
 
20
HREF="c2025.html"></HEAD
 
21
><BODY
 
22
CLASS="SECT1"
 
23
BGCOLOR="#FFFFFF"
 
24
TEXT="#000000"
 
25
LINK="#0000FF"
 
26
VLINK="#840084"
 
27
ALINK="#0000FF"
 
28
><DIV
 
29
CLASS="NAVHEADER"
 
30
><TABLE
 
31
SUMMARY="Header navigation table"
 
32
WIDTH="100%"
 
33
BORDER="0"
 
34
CELLPADDING="0"
 
35
CELLSPACING="0"
 
36
><TR
 
37
><TH
 
38
COLSPAN="3"
 
39
ALIGN="center"
 
40
>GTK+ 2.0 Tutorial</TH
 
41
></TR
 
42
><TR
 
43
><TD
 
44
WIDTH="10%"
 
45
ALIGN="left"
 
46
VALIGN="bottom"
 
47
><A
 
48
HREF="x1923.html"
 
49
ACCESSKEY="P"
 
50
>&#60;&#60;&#60; Previous</A
 
51
></TD
 
52
><TD
 
53
WIDTH="80%"
 
54
ALIGN="center"
 
55
VALIGN="bottom"
 
56
>Drag-and-drop (DND)</TD
 
57
><TD
 
58
WIDTH="10%"
 
59
ALIGN="right"
 
60
VALIGN="bottom"
 
61
><A
 
62
HREF="c2025.html"
 
63
ACCESSKEY="N"
 
64
>Next &#62;&#62;&#62;</A
 
65
></TD
 
66
></TR
 
67
></TABLE
 
68
><HR
 
69
ALIGN="LEFT"
 
70
WIDTH="100%"></DIV
 
71
><DIV
 
72
CLASS="SECT1"
 
73
><H1
 
74
CLASS="SECT1"
 
75
><A
 
76
NAME="SEC-DRAGANDDROPFUNCTIONS"
 
77
>Functions</A
 
78
></H1
 
79
><DIV
 
80
CLASS="SECT2"
 
81
><H2
 
82
CLASS="SECT2"
 
83
><A
 
84
NAME="SEC-DNDSOURCEWIDGETS"
 
85
>Setting up the source widget</A
 
86
></H2
 
87
><P
 
88
>The function <TT
 
89
CLASS="LITERAL"
 
90
>gtk_drag_source_set()</TT
 
91
> specifies a
 
92
set of target types for a drag operation on a widget.</P
 
93
><TABLE
 
94
BORDER="0"
 
95
BGCOLOR="#E0E0E0"
 
96
WIDTH="100%"
 
97
><TR
 
98
><TD
 
99
><PRE
 
100
CLASS="PROGRAMLISTING"
 
101
>void gtk_drag_source_set( GtkWidget            *widget,
 
102
                          GdkModifierType       start_button_mask,
 
103
                          const GtkTargetEntry *targets,
 
104
                          gint                  n_targets,
 
105
                          GdkDragAction         actions );</PRE
 
106
></TD
 
107
></TR
 
108
></TABLE
 
109
><P
 
110
>The parameters signify the following:</P
 
111
><P
 
112
></P
 
113
><UL
 
114
><LI
 
115
><P
 
116
><TT
 
117
CLASS="LITERAL"
 
118
>widget</TT
 
119
> specifies the drag source
 
120
widget</P
 
121
></LI
 
122
><LI
 
123
><P
 
124
><TT
 
125
CLASS="LITERAL"
 
126
>start_button_mask</TT
 
127
> specifies a
 
128
bitmask of buttons that can start the drag (e.g. GDK_BUTTON1_MASK)</P
 
129
></LI
 
130
><LI
 
131
><P
 
132
><TT
 
133
CLASS="LITERAL"
 
134
>targets</TT
 
135
> specifies a table of
 
136
target data types the drag will support</P
 
137
></LI
 
138
><LI
 
139
><P
 
140
><TT
 
141
CLASS="LITERAL"
 
142
>n_targets</TT
 
143
> specifies the number of
 
144
targets above</P
 
145
></LI
 
146
><LI
 
147
><P
 
148
><TT
 
149
CLASS="LITERAL"
 
150
>actions</TT
 
151
> specifies a bitmask of
 
152
possible actions for a drag from this window</P
 
153
></LI
 
154
></UL
 
155
><P
 
156
>The <TT
 
157
CLASS="LITERAL"
 
158
>targets</TT
 
159
> parameter is an array of the
 
160
following structure:</P
 
161
><TABLE
 
162
BORDER="0"
 
163
BGCOLOR="#E0E0E0"
 
164
WIDTH="100%"
 
165
><TR
 
166
><TD
 
167
><PRE
 
168
CLASS="PROGRAMLISTING"
 
169
>struct GtkTargetEntry {
 
170
   gchar *target;
 
171
   guint  flags;
 
172
   guint  info;
 
173
 };</PRE
 
174
></TD
 
175
></TR
 
176
></TABLE
 
177
><P
 
178
>The fields specify a string representing the drag type, optional
 
179
flags and application assigned integer identifier.</P
 
180
><P
 
181
>If a widget is no longer required to act as a source for
 
182
drag-and-drop operations, the function
 
183
<TT
 
184
CLASS="LITERAL"
 
185
>gtk_drag_source_unset()</TT
 
186
> can be used to remove a set
 
187
of drag-and-drop target types.</P
 
188
><TABLE
 
189
BORDER="0"
 
190
BGCOLOR="#E0E0E0"
 
191
WIDTH="100%"
 
192
><TR
 
193
><TD
 
194
><PRE
 
195
CLASS="PROGRAMLISTING"
 
196
>void gtk_drag_source_unset( GtkWidget *widget );</PRE
 
197
></TD
 
198
></TR
 
199
></TABLE
 
200
></DIV
 
201
><DIV
 
202
CLASS="SECT2"
 
203
><H2
 
204
CLASS="SECT2"
 
205
><A
 
206
NAME="SEC-SIGNALSONSOURCEWIDGETS"
 
207
>Signals on the source widget:</A
 
208
></H2
 
209
><P
 
210
>The source widget is sent the following signals during a
 
211
drag-and-drop operation.</P
 
212
><DIV
 
213
CLASS="TABLE"
 
214
><A
 
215
NAME="AEN1975"
 
216
></A
 
217
><P
 
218
><B
 
219
>Table 1. Source widget signals</B
 
220
></P
 
221
><TABLE
 
222
BORDER="1"
 
223
WIDTH="100%"
 
224
BGCOLOR="#E0E0E0"
 
225
CELLSPACING="0"
 
226
CELLPADDING="4"
 
227
CLASS="CALSTABLE"
 
228
><TBODY
 
229
><TR
 
230
><TD
 
231
ALIGN="LEFT"
 
232
VALIGN="MIDDLE"
 
233
>drag_begin</TD
 
234
><TD
 
235
ALIGN="LEFT"
 
236
VALIGN="MIDDLE"
 
237
><TT
 
238
CLASS="LITERAL"
 
239
>void (*drag_begin)(GtkWidget *widget,
 
240
GdkDragContext *dc, gpointer data)</TT
 
241
></TD
 
242
></TR
 
243
><TR
 
244
><TD
 
245
ALIGN="LEFT"
 
246
VALIGN="MIDDLE"
 
247
>drag_motion</TD
 
248
><TD
 
249
ALIGN="LEFT"
 
250
VALIGN="MIDDLE"
 
251
><TT
 
252
CLASS="LITERAL"
 
253
>gboolean (*drag_motion)(GtkWidget *widget,
 
254
GdkDragContext *dc, gint x, gint y, guint t, gpointer data)</TT
 
255
></TD
 
256
></TR
 
257
><TR
 
258
><TD
 
259
ALIGN="LEFT"
 
260
VALIGN="MIDDLE"
 
261
>drag_data_get</TD
 
262
><TD
 
263
ALIGN="LEFT"
 
264
VALIGN="MIDDLE"
 
265
><TT
 
266
CLASS="LITERAL"
 
267
>void (*drag_data_get)(GtkWidget *widget,
 
268
GdkDragContext *dc, GtkSelectionData *selection_data, guint info, guint t, gpointer data)</TT
 
269
></TD
 
270
></TR
 
271
><TR
 
272
><TD
 
273
ALIGN="LEFT"
 
274
VALIGN="MIDDLE"
 
275
>drag_data_delete</TD
 
276
><TD
 
277
ALIGN="LEFT"
 
278
VALIGN="MIDDLE"
 
279
><TT
 
280
CLASS="LITERAL"
 
281
>void (*drag_data_delete)(GtkWidget *widget,
 
282
GdkDragContext *dc, gpointer data)</TT
 
283
></TD
 
284
></TR
 
285
><TR
 
286
><TD
 
287
ALIGN="LEFT"
 
288
VALIGN="MIDDLE"
 
289
>drag_drop</TD
 
290
><TD
 
291
ALIGN="LEFT"
 
292
VALIGN="MIDDLE"
 
293
><TT
 
294
CLASS="LITERAL"
 
295
>gboolean (*drag_drop)(GtkWidget *widget,
 
296
GdkDragContext *dc, gint x, gint y, guint t, gpointer data)</TT
 
297
></TD
 
298
></TR
 
299
><TR
 
300
><TD
 
301
ALIGN="LEFT"
 
302
VALIGN="MIDDLE"
 
303
>drag_end</TD
 
304
><TD
 
305
ALIGN="LEFT"
 
306
VALIGN="MIDDLE"
 
307
><TT
 
308
CLASS="LITERAL"
 
309
>void (*drag_end)(GtkWidget *widget,
 
310
GdkDragContext *dc, gpointer data)</TT
 
311
></TD
 
312
></TR
 
313
></TBODY
 
314
></TABLE
 
315
></DIV
 
316
></DIV
 
317
><DIV
 
318
CLASS="SECT2"
 
319
><H2
 
320
CLASS="SECT2"
 
321
><A
 
322
NAME="SEC-DNDDESTWIDGETS"
 
323
>Setting up a destination widget:</A
 
324
></H2
 
325
><P
 
326
> <TT
 
327
CLASS="LITERAL"
 
328
> gtk_drag_dest_set()</TT
 
329
> specifies
 
330
that this widget can receive drops and specifies what types of drops it
 
331
can receive.</P
 
332
><P
 
333
> <TT
 
334
CLASS="LITERAL"
 
335
> gtk_drag_dest_unset()</TT
 
336
> specifies
 
337
that the widget can no longer receive drops.</P
 
338
><TABLE
 
339
BORDER="0"
 
340
BGCOLOR="#E0E0E0"
 
341
WIDTH="100%"
 
342
><TR
 
343
><TD
 
344
><PRE
 
345
CLASS="PROGRAMLISTING"
 
346
>void gtk_drag_dest_set( GtkWidget            *widget,
 
347
                        GtkDestDefaults       flags,
 
348
                        const GtkTargetEntry *targets,
 
349
                        gint                  n_targets,
 
350
                        GdkDragAction         actions );
 
351
 
 
352
void gtk_drag_dest_unset( GtkWidget *widget );</PRE
 
353
></TD
 
354
></TR
 
355
></TABLE
 
356
></DIV
 
357
><DIV
 
358
CLASS="SECT2"
 
359
><H2
 
360
CLASS="SECT2"
 
361
><A
 
362
NAME="SEC-SIGNALSONDESTWIDGETS"
 
363
>Signals on the destination widget:</A
 
364
></H2
 
365
><P
 
366
>The destination widget is sent the following signals during a
 
367
drag-and-drop operation.</P
 
368
><DIV
 
369
CLASS="TABLE"
 
370
><A
 
371
NAME="AEN2015"
 
372
></A
 
373
><P
 
374
><B
 
375
>Table 2. Destination widget signals</B
 
376
></P
 
377
><TABLE
 
378
BORDER="1"
 
379
WIDTH="100%"
 
380
BGCOLOR="#E0E0E0"
 
381
CELLSPACING="0"
 
382
CELLPADDING="4"
 
383
CLASS="CALSTABLE"
 
384
><TBODY
 
385
><TR
 
386
><TD
 
387
ALIGN="LEFT"
 
388
VALIGN="MIDDLE"
 
389
>drag_data_received</TD
 
390
><TD
 
391
ALIGN="LEFT"
 
392
VALIGN="MIDDLE"
 
393
><TT
 
394
CLASS="LITERAL"
 
395
>void (*drag_data_received)(GtkWidget *widget,
 
396
GdkDragContext *dc, gint x, gint y, GtkSelectionData *selection_data, guint info, guint t,
 
397
gpointer data)</TT
 
398
></TD
 
399
></TR
 
400
></TBODY
 
401
></TABLE
 
402
></DIV
 
403
></DIV
 
404
></DIV
 
405
><DIV
 
406
CLASS="NAVFOOTER"
 
407
><HR
 
408
ALIGN="LEFT"
 
409
WIDTH="100%"><TABLE
 
410
SUMMARY="Footer navigation table"
 
411
WIDTH="100%"
 
412
BORDER="0"
 
413
CELLPADDING="0"
 
414
CELLSPACING="0"
 
415
><TR
 
416
><TD
 
417
WIDTH="33%"
 
418
ALIGN="left"
 
419
VALIGN="top"
 
420
><A
 
421
HREF="x1923.html"
 
422
ACCESSKEY="P"
 
423
>&#60;&#60;&#60; Previous</A
 
424
></TD
 
425
><TD
 
426
WIDTH="34%"
 
427
ALIGN="center"
 
428
VALIGN="top"
 
429
><A
 
430
HREF="book1.html"
 
431
ACCESSKEY="H"
 
432
>Home</A
 
433
></TD
 
434
><TD
 
435
WIDTH="33%"
 
436
ALIGN="right"
 
437
VALIGN="top"
 
438
><A
 
439
HREF="c2025.html"
 
440
ACCESSKEY="N"
 
441
>Next &#62;&#62;&#62;</A
 
442
></TD
 
443
></TR
 
444
><TR
 
445
><TD
 
446
WIDTH="33%"
 
447
ALIGN="left"
 
448
VALIGN="top"
 
449
>Properties</TD
 
450
><TD
 
451
WIDTH="34%"
 
452
ALIGN="center"
 
453
VALIGN="top"
 
454
><A
 
455
HREF="c1901.html"
 
456
ACCESSKEY="U"
 
457
>Up</A
 
458
></TD
 
459
><TD
 
460
WIDTH="33%"
 
461
ALIGN="right"
 
462
VALIGN="top"
 
463
>GLib</TD
 
464
></TR
 
465
></TABLE
 
466
></DIV
 
467
></BODY
 
468
></HTML
 
469
>
 
 
b'\\ No newline at end of file'