gtk2 0.90.8-x86-mingw32 → 0.90.9-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (466) hide show
  1. data/ChangeLog +22 -0
  2. data/ext/gtk2/rbgtkwindow.c +3 -1
  3. data/lib/1.8/gtk2.so +0 -0
  4. data/lib/1.9/gtk2.so +0 -0
  5. data/sample/gtk-demo/cairo-operator.rb +1 -1
  6. data/sample/misc/bindings.rb +1 -1
  7. data/sample/misc/cairo-pong.rb +1 -1
  8. data/vendor/local/bin/gtk-builder-convert +29 -2
  9. data/vendor/local/bin/gtk-demo.exe +0 -0
  10. data/vendor/local/bin/gtk-query-immodules-2.0.exe +0 -0
  11. data/vendor/local/bin/gtk-update-icon-cache.exe +0 -0
  12. data/vendor/local/bin/libgailutil-18.dll +0 -0
  13. data/vendor/local/bin/libgdk-win32-2.0-0.dll +0 -0
  14. data/vendor/local/bin/libgtk-win32-2.0-0.dll +0 -0
  15. data/vendor/local/etc/gtk-2.0/gtk.immodules +1 -1
  16. data/vendor/local/include/gtk-2.0/gdk/gdk.h +2 -5
  17. data/vendor/local/include/gtk-2.0/gdk/gdkcairo.h +4 -0
  18. data/vendor/local/include/gtk-2.0/gdk/gdkdisplay.h +2 -0
  19. data/vendor/local/include/gtk-2.0/gdk/gdkdnd.h +7 -0
  20. data/vendor/local/include/gtk-2.0/gdk/gdkdrawable.h +7 -4
  21. data/vendor/local/include/gtk-2.0/gdk/gdkfont.h +1 -1
  22. data/vendor/local/include/gtk-2.0/gdk/gdkinput.h +1 -0
  23. data/vendor/local/include/gtk-2.0/gdk/gdkpixmap.h +4 -0
  24. data/vendor/local/include/gtk-2.0/gdk/gdkproperty.h +13 -9
  25. data/vendor/local/include/gtk-2.0/gdk/gdkspawn.h +2 -0
  26. data/vendor/local/include/gtk-2.0/gdk/gdkwin32.h +5 -0
  27. data/vendor/local/include/gtk-2.0/gdk/gdkwindow.h +16 -6
  28. data/vendor/local/include/gtk-2.0/gtk/gtk.h +1 -0
  29. data/vendor/local/include/gtk-2.0/gtk/gtkaboutdialog.h +5 -1
  30. data/vendor/local/include/gtk-2.0/gtk/gtkcombobox.h +14 -3
  31. data/vendor/local/include/gtk-2.0/gtk/gtkcomboboxentry.h +3 -0
  32. data/vendor/local/include/gtk-2.0/gtk/gtkcomboboxtext.h +77 -0
  33. data/vendor/local/include/gtk-2.0/gtk/gtkhruler.h +4 -0
  34. data/vendor/local/include/gtk-2.0/gtk/gtklinkbutton.h +2 -0
  35. data/vendor/local/include/gtk-2.0/gtk/gtkmain.h +2 -2
  36. data/vendor/local/include/gtk-2.0/gtk/gtknotebook.h +5 -3
  37. data/vendor/local/include/gtk-2.0/gtk/gtkrange.h +6 -0
  38. data/vendor/local/include/gtk-2.0/gtk/gtkruler.h +4 -0
  39. data/vendor/local/include/gtk-2.0/gtk/gtktypeutils.h +2 -0
  40. data/vendor/local/include/gtk-2.0/gtk/gtkversion.h +4 -4
  41. data/vendor/local/include/gtk-2.0/gtk/gtkvruler.h +4 -0
  42. data/vendor/local/include/gtk-2.0/gtk/gtkwidget.h +5 -1
  43. data/vendor/local/include/gtk-2.0/gtk/gtkwindow.h +2 -1
  44. data/vendor/local/lib/gailutil.lib +0 -0
  45. data/vendor/local/lib/gdk-win32-2.0.lib +0 -0
  46. data/vendor/local/lib/gtk-2.0/2.10.0/engines/libpixmap.dll +0 -0
  47. data/vendor/local/lib/gtk-2.0/2.10.0/engines/libwimp.dll +0 -0
  48. data/vendor/local/lib/gtk-2.0/modules/libgail.dll +0 -0
  49. data/vendor/local/lib/gtk-win32-2.0.lib +0 -0
  50. data/vendor/local/lib/libgailutil.dll.a +0 -0
  51. data/vendor/local/lib/libgdk-win32-2.0.dll.a +0 -0
  52. data/vendor/local/lib/libgtk-win32-2.0.dll.a +0 -0
  53. data/vendor/local/lib/pkgconfig/gail.pc +1 -1
  54. data/vendor/local/lib/pkgconfig/gdk-2.0.pc +1 -1
  55. data/vendor/local/lib/pkgconfig/gdk-win32-2.0.pc +1 -1
  56. data/vendor/local/lib/pkgconfig/gtk+-2.0.pc +1 -1
  57. data/vendor/local/lib/pkgconfig/gtk+-win32-2.0.pc +1 -1
  58. data/vendor/local/manifest/{gtk+-dev_2.22.1-1_win32.mft → gtk+-dev_2.24.0-1_win32.mft} +9 -6
  59. data/vendor/local/manifest/{gtk+_2.22.1-1_win32.mft → gtk+_2.24.0-1_win32.mft} +2 -6
  60. data/vendor/local/share/doc/{gtk+-2.22.1 → gtk+-2.24.0}/COPYING +0 -0
  61. data/vendor/local/share/doc/{gtk+-dev-2.22.1 → gtk+-dev-2.24.0}/COPYING +0 -0
  62. data/vendor/local/share/gtk-2.0/demo/appwindow.c +0 -21
  63. data/vendor/local/share/gtk-2.0/demo/combobox.c +6 -6
  64. data/vendor/local/share/gtk-2.0/demo/offscreen_window.c +1 -1
  65. data/vendor/local/share/gtk-2.0/demo/offscreen_window2.c +1 -1
  66. data/vendor/local/share/gtk-2.0/demo/sizegroup.c +2 -2
  67. data/vendor/local/share/gtk-2.0/demo/textview.c +4 -4
  68. data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util-GailMisc.html +60 -94
  69. data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util-GailTextUtil.html +44 -58
  70. data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util.devhelp +1 -1
  71. data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util.devhelp2 +1 -1
  72. data/vendor/local/share/gtk-doc/html/gail-libgail-util/index.html +3 -3
  73. data/vendor/local/share/gtk-doc/html/gail-libgail-util/libgail-util-main.html +3 -3
  74. data/vendor/local/share/gtk-doc/html/gail-libgail-util/style.css +2 -1
  75. data/vendor/local/share/gtk-doc/html/gdk/GdkDisplay.html +151 -208
  76. data/vendor/local/share/gtk-doc/html/gdk/GdkDisplayManager.html +33 -37
  77. data/vendor/local/share/gtk-doc/html/gdk/GdkScreen.html +180 -239
  78. data/vendor/local/share/gtk-doc/html/gdk/annotation-glossary.html +3 -3
  79. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-10.html +3 -3
  80. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-12.html +3 -3
  81. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-14.html +3 -3
  82. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-16.html +3 -3
  83. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-18.html +3 -3
  84. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-2.html +4 -4
  85. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-20.html +3 -3
  86. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-22.html +3 -3
  87. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-4.html +3 -3
  88. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-6.html +6 -6
  89. data/vendor/local/share/gtk-doc/html/gdk/api-index-2-8.html +4 -4
  90. data/vendor/local/share/gtk-doc/html/gdk/api-index-deprecated.html +135 -5
  91. data/vendor/local/share/gtk-doc/html/gdk/api-index-full.html +83 -47
  92. data/vendor/local/share/gtk-doc/html/gdk/gdk-Application-launching.html +20 -23
  93. data/vendor/local/share/gtk-doc/html/gdk/gdk-Bitmaps-and-Pixmaps.html +126 -126
  94. data/vendor/local/share/gtk-doc/html/gdk/gdk-Cairo-Interaction.html +81 -39
  95. data/vendor/local/share/gtk-doc/html/gdk/gdk-Colormaps-and-Colors.html +135 -199
  96. data/vendor/local/share/gtk-doc/html/gdk/gdk-Cursors.html +71 -90
  97. data/vendor/local/share/gtk-doc/html/gdk/gdk-Drag-and-Drop.html +161 -200
  98. data/vendor/local/share/gtk-doc/html/gdk/gdk-Drawing-Primitives.html +293 -409
  99. data/vendor/local/share/gtk-doc/html/gdk/gdk-Event-Structures.html +320 -435
  100. data/vendor/local/share/gtk-doc/html/gdk/gdk-Events.html +109 -141
  101. data/vendor/local/share/gtk-doc/html/gdk/gdk-Fonts.html +155 -234
  102. data/vendor/local/share/gtk-doc/html/gdk/gdk-GdkRGB.html +143 -217
  103. data/vendor/local/share/gtk-doc/html/gdk/gdk-General.html +103 -124
  104. data/vendor/local/share/gtk-doc/html/gdk/gdk-Graphics-Contexts.html +168 -250
  105. data/vendor/local/share/gtk-doc/html/gdk/gdk-Images.html +90 -131
  106. data/vendor/local/share/gtk-doc/html/gdk/gdk-Input-Devices.html +143 -191
  107. data/vendor/local/share/gtk-doc/html/gdk/gdk-Input.html +35 -53
  108. data/vendor/local/share/gtk-doc/html/gdk/gdk-Keyboard-Handling.html +162 -195
  109. data/vendor/local/share/gtk-doc/html/gdk/gdk-Pango-Interaction.html +85 -112
  110. data/vendor/local/share/gtk-doc/html/gdk/gdk-Pixbufs.html +79 -137
  111. data/vendor/local/share/gtk-doc/html/gdk/gdk-Points-Rectangles-and-Regions.html +144 -176
  112. data/vendor/local/share/gtk-doc/html/gdk/gdk-Properties-and-Atoms.html +188 -235
  113. data/vendor/local/share/gtk-doc/html/gdk/gdk-Selections.html +97 -134
  114. data/vendor/local/share/gtk-doc/html/gdk/gdk-Testing.html +22 -35
  115. data/vendor/local/share/gtk-doc/html/gdk/gdk-Threads.html +44 -70
  116. data/vendor/local/share/gtk-doc/html/gdk/gdk-Visuals.html +83 -108
  117. data/vendor/local/share/gtk-doc/html/gdk/gdk-Windows.html +653 -744
  118. data/vendor/local/share/gtk-doc/html/gdk/gdk-X-Window-System-Interaction.html +476 -490
  119. data/vendor/local/share/gtk-doc/html/gdk/gdk.devhelp +53 -44
  120. data/vendor/local/share/gtk-doc/html/gdk/gdk.devhelp2 +85 -76
  121. data/vendor/local/share/gtk-doc/html/gdk/index.html +4 -4
  122. data/vendor/local/share/gtk-doc/html/gdk/index.sgml +10 -1
  123. data/vendor/local/share/gtk-doc/html/gdk/multihead.html +9 -9
  124. data/vendor/local/share/gtk-doc/html/gdk/reference.html +3 -3
  125. data/vendor/local/share/gtk-doc/html/gdk/style.css +2 -1
  126. data/vendor/local/share/gtk-doc/html/gtk/AbstractObjects.html +3 -3
  127. data/vendor/local/share/gtk-doc/html/gtk/Actions.html +3 -3
  128. data/vendor/local/share/gtk-doc/html/gtk/Builder.html +3 -3
  129. data/vendor/local/share/gtk-doc/html/gtk/ButtonWidgets.html +3 -3
  130. data/vendor/local/share/gtk-doc/html/gtk/DeprecatedObjects.html +3 -3
  131. data/vendor/local/share/gtk-doc/html/gtk/DisplayWidgets.html +3 -3
  132. data/vendor/local/share/gtk-doc/html/gtk/GtkAboutDialog.html +193 -186
  133. data/vendor/local/share/gtk-doc/html/gtk/GtkAccelLabel.html +38 -46
  134. data/vendor/local/share/gtk-doc/html/gtk/GtkAccessible.html +18 -18
  135. data/vendor/local/share/gtk-doc/html/gtk/GtkAction.html +169 -236
  136. data/vendor/local/share/gtk-doc/html/gtk/GtkActionGroup.html +175 -258
  137. data/vendor/local/share/gtk-doc/html/gtk/GtkActivatable.html +46 -50
  138. data/vendor/local/share/gtk-doc/html/gtk/GtkAdjustment.html +78 -114
  139. data/vendor/local/share/gtk-doc/html/gtk/GtkAlignment.html +52 -66
  140. data/vendor/local/share/gtk-doc/html/gtk/GtkArrow.html +30 -36
  141. data/vendor/local/share/gtk-doc/html/gtk/GtkAspectFrame.html +36 -46
  142. data/vendor/local/share/gtk-doc/html/gtk/GtkAssistant.html +97 -118
  143. data/vendor/local/share/gtk-doc/html/gtk/GtkBin.html +14 -14
  144. data/vendor/local/share/gtk-doc/html/gtk/GtkBox.html +95 -120
  145. data/vendor/local/share/gtk-doc/html/gtk/GtkBuildable.html +86 -117
  146. data/vendor/local/share/gtk-doc/html/gtk/GtkBuilder.html +96 -137
  147. data/vendor/local/share/gtk-doc/html/gtk/GtkButton.html +152 -185
  148. data/vendor/local/share/gtk-doc/html/gtk/GtkButtonBox.html +59 -76
  149. data/vendor/local/share/gtk-doc/html/gtk/GtkCList.html +615 -895
  150. data/vendor/local/share/gtk-doc/html/gtk/GtkCTree.html +520 -1791
  151. data/vendor/local/share/gtk-doc/html/gtk/GtkCalendar.html +125 -163
  152. data/vendor/local/share/gtk-doc/html/gtk/GtkCellEditable.html +33 -35
  153. data/vendor/local/share/gtk-doc/html/gtk/GtkCellLayout.html +60 -87
  154. data/vendor/local/share/gtk-doc/html/gtk/GtkCellRenderer.html +106 -130
  155. data/vendor/local/share/gtk-doc/html/gtk/GtkCellRendererAccel.html +35 -44
  156. data/vendor/local/share/gtk-doc/html/gtk/GtkCellRendererCombo.html +27 -32
  157. data/vendor/local/share/gtk-doc/html/gtk/GtkCellRendererPixbuf.html +24 -25
  158. data/vendor/local/share/gtk-doc/html/gtk/GtkCellRendererProgress.html +23 -25
  159. data/vendor/local/share/gtk-doc/html/gtk/GtkCellRendererSpin.html +19 -20
  160. data/vendor/local/share/gtk-doc/html/gtk/GtkCellRendererSpinner.html +19 -20
  161. data/vendor/local/share/gtk-doc/html/gtk/GtkCellRendererText.html +69 -74
  162. data/vendor/local/share/gtk-doc/html/gtk/GtkCellRendererToggle.html +45 -54
  163. data/vendor/local/share/gtk-doc/html/gtk/GtkCellView.html +57 -76
  164. data/vendor/local/share/gtk-doc/html/gtk/GtkCheckButton.html +30 -34
  165. data/vendor/local/share/gtk-doc/html/gtk/GtkColorButton.html +53 -75
  166. data/vendor/local/share/gtk-doc/html/gtk/GtkColorSelection.html +104 -180
  167. data/vendor/local/share/gtk-doc/html/gtk/GtkColorSelectionDialog.html +29 -32
  168. data/vendor/local/share/gtk-doc/html/gtk/GtkCombo.html +63 -81
  169. data/vendor/local/share/gtk-doc/html/gtk/GtkComboBox.html +344 -186
  170. data/vendor/local/share/gtk-doc/html/gtk/GtkComboBoxEntry.html +57 -46
  171. data/vendor/local/share/gtk-doc/html/gtk/GtkComboBoxText.html +301 -0
  172. data/vendor/local/share/gtk-doc/html/gtk/GtkContainer.html +311 -260
  173. data/vendor/local/share/gtk-doc/html/gtk/GtkCurve.html +61 -79
  174. data/vendor/local/share/gtk-doc/html/gtk/GtkDialog.html +97 -121
  175. data/vendor/local/share/gtk-doc/html/gtk/GtkDrawingArea.html +21 -23
  176. data/vendor/local/share/gtk-doc/html/gtk/GtkEditable.html +68 -88
  177. data/vendor/local/share/gtk-doc/html/gtk/GtkEntry.html +360 -470
  178. data/vendor/local/share/gtk-doc/html/gtk/GtkEntryBuffer.html +71 -104
  179. data/vendor/local/share/gtk-doc/html/gtk/GtkEntryCompletion.html +130 -185
  180. data/vendor/local/share/gtk-doc/html/gtk/GtkEventBox.html +33 -38
  181. data/vendor/local/share/gtk-doc/html/gtk/GtkExpander.html +76 -96
  182. data/vendor/local/share/gtk-doc/html/gtk/GtkFileChooser.html +331 -403
  183. data/vendor/local/share/gtk-doc/html/gtk/GtkFileChooserButton.html +64 -89
  184. data/vendor/local/share/gtk-doc/html/gtk/GtkFileChooserDialog.html +30 -35
  185. data/vendor/local/share/gtk-doc/html/gtk/GtkFileChooserWidget.html +21 -26
  186. data/vendor/local/share/gtk-doc/html/gtk/GtkFileSelection.html +102 -146
  187. data/vendor/local/share/gtk-doc/html/gtk/GtkFixed.html +38 -49
  188. data/vendor/local/share/gtk-doc/html/gtk/GtkFontButton.html +60 -86
  189. data/vendor/local/share/gtk-doc/html/gtk/GtkFontSelection.html +66 -81
  190. data/vendor/local/share/gtk-doc/html/gtk/GtkFontSelectionDialog.html +52 -61
  191. data/vendor/local/share/gtk-doc/html/gtk/GtkFrame.html +51 -58
  192. data/vendor/local/share/gtk-doc/html/gtk/GtkGammaCurve.html +18 -19
  193. data/vendor/local/share/gtk-doc/html/gtk/GtkHBox.html +17 -20
  194. data/vendor/local/share/gtk-doc/html/gtk/GtkHButtonBox.html +29 -34
  195. data/vendor/local/share/gtk-doc/html/gtk/GtkHPaned.html +13 -13
  196. data/vendor/local/share/gtk-doc/html/gtk/GtkHRuler.html +30 -24
  197. data/vendor/local/share/gtk-doc/html/gtk/GtkHSV.html +65 -101
  198. data/vendor/local/share/gtk-doc/html/gtk/GtkHScale.html +25 -30
  199. data/vendor/local/share/gtk-doc/html/gtk/GtkHScrollbar.html +18 -18
  200. data/vendor/local/share/gtk-doc/html/gtk/GtkHSeparator.html +19 -20
  201. data/vendor/local/share/gtk-doc/html/gtk/GtkHandleBox.html +55 -66
  202. data/vendor/local/share/gtk-doc/html/gtk/GtkIMContext.html +140 -182
  203. data/vendor/local/share/gtk-doc/html/gtk/GtkIMContextSimple.html +18 -22
  204. data/vendor/local/share/gtk-doc/html/gtk/GtkIMMulticontext.html +18 -22
  205. data/vendor/local/share/gtk-doc/html/gtk/GtkIconTheme.html +184 -248
  206. data/vendor/local/share/gtk-doc/html/gtk/GtkIconView.html +321 -447
  207. data/vendor/local/share/gtk-doc/html/gtk/GtkImage.html +174 -195
  208. data/vendor/local/share/gtk-doc/html/gtk/GtkImageMenuItem.html +58 -69
  209. data/vendor/local/share/gtk-doc/html/gtk/GtkInfoBar.html +67 -80
  210. data/vendor/local/share/gtk-doc/html/gtk/GtkInputDialog.html +32 -37
  211. data/vendor/local/share/gtk-doc/html/gtk/GtkInvisible.html +33 -41
  212. data/vendor/local/share/gtk-doc/html/gtk/GtkItem.html +36 -42
  213. data/vendor/local/share/gtk-doc/html/gtk/GtkItemFactory.html +179 -272
  214. data/vendor/local/share/gtk-doc/html/gtk/GtkLabel.html +197 -249
  215. data/vendor/local/share/gtk-doc/html/gtk/GtkLayout.html +68 -76
  216. data/vendor/local/share/gtk-doc/html/gtk/GtkLinkButton.html +51 -60
  217. data/vendor/local/share/gtk-doc/html/gtk/GtkList.html +130 -180
  218. data/vendor/local/share/gtk-doc/html/gtk/GtkListItem.html +80 -130
  219. data/vendor/local/share/gtk-doc/html/gtk/GtkListStore.html +138 -168
  220. data/vendor/local/share/gtk-doc/html/gtk/GtkMenu.html +177 -221
  221. data/vendor/local/share/gtk-doc/html/gtk/GtkMenuBar.html +41 -49
  222. data/vendor/local/share/gtk-doc/html/gtk/GtkMenuItem.html +112 -145
  223. data/vendor/local/share/gtk-doc/html/gtk/GtkMenuShell.html +86 -118
  224. data/vendor/local/share/gtk-doc/html/gtk/GtkMenuToolButton.html +73 -49
  225. data/vendor/local/share/gtk-doc/html/gtk/GtkMessageDialog.html +81 -81
  226. data/vendor/local/share/gtk-doc/html/gtk/GtkMisc.html +33 -39
  227. data/vendor/local/share/gtk-doc/html/gtk/GtkNotebook.html +396 -452
  228. data/vendor/local/share/gtk-doc/html/gtk/GtkObject.html +148 -206
  229. data/vendor/local/share/gtk-doc/html/gtk/GtkOffscreenWindow.html +21 -25
  230. data/vendor/local/share/gtk-doc/html/gtk/GtkOldEditable.html +80 -165
  231. data/vendor/local/share/gtk-doc/html/gtk/GtkOptionMenu.html +56 -66
  232. data/vendor/local/share/gtk-doc/html/gtk/GtkPageSetup.html +115 -160
  233. data/vendor/local/share/gtk-doc/html/gtk/GtkPageSetupUnixDialog.html +22 -25
  234. data/vendor/local/share/gtk-doc/html/gtk/GtkPaned.html +94 -134
  235. data/vendor/local/share/gtk-doc/html/gtk/{gtk-GtkPaperSize.html → GtkPaperSize.html} +204 -252
  236. data/vendor/local/share/gtk-doc/html/gtk/GtkPixmap.html +34 -44
  237. data/vendor/local/share/gtk-doc/html/gtk/GtkPlug.html +51 -67
  238. data/vendor/local/share/gtk-doc/html/gtk/GtkPreview.html +109 -136
  239. data/vendor/local/share/gtk-doc/html/gtk/GtkPrintContext.html +38 -53
  240. data/vendor/local/share/gtk-doc/html/gtk/GtkPrintJob.html +53 -68
  241. data/vendor/local/share/gtk-doc/html/gtk/GtkPrintSettings.html +265 -403
  242. data/vendor/local/share/gtk-doc/html/gtk/GtkPrintUnixDialog.html +74 -94
  243. data/vendor/local/share/gtk-doc/html/gtk/GtkPrinter.html +100 -134
  244. data/vendor/local/share/gtk-doc/html/gtk/GtkProgress.html +80 -111
  245. data/vendor/local/share/gtk-doc/html/gtk/GtkProgressBar.html +91 -108
  246. data/vendor/local/share/gtk-doc/html/gtk/GtkRadioAction.html +42 -53
  247. data/vendor/local/share/gtk-doc/html/gtk/GtkRadioButton.html +86 -79
  248. data/vendor/local/share/gtk-doc/html/gtk/GtkRadioMenuItem.html +63 -71
  249. data/vendor/local/share/gtk-doc/html/gtk/GtkRadioToolButton.html +33 -42
  250. data/vendor/local/share/gtk-doc/html/gtk/GtkRange.html +218 -185
  251. data/vendor/local/share/gtk-doc/html/gtk/GtkRecentAction.html +34 -41
  252. data/vendor/local/share/gtk-doc/html/gtk/GtkRecentChooser.html +135 -194
  253. data/vendor/local/share/gtk-doc/html/gtk/GtkRecentChooserDialog.html +27 -29
  254. data/vendor/local/share/gtk-doc/html/gtk/GtkRecentChooserMenu.html +25 -30
  255. data/vendor/local/share/gtk-doc/html/gtk/GtkRecentChooserWidget.html +17 -19
  256. data/vendor/local/share/gtk-doc/html/gtk/GtkRecentFilter.html +63 -85
  257. data/vendor/local/share/gtk-doc/html/gtk/GtkRecentManager.html +202 -269
  258. data/vendor/local/share/gtk-doc/html/gtk/GtkRuler.html +83 -58
  259. data/vendor/local/share/gtk-doc/html/gtk/GtkScale.html +61 -72
  260. data/vendor/local/share/gtk-doc/html/gtk/GtkScaleButton.html +64 -83
  261. data/vendor/local/share/gtk-doc/html/gtk/GtkScrollbar.html +21 -21
  262. data/vendor/local/share/gtk-doc/html/gtk/GtkScrolledWindow.html +93 -143
  263. data/vendor/local/share/gtk-doc/html/gtk/GtkSeparator.html +13 -13
  264. data/vendor/local/share/gtk-doc/html/gtk/GtkSeparatorMenuItem.html +17 -18
  265. data/vendor/local/share/gtk-doc/html/gtk/GtkSeparatorToolItem.html +24 -27
  266. data/vendor/local/share/gtk-doc/html/gtk/GtkSettings.html +129 -259
  267. data/vendor/local/share/gtk-doc/html/gtk/GtkSizeGroup.html +38 -45
  268. data/vendor/local/share/gtk-doc/html/gtk/GtkSocket.html +44 -53
  269. data/vendor/local/share/gtk-doc/html/gtk/GtkSpinButton.html +132 -177
  270. data/vendor/local/share/gtk-doc/html/gtk/GtkSpinner.html +24 -25
  271. data/vendor/local/share/gtk-doc/html/gtk/GtkStatusIcon.html +190 -254
  272. data/vendor/local/share/gtk-doc/html/gtk/GtkStatusbar.html +60 -75
  273. data/vendor/local/share/gtk-doc/html/gtk/GtkStyle.html +546 -928
  274. data/vendor/local/share/gtk-doc/html/gtk/GtkTable.html +94 -135
  275. data/vendor/local/share/gtk-doc/html/gtk/GtkTearoffMenuItem.html +18 -19
  276. data/vendor/local/share/gtk-doc/html/gtk/GtkText.html +97 -140
  277. data/vendor/local/share/gtk-doc/html/gtk/GtkTextBuffer.html +494 -656
  278. data/vendor/local/share/gtk-doc/html/gtk/{gtk-GtkTextIter.html → GtkTextIter.html} +664 -806
  279. data/vendor/local/share/gtk-doc/html/gtk/GtkTextMark.html +41 -46
  280. data/vendor/local/share/gtk-doc/html/gtk/GtkTextTag.html +164 -194
  281. data/vendor/local/share/gtk-doc/html/gtk/GtkTextTagTable.html +84 -76
  282. data/vendor/local/share/gtk-doc/html/gtk/GtkTextView.html +340 -425
  283. data/vendor/local/share/gtk-doc/html/gtk/GtkTipsQuery.html +74 -94
  284. data/vendor/local/share/gtk-doc/html/gtk/GtkToggleAction.html +43 -57
  285. data/vendor/local/share/gtk-doc/html/gtk/GtkToggleButton.html +59 -71
  286. data/vendor/local/share/gtk-doc/html/gtk/GtkToggleToolButton.html +32 -38
  287. data/vendor/local/share/gtk-doc/html/gtk/GtkToolButton.html +74 -85
  288. data/vendor/local/share/gtk-doc/html/gtk/GtkToolItem.html +133 -166
  289. data/vendor/local/share/gtk-doc/html/gtk/GtkToolItemGroup.html +84 -103
  290. data/vendor/local/share/gtk-doc/html/gtk/GtkToolPalette.html +116 -139
  291. data/vendor/local/share/gtk-doc/html/gtk/GtkToolShell.html +42 -59
  292. data/vendor/local/share/gtk-doc/html/gtk/GtkToolbar.html +249 -360
  293. data/vendor/local/share/gtk-doc/html/gtk/GtkTooltip.html +27 -27
  294. data/vendor/local/share/gtk-doc/html/gtk/GtkTooltips.html +60 -70
  295. data/vendor/local/share/gtk-doc/html/gtk/GtkTree.html +105 -152
  296. data/vendor/local/share/gtk-doc/html/gtk/GtkTreeItem.html +46 -134
  297. data/vendor/local/share/gtk-doc/html/gtk/GtkTreeModel.html +428 -557
  298. data/vendor/local/share/gtk-doc/html/gtk/GtkTreeModelFilter.html +95 -126
  299. data/vendor/local/share/gtk-doc/html/gtk/GtkTreeModelSort.html +63 -70
  300. data/vendor/local/share/gtk-doc/html/gtk/GtkTreeSelection.html +123 -171
  301. data/vendor/local/share/gtk-doc/html/gtk/GtkTreeSortable.html +53 -62
  302. data/vendor/local/share/gtk-doc/html/gtk/GtkTreeStore.html +170 -199
  303. data/vendor/local/share/gtk-doc/html/gtk/GtkTreeView.html +565 -863
  304. data/vendor/local/share/gtk-doc/html/gtk/GtkTreeViewColumn.html +203 -282
  305. data/vendor/local/share/gtk-doc/html/gtk/GtkUIManager.html +125 -189
  306. data/vendor/local/share/gtk-doc/html/gtk/GtkVBox.html +17 -20
  307. data/vendor/local/share/gtk-doc/html/gtk/GtkVButtonBox.html +27 -34
  308. data/vendor/local/share/gtk-doc/html/gtk/GtkVPaned.html +14 -14
  309. data/vendor/local/share/gtk-doc/html/gtk/GtkVRuler.html +31 -24
  310. data/vendor/local/share/gtk-doc/html/gtk/GtkVScale.html +24 -29
  311. data/vendor/local/share/gtk-doc/html/gtk/GtkVScrollbar.html +18 -18
  312. data/vendor/local/share/gtk-doc/html/gtk/GtkVSeparator.html +17 -18
  313. data/vendor/local/share/gtk-doc/html/gtk/GtkViewport.html +58 -69
  314. data/vendor/local/share/gtk-doc/html/gtk/GtkVolumeButton.html +16 -17
  315. data/vendor/local/share/gtk-doc/html/gtk/GtkWidget.html +1278 -1579
  316. data/vendor/local/share/gtk-doc/html/gtk/GtkWindow.html +380 -532
  317. data/vendor/local/share/gtk-doc/html/gtk/GtkWindowGroup.html +21 -39
  318. data/vendor/local/share/gtk-doc/html/gtk/LayoutContainers.html +3 -3
  319. data/vendor/local/share/gtk-doc/html/gtk/MenusAndCombos.html +6 -3
  320. data/vendor/local/share/gtk-doc/html/gtk/MiscObjects.html +3 -3
  321. data/vendor/local/share/gtk-doc/html/gtk/NumericEntry.html +3 -3
  322. data/vendor/local/share/gtk-doc/html/gtk/Ornaments.html +3 -3
  323. data/vendor/local/share/gtk-doc/html/gtk/PlugSocket.html +3 -3
  324. data/vendor/local/share/gtk-doc/html/gtk/Printing.html +4 -4
  325. data/vendor/local/share/gtk-doc/html/gtk/RecentDocuments.html +3 -3
  326. data/vendor/local/share/gtk-doc/html/gtk/ScrollingWidgets.html +3 -3
  327. data/vendor/local/share/gtk-doc/html/gtk/SelectorWidgets.html +3 -3
  328. data/vendor/local/share/gtk-doc/html/gtk/SpecialObjects.html +3 -3
  329. data/vendor/local/share/gtk-doc/html/gtk/TextWidget.html +15 -15
  330. data/vendor/local/share/gtk-doc/html/gtk/TextWidgetObjects.html +4 -4
  331. data/vendor/local/share/gtk-doc/html/gtk/TreeWidget.html +16 -16
  332. data/vendor/local/share/gtk-doc/html/gtk/TreeWidgetObjects.html +3 -3
  333. data/vendor/local/share/gtk-doc/html/gtk/WindowWidgets.html +3 -3
  334. data/vendor/local/share/gtk-doc/html/gtk/annotation-glossary.html +17 -11
  335. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-10.html +20 -20
  336. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-12.html +6 -6
  337. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-14.html +3 -3
  338. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-16.html +4 -4
  339. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-18.html +3 -3
  340. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-2.html +5 -5
  341. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-20.html +3 -3
  342. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-22.html +5 -5
  343. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-24.html +117 -0
  344. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-4.html +28 -28
  345. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-6.html +3 -3
  346. data/vendor/local/share/gtk-doc/html/gtk/api-index-2-8.html +7 -7
  347. data/vendor/local/share/gtk-doc/html/gtk/api-index-deprecated.html +236 -45
  348. data/vendor/local/share/gtk-doc/html/gtk/api-index-full.html +469 -385
  349. data/vendor/local/share/gtk-doc/html/gtk/ch01.html +15 -4
  350. data/vendor/local/share/gtk-doc/html/gtk/ch02.html +4 -4
  351. data/vendor/local/share/gtk-doc/html/gtk/chap-drawing-model.html +12 -12
  352. data/vendor/local/share/gtk-doc/html/gtk/checklist-gdkeventexpose-region.html +4 -4
  353. data/vendor/local/share/gtk-doc/html/gtk/checklist-modifiers.html +4 -4
  354. data/vendor/local/share/gtk-doc/html/gtk/checklist-named-icons.html +4 -4
  355. data/vendor/local/share/gtk-doc/html/gtk/decorating-the-assistant-pages.html +3 -3
  356. data/vendor/local/share/gtk-doc/html/gtk/glossary.html +3 -3
  357. data/vendor/local/share/gtk-doc/html/gtk/gtk-Accelerator-Maps.html +69 -124
  358. data/vendor/local/share/gtk-doc/html/gtk/gtk-Bindings.html +149 -211
  359. data/vendor/local/share/gtk-doc/html/gtk/gtk-Clipboards.html +189 -293
  360. data/vendor/local/share/gtk-doc/html/gtk/gtk-Drag-and-Drop.html +175 -246
  361. data/vendor/local/share/gtk-doc/html/gtk/gtk-Feature-Test-Macros.html +35 -41
  362. data/vendor/local/share/gtk-doc/html/gtk/gtk-Filesystem-utilities.html +41 -47
  363. data/vendor/local/share/gtk-doc/html/gtk/gtk-General.html +270 -318
  364. data/vendor/local/share/gtk-doc/html/gtk/gtk-Graphics-Contexts.html +16 -22
  365. data/vendor/local/share/gtk-doc/html/gtk/gtk-GtkTreeView-drag-and-drop.html +75 -82
  366. data/vendor/local/share/gtk-doc/html/gtk/gtk-High-level-Printing-API.html +221 -289
  367. data/vendor/local/share/gtk-doc/html/gtk/gtk-Keyboard-Accelerators.html +142 -232
  368. data/vendor/local/share/gtk-doc/html/gtk/gtk-Orientable.html +17 -20
  369. data/vendor/local/share/gtk-doc/html/gtk/gtk-Resource-Files.html +150 -190
  370. data/vendor/local/share/gtk-doc/html/gtk/gtk-Selections.html +328 -408
  371. data/vendor/local/share/gtk-doc/html/gtk/gtk-Signals.html +190 -306
  372. data/vendor/local/share/gtk-doc/html/gtk/gtk-Standard-Enumerations.html +53 -53
  373. data/vendor/local/share/gtk-doc/html/gtk/gtk-Stock-Items.html +152 -158
  374. data/vendor/local/share/gtk-doc/html/gtk/gtk-Testing.html +85 -136
  375. data/vendor/local/share/gtk-doc/html/gtk/gtk-Themeable-Stock-Images.html +204 -239
  376. data/vendor/local/share/gtk-doc/html/gtk/gtk-Types.html +271 -343
  377. data/vendor/local/share/gtk-doc/html/gtk/gtk-builder-convert.html +18 -11
  378. data/vendor/local/share/gtk-doc/html/gtk/gtk-building.html +20 -20
  379. data/vendor/local/share/gtk-doc/html/gtk/gtk-changes-1-2.html +5 -5
  380. data/vendor/local/share/gtk-doc/html/gtk/gtk-changes-2-0.html +5 -5
  381. data/vendor/local/share/gtk-doc/html/gtk/gtk-compiling.html +5 -5
  382. data/vendor/local/share/gtk-doc/html/gtk/gtk-directfb.html +7 -7
  383. data/vendor/local/share/gtk-doc/html/gtk/gtk-gtkcheckmenuitem.html +63 -75
  384. data/vendor/local/share/gtk-doc/html/gtk/gtk-gtkfilefilter.html +58 -75
  385. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-ClientSideWindows.html +3 -3
  386. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkAboutDialog.html +3 -3
  387. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkAction.html +4 -4
  388. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkAssistant.html +4 -4
  389. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkBuilder.html +5 -10
  390. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkColorButton.html +3 -3
  391. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkComboBox.html +4 -4
  392. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkFileChooser.html +5 -5
  393. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkIconView.html +3 -3
  394. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkLinkButton.html +3 -3
  395. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-GtkRecentChooser.html +5 -5
  396. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-checklist.html +7 -7
  397. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-entry-icons.html +3 -3
  398. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-label-links.html +3 -3
  399. data/vendor/local/share/gtk-doc/html/gtk/gtk-migrating-tooltips.html +3 -3
  400. data/vendor/local/share/gtk-doc/html/gtk/gtk-osx.html +6 -6
  401. data/vendor/local/share/gtk-doc/html/gtk/gtk-query-immodules-2.0.html +10 -10
  402. data/vendor/local/share/gtk-doc/html/gtk/gtk-question-index.html +90 -90
  403. data/vendor/local/share/gtk-doc/html/gtk/gtk-resources.html +9 -9
  404. data/vendor/local/share/gtk-doc/html/gtk/gtk-running.html +39 -31
  405. data/vendor/local/share/gtk-doc/html/gtk/gtk-update-icon-cache.html +10 -10
  406. data/vendor/local/share/gtk-doc/html/gtk/gtk-windows.html +14 -14
  407. data/vendor/local/share/gtk-doc/html/gtk/gtk-x11.html +12 -12
  408. data/vendor/local/share/gtk-doc/html/gtk/gtk.devhelp +445 -412
  409. data/vendor/local/share/gtk-doc/html/gtk/gtk.devhelp2 +488 -455
  410. data/vendor/local/share/gtk-doc/html/gtk/gtk.html +4 -4
  411. data/vendor/local/share/gtk-doc/html/gtk/gtkbase.html +3 -3
  412. data/vendor/local/share/gtk-doc/html/gtk/gtkfilechooser-installing-extra-widgets.html +3 -3
  413. data/vendor/local/share/gtk-doc/html/gtk/gtkfilechooser-installing-preview.html +3 -3
  414. data/vendor/local/share/gtk-doc/html/gtk/gtkfilechooser-new-features.html +3 -3
  415. data/vendor/local/share/gtk-doc/html/gtk/gtkfilechooser-selection-modes.html +5 -5
  416. data/vendor/local/share/gtk-doc/html/gtk/gtkobjects.html +8 -5
  417. data/vendor/local/share/gtk-doc/html/gtk/gtkrecent-advanced.html +3 -3
  418. data/vendor/local/share/gtk-doc/html/gtk/gtkrecent-chooser.html +3 -3
  419. data/vendor/local/share/gtk-doc/html/gtk/index.html +10 -6
  420. data/vendor/local/share/gtk-doc/html/gtk/index.sgml +194 -142
  421. data/vendor/local/share/gtk-doc/html/gtk/migrating-GtkCombo.html +3 -3
  422. data/vendor/local/share/gtk-doc/html/gtk/migrating-gnomeuiinfo.html +17 -17
  423. data/vendor/local/share/gtk-doc/html/gtk/migrating.html +4 -4
  424. data/vendor/local/share/gtk-doc/html/gtk/new-features-GtkComboBox.html +3 -3
  425. data/vendor/local/share/gtk-doc/html/gtk/pt05.html +4 -4
  426. data/vendor/local/share/gtk-doc/html/gtk/setting-the-page-flow.html +3 -3
  427. data/vendor/local/share/gtk-doc/html/gtk/style.css +2 -1
  428. data/vendor/local/share/gtk-doc/html/gtk/ui-manager.html +3 -3
  429. data/vendor/local/share/locale/bg/LC_MESSAGES/gtk20-properties.mo +0 -0
  430. data/vendor/local/share/locale/bg/LC_MESSAGES/gtk20.mo +0 -0
  431. data/vendor/local/share/locale/ca/LC_MESSAGES/gtk20-properties.mo +0 -0
  432. data/vendor/local/share/locale/ca/LC_MESSAGES/gtk20.mo +0 -0
  433. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gtk20-properties.mo +0 -0
  434. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gtk20.mo +0 -0
  435. data/vendor/local/share/locale/cs/LC_MESSAGES/gtk20.mo +0 -0
  436. data/vendor/local/share/locale/el/LC_MESSAGES/gtk20-properties.mo +0 -0
  437. data/vendor/local/share/locale/en_GB/LC_MESSAGES/gtk20-properties.mo +0 -0
  438. data/vendor/local/share/locale/en_GB/LC_MESSAGES/gtk20.mo +0 -0
  439. data/vendor/local/share/locale/et/LC_MESSAGES/gtk20-properties.mo +0 -0
  440. data/vendor/local/share/locale/gl/LC_MESSAGES/gtk20.mo +0 -0
  441. data/vendor/local/share/locale/hu/LC_MESSAGES/gtk20.mo +0 -0
  442. data/vendor/local/share/locale/it/LC_MESSAGES/gtk20-properties.mo +0 -0
  443. data/vendor/local/share/locale/it/LC_MESSAGES/gtk20.mo +0 -0
  444. data/vendor/local/share/locale/ja/LC_MESSAGES/gtk20-properties.mo +0 -0
  445. data/vendor/local/share/locale/lt/LC_MESSAGES/gtk20-properties.mo +0 -0
  446. data/vendor/local/share/locale/lt/LC_MESSAGES/gtk20.mo +0 -0
  447. data/vendor/local/share/locale/nb/LC_MESSAGES/gtk20.mo +0 -0
  448. data/vendor/local/share/locale/pl/LC_MESSAGES/gtk20.mo +0 -0
  449. data/vendor/local/share/locale/ru/LC_MESSAGES/gtk20-properties.mo +0 -0
  450. data/vendor/local/share/locale/ru/LC_MESSAGES/gtk20.mo +0 -0
  451. data/vendor/local/share/locale/sl/LC_MESSAGES/gtk20.mo +0 -0
  452. data/vendor/local/share/locale/te/LC_MESSAGES/gtk20.mo +0 -0
  453. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gtk20.mo +0 -0
  454. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gtk20.mo +0 -0
  455. data/vendor/local/src/tml/packaging/gtk+_2.24.0-1_win32.log +4934 -0
  456. data/vendor/local/src/tml/packaging/{gtk+_2.22.1-1_win32.sh → gtk+_2.24.0-1_win32.sh} +2 -2
  457. metadata +26 -33
  458. data/ext/gtk2/Makefile +0 -169
  459. data/ext/gtk2/rbgdkkeysyms.h +0 -2174
  460. data/ext/gtk2/rbgtkinits.c +0 -473
  461. data/ext/gtk2/ruby-gtk2.pc +0 -3
  462. data/vendor/local/share/locale/kg/LC_MESSAGES/gtk20-properties.mo +0 -0
  463. data/vendor/local/share/locale/kg/LC_MESSAGES/gtk20.mo +0 -0
  464. data/vendor/local/share/locale/lg/LC_MESSAGES/gtk20-properties.mo +0 -0
  465. data/vendor/local/share/locale/lg/LC_MESSAGES/gtk20.mo +0 -0
  466. data/vendor/local/src/tml/packaging/gtk+_2.22.1-1_win32.log +0 -5048
@@ -8,7 +8,7 @@
8
8
  <link rel="up" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
9
9
  <link rel="prev" href="GtkHSV.html" title="GtkHSV">
10
10
  <link rel="next" href="GtkFileChooserButton.html" title="GtkFileChooserButton">
11
- <meta name="generator" content="GTK-Doc V1.15 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.16.1 (XML mode)">
12
12
  <link rel="stylesheet" href="style.css" type="text/css">
13
13
  </head>
14
14
  <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -36,7 +36,7 @@
36
36
  <a href="#GtkFileChooser.signals" class="shortcut">Signals</a>
37
37
  </td></tr>
38
38
  </table>
39
- <div class="refentry" title="GtkFileChooser">
39
+ <div class="refentry">
40
40
  <a name="GtkFileChooser"></a><div class="titlepage"></div>
41
41
  <div class="refnamediv"><table width="100%"><tr>
42
42
  <td valign="top">
@@ -45,7 +45,7 @@
45
45
  </td>
46
46
  <td valign="top" align="right"></td>
47
47
  </tr></table></div>
48
- <div class="refsynopsisdiv" title="Synopsis">
48
+ <div class="refsynopsisdiv">
49
49
  <a name="GtkFileChooser.synopsis"></a><h2>Synopsis</h2>
50
50
  <pre class="synopsis">
51
51
  #include &lt;gtk/gtk.h&gt;
@@ -79,19 +79,15 @@ enum <a class="link" href="GtkFileChooser.html#GtkFileChooserErro
79
79
  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-create-folders" title="gtk_file_chooser_get_create_folders ()">gtk_file_chooser_get_create_folders</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
80
80
  <span class="returnvalue">void</span> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-name" title="gtk_file_chooser_set_current_name ()">gtk_file_chooser_set_current_name</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
81
81
  <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> *name</code></em>);
82
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename ()">gtk_file_chooser_get_filename</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
83
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-filename" title="gtk_file_chooser_set_filename ()">gtk_file_chooser_set_filename</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
84
- <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>);
85
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename ()">gtk_file_chooser_select_filename</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
86
- <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>);
87
- <span class="returnvalue">void</span> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-filename" title="gtk_file_chooser_unselect_filename ()">gtk_file_chooser_unselect_filename</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
88
- <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>);
82
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename">gtk_file_chooser_get_filename</a>
83
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-filename" title="gtk_file_chooser_set_filename">gtk_file_chooser_set_filename</a>
84
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename">gtk_file_chooser_select_filename</a>
85
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-filename" title="gtk_file_chooser_unselect_filename">gtk_file_chooser_unselect_filename</a>
89
86
  <span class="returnvalue">void</span> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-all" title="gtk_file_chooser_select_all ()">gtk_file_chooser_select_all</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
90
87
  <span class="returnvalue">void</span> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-all" title="gtk_file_chooser_unselect_all ()">gtk_file_chooser_unselect_all</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
91
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenames" title="gtk_file_chooser_get_filenames ()">gtk_file_chooser_get_filenames</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
92
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder ()">gtk_file_chooser_set_current_folder</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
93
- <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>);
94
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder" title="gtk_file_chooser_get_current_folder ()">gtk_file_chooser_get_current_folder</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
88
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenames" title="gtk_file_chooser_get_filenames">gtk_file_chooser_get_filenames</a>
89
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder">gtk_file_chooser_set_current_folder</a>
90
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder" title="gtk_file_chooser_get_current_folder">gtk_file_chooser_get_current_folder</a>
95
91
  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()">gtk_file_chooser_get_uri</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
96
92
  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-uri" title="gtk_file_chooser_set_uri ()">gtk_file_chooser_set_uri</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
97
93
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);
@@ -118,8 +114,7 @@ enum <a class="link" href="GtkFileChooser.html#GtkFileChooserErro
118
114
  <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_label</code></em>);
119
115
  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-use-preview-label" title="gtk_file_chooser_get_use_preview_label ()">gtk_file_chooser_get_use_preview_label</a>
120
116
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
121
- <span class="returnvalue">char</span> * <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename ()">gtk_file_chooser_get_preview_filename</a>
122
- (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
117
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename">gtk_file_chooser_get_preview_filename</a>
123
118
  <span class="returnvalue">char</span> * <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()">gtk_file_chooser_get_preview_uri</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
124
119
  <span class="returnvalue">void</span> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-extra-widget" title="gtk_file_chooser_set_extra_widget ()">gtk_file_chooser_set_extra_widget</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
125
120
  <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *extra_widget</code></em>);
@@ -132,16 +127,9 @@ enum <a class="link" href="GtkFileChooser.html#GtkFileChooserErro
132
127
  <span class="returnvalue">void</span> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-filter" title="gtk_file_chooser_set_filter ()">gtk_file_chooser_set_filter</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
133
128
  <em class="parameter"><code><a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);
134
129
  <a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="returnvalue">GtkFileFilter</span></a> * <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filter" title="gtk_file_chooser_get_filter ()">gtk_file_chooser_get_filter</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
135
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder ()">gtk_file_chooser_add_shortcut_folder</a>
136
- (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
137
- <em class="parameter"><code>const <span class="type">char</span> *folder</code></em>,
138
- <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>);
139
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-remove-shortcut-folder" title="gtk_file_chooser_remove_shortcut_folder ()">gtk_file_chooser_remove_shortcut_folder</a>
140
- (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
141
- <em class="parameter"><code>const <span class="type">char</span> *folder</code></em>,
142
- <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>);
143
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * <a class="link" href="GtkFileChooser.html#gtk-file-chooser-list-shortcut-folders" title="gtk_file_chooser_list_shortcut_folders ()">gtk_file_chooser_list_shortcut_folders</a>
144
- (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
130
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder">gtk_file_chooser_add_shortcut_folder</a>
131
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-remove-shortcut-folder" title="gtk_file_chooser_remove_shortcut_folder">gtk_file_chooser_remove_shortcut_folder</a>
132
+ #define <a class="link" href="GtkFileChooser.html#gtk-file-chooser-list-shortcut-folders" title="gtk_file_chooser_list_shortcut_folders">gtk_file_chooser_list_shortcut_folders</a>
145
133
  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder-uri" title="gtk_file_chooser_add_shortcut_folder_uri ()">gtk_file_chooser_add_shortcut_folder_uri</a>
146
134
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
147
135
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
@@ -171,26 +159,26 @@ enum <a class="link" href="GtkFileChooser.html#GtkFileChooserErro
171
159
  <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>);
172
160
  </pre>
173
161
  </div>
174
- <div class="refsect1" title="Object Hierarchy">
162
+ <div class="refsect1">
175
163
  <a name="GtkFileChooser.object-hierarchy"></a><h2>Object Hierarchy</h2>
176
164
  <pre class="synopsis">
177
165
  GInterface
178
166
  +----GtkFileChooser
179
167
  </pre>
180
168
  </div>
181
- <div class="refsect1" title="Prerequisites">
169
+ <div class="refsect1">
182
170
  <a name="GtkFileChooser.prerequisites"></a><h2>Prerequisites</h2>
183
171
  <p>
184
172
  GtkFileChooser requires
185
173
  <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>.</p>
186
174
  </div>
187
- <div class="refsect1" title="Known Implementations">
175
+ <div class="refsect1">
188
176
  <a name="GtkFileChooser.implementations"></a><h2>Known Implementations</h2>
189
177
  <p>
190
178
  GtkFileChooser is implemented by
191
179
  <a class="link" href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a>, <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog">GtkFileChooserDialog</a> and <a class="link" href="GtkFileChooserWidget.html" title="GtkFileChooserWidget">GtkFileChooserWidget</a>.</p>
192
180
  </div>
193
- <div class="refsect1" title="Properties">
181
+ <div class="refsect1">
194
182
  <a name="GtkFileChooser.properties"></a><h2>Properties</h2>
195
183
  <pre class="synopsis">
196
184
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--action" title='The "action" property'>action</a>" <a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> : Read / Write
@@ -207,17 +195,17 @@ GtkFileChooser is implemented by
207
195
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--use-preview-label" title='The "use-preview-label" property'>use-preview-label</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write
208
196
  </pre>
209
197
  </div>
210
- <div class="refsect1" title="Signals">
198
+ <div class="refsect1">
211
199
  <a name="GtkFileChooser.signals"></a><h2>Signals</h2>
212
200
  <pre class="synopsis">
213
- "<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title='The "confirm-overwrite" signal'>confirm-overwrite</a>" : Run Last
214
- "<a class="link" href="GtkFileChooser.html#GtkFileChooser-current-folder-changed" title='The "current-folder-changed" signal'>current-folder-changed</a>" : Run Last
215
- "<a class="link" href="GtkFileChooser.html#GtkFileChooser-file-activated" title='The "file-activated" signal'>file-activated</a>" : Run Last
216
- "<a class="link" href="GtkFileChooser.html#GtkFileChooser-selection-changed" title='The "selection-changed" signal'>selection-changed</a>" : Run Last
217
- "<a class="link" href="GtkFileChooser.html#GtkFileChooser-update-preview" title='The "update-preview" signal'>update-preview</a>" : Run Last
201
+ "<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title='The "confirm-overwrite" signal'>confirm-overwrite</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
202
+ "<a class="link" href="GtkFileChooser.html#GtkFileChooser-current-folder-changed" title='The "current-folder-changed" signal'>current-folder-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
203
+ "<a class="link" href="GtkFileChooser.html#GtkFileChooser-file-activated" title='The "file-activated" signal'>file-activated</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
204
+ "<a class="link" href="GtkFileChooser.html#GtkFileChooser-selection-changed" title='The "selection-changed" signal'>selection-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
205
+ "<a class="link" href="GtkFileChooser.html#GtkFileChooser-update-preview" title='The "update-preview" signal'>update-preview</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
218
206
  </pre>
219
207
  </div>
220
- <div class="refsect1" title="Description">
208
+ <div class="refsect1">
221
209
  <a name="GtkFileChooser.description"></a><h2>Description</h2>
222
210
  <p>
223
211
  <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> is an interface that can be implemented by file
@@ -265,7 +253,9 @@ sources and in various flavours, so lets explain the terminology here:
265
253
  </table></div>
266
254
  <p>
267
255
  </p>
268
- <div class="refsect2" title="File Names and Encodings">
256
+ <p>
257
+ </p>
258
+ <div class="refsect2">
269
259
  <a name="gtkfilechooser-encodings"></a><h3>File Names and Encodings</h3>
270
260
  When the user is finished selecting files in a
271
261
  <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>, your program can get the selected names
@@ -276,10 +266,10 @@ the character set specified by the
276
266
  <code class="envar">G_FILENAME_ENCODING</code> environment variable.
277
267
  Please see the Glib documentation for more details about this
278
268
  variable.
279
- <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
269
+ <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
280
270
  <h3 class="title">Note</h3>
281
271
  This means that while you can pass the result of
282
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename ()"><code class="function">gtk_file_chooser_get_filename()</code></a> to
272
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename"><code class="function">gtk_file_chooser_get_filename()</code></a> to
283
273
  <code class="function">open(2)</code> or
284
274
  <code class="function">fopen(3)</code>, you may not be able to
285
275
  directly set it as the text of a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget unless you
@@ -288,8 +278,10 @@ variable.
288
278
  into strings that can be passed to GTK+ widgets.
289
279
  </div>
290
280
  </div>
281
+ <p>
282
+ </p>
291
283
  <hr>
292
- <div class="refsect2" title="Adding a Preview Widget">
284
+ <div class="refsect2">
293
285
  <a name="gtkfilechooser-preview"></a><h3>Adding a Preview Widget</h3>
294
286
  <p>
295
287
  You can add a custom preview widget to a file chooser and then
@@ -301,7 +293,7 @@ you need to update the contents of the preview.
301
293
  </p>
302
294
  <p>
303
295
  Your callback should use
304
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename ()"><code class="function">gtk_file_chooser_get_preview_filename()</code></a> to see what needs
296
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename"><code class="function">gtk_file_chooser_get_preview_filename()</code></a> to see what needs
305
297
  previewing. Once you have generated the preview for the
306
298
  corresponding file, you must call
307
299
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()"><code class="function">gtk_file_chooser_set_preview_widget_active()</code></a> with a boolean
@@ -309,7 +301,7 @@ flag that indicates whether your callback could successfully
309
301
  generate a preview.
310
302
  </p>
311
303
  <div class="example">
312
- <a name="example-gtkfilechooser-preview"></a><p class="title"><b>Example 37. Sample Usage</b></p>
304
+ <a name="example-gtkfilechooser-preview"></a><p class="title"><b>Example 40. Sample Usage</b></p>
313
305
  <div class="example-contents">
314
306
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
315
307
  <tbody>
@@ -388,8 +380,10 @@ generate a preview.
388
380
  </div>
389
381
  <br class="example-break">
390
382
  </div>
383
+ <p>
384
+ </p>
391
385
  <hr>
392
- <div class="refsect2" title="Adding Extra Widgets">
386
+ <div class="refsect2">
393
387
  <a name="gtkfilechooser-extra"></a><h3>Adding Extra Widgets</h3>
394
388
  <p>
395
389
  You can add extra widgets to a file chooser to provide options
@@ -400,7 +394,7 @@ file in read-only mode. You can use
400
394
  widgets in a file chooser.
401
395
  </p>
402
396
  <div class="example">
403
- <a name="example-gtkfilechooser-extra"></a><p class="title"><b>Example 38. Sample Usage</b></p>
397
+ <a name="example-gtkfilechooser-extra"></a><p class="title"><b>Example 41. Sample Usage</b></p>
404
398
  <div class="example-contents">
405
399
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
406
400
  <tbody>
@@ -427,7 +421,7 @@ widgets in a file chooser.
427
421
  </div>
428
422
 
429
423
  </div>
430
- <br class="example-break"><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
424
+ <br class="example-break"><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
431
425
  <h3 class="title">Note</h3>
432
426
  If you want to set more than one extra widget in the file
433
427
  chooser, you can a container such as a <a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a> or a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>
@@ -435,8 +429,10 @@ widgets in a file chooser.
435
429
  the whole extra widget.
436
430
  </div>
437
431
  </div>
432
+ <p>
433
+ </p>
438
434
  <hr>
439
- <div class="refsect2" title="Key Bindings">
435
+ <div class="refsect2">
440
436
  <a name="gtkfilechooser-key-bindings"></a><h3>Key Bindings</h3>
441
437
  <p>
442
438
  Internally, GTK+ implements a file chooser's graphical user
@@ -447,7 +443,7 @@ bindings</a> and their associated signals. This section
447
443
  describes the available key binding signals.
448
444
  </p>
449
445
  <div class="example">
450
- <a name="gtkfilechooser-key-binding-example"></a><p class="title"><b>Example 39. GtkFileChooser key binding example</b></p>
446
+ <a name="gtkfilechooser-key-binding-example"></a><p class="title"><b>Example 42. GtkFileChooser key binding example</b></p>
451
447
  <div class="example-contents">
452
448
  <p>
453
449
  The default keys that activate the key-binding signals in
@@ -469,7 +465,7 @@ follows:
469
465
  <td>
470
466
  <span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>L</strong></span> (empty path);
471
467
  <span class="keycap"><strong>/</strong></span> (path of "/")
472
- <sup>[<a name="id1068288" href="#ftn.id1068288" class="footnote">a</a>]</sup>;
468
+ <sup>[<a name="id1075064" href="#ftn.id1075064" class="footnote">a</a>]</sup>;
473
469
  <span class="keycap"><strong>~</strong></span> (path of "~")
474
470
  </td>
475
471
  </tr>
@@ -477,7 +473,7 @@ follows:
477
473
  <td>up-folder</td>
478
474
  <td>
479
475
  <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Up</strong></span>
480
- <sup>[<a name="id1068333" href="#ftn.id1068333" class="footnote">b</a>]</sup>
476
+ <sup>[<a name="id1075108" href="#ftn.id1075108" class="footnote">b</a>]</sup>
481
477
  ;
482
478
  <span class="keycap"><strong>Backspace</strong></span>
483
479
  </td>
@@ -508,7 +504,7 @@ follows:
508
504
  </tr>
509
505
  </tbody>
510
506
  <tbody class="footnotes"><tr><td colspan="2">
511
- <div class="footnote"><span class="keycap"><strong><sup>[<a name="ftn.id1068288" href="#id1068288" class="keycap">a</a>] </sup>/</strong></span></div>
507
+ <div class="footnote"><span class="keycap"><strong><sup>[<a name="ftn.id1075064" href="#id1075064" class="keycap">a</a>] </sup>/</strong></span></div>
512
508
  <div class="footnote"></div>
513
509
  </td></tr></tbody>
514
510
  </table></div>
@@ -535,7 +531,7 @@ class "GtkFileChooserDefault" binding "my-own-gtkfilechooser-bindings"
535
531
  </pre>
536
532
  </div>
537
533
  </div>
538
- <br class="example-break"><div class="refsect3" title='The "GtkFileChooserDefault::location-popup" signal'>
534
+ <br class="example-break"><div class="refsect3">
539
535
  <a name="GtkFileChooserDefault-location-popup"></a><h4>The "GtkFileChooserDefault::location-popup" signal</h4>
540
536
  <pre class="programlisting">
541
537
  void user_function (GtkFileChooserDefault *chooser,
@@ -580,7 +576,7 @@ of "~" itself for access to home directories.
580
576
  </tr>
581
577
  </tbody>
582
578
  </table></div>
583
- <div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;">
579
+ <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
584
580
  <h3 class="title">Note</h3>
585
581
  You can create your own bindings for the
586
582
  GtkFileChooserDefault::location-popup signal with custom
@@ -601,7 +597,7 @@ of "~" itself for access to home directories.
601
597
  </pre>
602
598
  </div>
603
599
  </div>
604
- <div class="refsect3" title='The "GtkFileChooserDefault::up-folder" signal'>
600
+ <div class="refsect3">
605
601
  <a name="GtkFileChooserDefault-up-folder"></a><h4>The "GtkFileChooserDefault::up-folder" signal</h4>
606
602
  <pre class="programlisting">
607
603
  void user_function (GtkFileChooserDefault *chooser,
@@ -632,7 +628,7 @@ is bound to <span class="keycap"><strong>Backspace</strong></span> and
632
628
  </tbody>
633
629
  </table></div>
634
630
  </div>
635
- <div class="refsect3" title='The "GtkFileChooserDefault::down-folder" signal'>
631
+ <div class="refsect3">
636
632
  <a name="GtkFileChooserDefault-down-folder"></a><h4>The "GtkFileChooserDefault::down-folder" signal</h4>
637
633
  <pre class="programlisting">
638
634
  void user_function (GtkFileChooserDefault *chooser,
@@ -667,7 +663,7 @@ default this is bound to
667
663
  </tbody>
668
664
  </table></div>
669
665
  </div>
670
- <div class="refsect3" title='The "GtkFileChooserDefault::home-folder" signal'>
666
+ <div class="refsect3">
671
667
  <a name="GtkFileChooserDefault-home-folder"></a><h4>The "GtkFileChooserDefault::home-folder" signal</h4>
672
668
  <pre class="programlisting">
673
669
  void user_function (GtkFileChooserDefault *chooser,
@@ -697,7 +693,7 @@ folder in the file list. By default this is bound to
697
693
  </tbody>
698
694
  </table></div>
699
695
  </div>
700
- <div class="refsect3" title='The "GtkFileChooserDefault::desktop-folder" signal'>
696
+ <div class="refsect3">
701
697
  <a name="GtkFileChooserDefault-desktop-folder"></a><h4>The "GtkFileChooserDefault::desktop-folder" signal</h4>
702
698
  <pre class="programlisting">
703
699
  void user_function (GtkFileChooserDefault *chooser,
@@ -726,7 +722,7 @@ folder in the file list. By default this is bound to
726
722
  </tbody>
727
723
  </table></div>
728
724
  </div>
729
- <div class="refsect3" title='The "GtkFileChooserDefault::quick-bookmark" signal'>
725
+ <div class="refsect3">
730
726
  <a name="GtkFileChooserDefault-quick-bookmark"></a><h4>The "GtkFileChooserDefault::quick-bookmark" signal</h4>
731
727
  <pre class="programlisting">
732
728
  void user_function (GtkFileChooserDefault *chooser,
@@ -774,17 +770,19 @@ defined to switch to the bookmark at index 10.
774
770
  </table></div>
775
771
  </div>
776
772
  </div>
773
+ <p>
774
+ </p>
777
775
  </div>
778
- <div class="refsect1" title="Details">
776
+ <div class="refsect1">
779
777
  <a name="GtkFileChooser.details"></a><h2>Details</h2>
780
- <div class="refsect2" title="GtkFileChooser">
778
+ <div class="refsect2">
781
779
  <a name="GtkFileChooser-struct"></a><h3>GtkFileChooser</h3>
782
780
  <pre class="programlisting">typedef struct _GtkFileChooser GtkFileChooser;</pre>
783
781
  <p>
784
782
  </p>
785
783
  </div>
786
784
  <hr>
787
- <div class="refsect2" title="enum GtkFileChooserAction">
785
+ <div class="refsect2">
788
786
  <a name="GtkFileChooserAction"></a><h3>enum GtkFileChooserAction</h3>
789
787
  <pre class="programlisting">typedef enum
790
788
  {
@@ -832,7 +830,7 @@ or to save to a possibly new file.
832
830
  </table></div>
833
831
  </div>
834
832
  <hr>
835
- <div class="refsect2" title="enum GtkFileChooserConfirmation">
833
+ <div class="refsect2">
836
834
  <a name="GtkFileChooserConfirmation"></a><h3>enum GtkFileChooserConfirmation</h3>
837
835
  <pre class="programlisting">typedef enum
838
836
  {
@@ -874,7 +872,7 @@ let the user choose another filename.
874
872
  <p class="since">Since 2.8</p>
875
873
  </div>
876
874
  <hr>
877
- <div class="refsect2" title="GTK_FILE_CHOOSER_ERROR">
875
+ <div class="refsect2">
878
876
  <a name="GTK-FILE-CHOOSER-ERROR:CAPS"></a><h3>GTK_FILE_CHOOSER_ERROR</h3>
879
877
  <pre class="programlisting">#define GTK_FILE_CHOOSER_ERROR (gtk_file_chooser_error_quark ())
880
878
  </pre>
@@ -883,7 +881,7 @@ Used to get the <a href="http://library.gnome.org/devel/glib/unstable/glib-Error
883
881
  </p>
884
882
  </div>
885
883
  <hr>
886
- <div class="refsect2" title="enum GtkFileChooserError">
884
+ <div class="refsect2">
887
885
  <a name="GtkFileChooserError"></a><h3>enum GtkFileChooserError</h3>
888
886
  <pre class="programlisting">typedef enum {
889
887
  GTK_FILE_CHOOSER_ERROR_NONEXISTENT,
@@ -923,7 +921,7 @@ These identify the various errors that can occur while calling
923
921
  </table></div>
924
922
  </div>
925
923
  <hr>
926
- <div class="refsect2" title="gtk_file_chooser_set_action ()">
924
+ <div class="refsect2">
927
925
  <a name="gtk-file-chooser-set-action"></a><h3>gtk_file_chooser_set_action ()</h3>
928
926
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_action (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
929
927
  <em class="parameter"><code><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> action</code></em>);</pre>
@@ -944,15 +942,14 @@ an option to create a new folder might be shown if the action is
944
942
  </tr>
945
943
  <tr>
946
944
  <td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
947
- <td>the action that the file selector is performing
948
- </td>
945
+ <td>the action that the file selector is performing</td>
949
946
  </tr>
950
947
  </tbody>
951
948
  </table></div>
952
949
  <p class="since">Since 2.4</p>
953
950
  </div>
954
951
  <hr>
955
- <div class="refsect2" title="gtk_file_chooser_get_action ()">
952
+ <div class="refsect2">
956
953
  <a name="gtk-file-chooser-get-action"></a><h3>gtk_file_chooser_get_action ()</h3>
957
954
  <pre class="programlisting"><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a> gtk_file_chooser_get_action (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
958
955
  <p>
@@ -969,16 +966,14 @@ Gets the type of operation that the file chooser is performing; see
969
966
  </tr>
970
967
  <tr>
971
968
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
972
- <td> the action that the file selector is performing
973
-
974
- </td>
969
+ <td>the action that the file selector is performing</td>
975
970
  </tr>
976
971
  </tbody>
977
972
  </table></div>
978
973
  <p class="since">Since 2.4</p>
979
974
  </div>
980
975
  <hr>
981
- <div class="refsect2" title="gtk_file_chooser_set_local_only ()">
976
+ <div class="refsect2">
982
977
  <a name="gtk-file-chooser-set-local-only"></a><h3>gtk_file_chooser_set_local_only ()</h3>
983
978
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_local_only (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
984
979
  <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_only</code></em>);</pre>
@@ -989,7 +984,7 @@ then the selected file are files are guaranteed to be
989
984
  accessible through the operating systems native file
990
985
  file system and therefore the application only
991
986
  needs to worry about the filename functions in
992
- <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>, like <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename ()"><code class="function">gtk_file_chooser_get_filename()</code></a>,
987
+ <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>, like <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename"><code class="function">gtk_file_chooser_get_filename()</code></a>,
993
988
  rather than the URI functions like
994
989
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a>,
995
990
  </p>
@@ -1004,15 +999,14 @@ rather than the URI functions like
1004
999
  <tr>
1005
1000
  <td><p><span class="term"><em class="parameter"><code>local_only</code></em> :</span></p></td>
1006
1001
  <td>
1007
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected
1008
- </td>
1002
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected</td>
1009
1003
  </tr>
1010
1004
  </tbody>
1011
1005
  </table></div>
1012
1006
  <p class="since">Since 2.4</p>
1013
1007
  </div>
1014
1008
  <hr>
1015
- <div class="refsect2" title="gtk_file_chooser_get_local_only ()">
1009
+ <div class="refsect2">
1016
1010
  <a name="gtk-file-chooser-get-local-only"></a><h3>gtk_file_chooser_get_local_only ()</h3>
1017
1011
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_get_local_only (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1018
1012
  <p>
@@ -1029,16 +1023,15 @@ file selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-se
1029
1023
  </tr>
1030
1024
  <tr>
1031
1025
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1032
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected.
1033
-
1034
- </td>
1026
+ <td>
1027
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected.</td>
1035
1028
  </tr>
1036
1029
  </tbody>
1037
1030
  </table></div>
1038
1031
  <p class="since">Since 2.4</p>
1039
1032
  </div>
1040
1033
  <hr>
1041
- <div class="refsect2" title="gtk_file_chooser_set_select_multiple ()">
1034
+ <div class="refsect2">
1042
1035
  <a name="gtk-file-chooser-set-select-multiple"></a><h3>gtk_file_chooser_set_select_multiple ()</h3>
1043
1036
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_select_multiple
1044
1037
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
@@ -1059,15 +1052,14 @@ only relevant if the action is set to be <a class="link" href="GtkFileChooser.ht
1059
1052
  <tr>
1060
1053
  <td><p><span class="term"><em class="parameter"><code>select_multiple</code></em> :</span></p></td>
1061
1054
  <td>
1062
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.
1063
- </td>
1055
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.</td>
1064
1056
  </tr>
1065
1057
  </tbody>
1066
1058
  </table></div>
1067
1059
  <p class="since">Since 2.4</p>
1068
1060
  </div>
1069
1061
  <hr>
1070
- <div class="refsect2" title="gtk_file_chooser_get_select_multiple ()">
1062
+ <div class="refsect2">
1071
1063
  <a name="gtk-file-chooser-get-select-multiple"></a><h3>gtk_file_chooser_get_select_multiple ()</h3>
1072
1064
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_get_select_multiple
1073
1065
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
@@ -1085,16 +1077,15 @@ selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-sel
1085
1077
  </tr>
1086
1078
  <tr>
1087
1079
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1088
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.
1089
-
1090
- </td>
1080
+ <td>
1081
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.</td>
1091
1082
  </tr>
1092
1083
  </tbody>
1093
1084
  </table></div>
1094
1085
  <p class="since">Since 2.4</p>
1095
1086
  </div>
1096
1087
  <hr>
1097
- <div class="refsect2" title="gtk_file_chooser_set_show_hidden ()">
1088
+ <div class="refsect2">
1098
1089
  <a name="gtk-file-chooser-set-show-hidden"></a><h3>gtk_file_chooser_set_show_hidden ()</h3>
1099
1090
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_show_hidden (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1100
1091
  <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_hidden</code></em>);</pre>
@@ -1112,15 +1103,14 @@ Sets whether hidden files and folders are displayed in the file selector.
1112
1103
  <tr>
1113
1104
  <td><p><span class="term"><em class="parameter"><code>show_hidden</code></em> :</span></p></td>
1114
1105
  <td>
1115
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders should be displayed.
1116
- </td>
1106
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders should be displayed.</td>
1117
1107
  </tr>
1118
1108
  </tbody>
1119
1109
  </table></div>
1120
1110
  <p class="since">Since 2.6</p>
1121
1111
  </div>
1122
1112
  <hr>
1123
- <div class="refsect2" title="gtk_file_chooser_get_show_hidden ()">
1113
+ <div class="refsect2">
1124
1114
  <a name="gtk-file-chooser-get-show-hidden"></a><h3>gtk_file_chooser_get_show_hidden ()</h3>
1125
1115
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_get_show_hidden (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1126
1116
  <p>
@@ -1137,16 +1127,15 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-show-hidden"
1137
1127
  </tr>
1138
1128
  <tr>
1139
1129
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1140
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders are displayed.
1141
-
1142
- </td>
1130
+ <td>
1131
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders are displayed.</td>
1143
1132
  </tr>
1144
1133
  </tbody>
1145
1134
  </table></div>
1146
1135
  <p class="since">Since 2.6</p>
1147
1136
  </div>
1148
1137
  <hr>
1149
- <div class="refsect2" title="gtk_file_chooser_set_do_overwrite_confirmation ()">
1138
+ <div class="refsect2">
1150
1139
  <a name="gtk-file-chooser-set-do-overwrite-confirmation"></a><h3>gtk_file_chooser_set_do_overwrite_confirmation ()</h3>
1151
1140
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_do_overwrite_confirmation
1152
1141
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
@@ -1176,15 +1165,14 @@ for the details.
1176
1165
  </tr>
1177
1166
  <tr>
1178
1167
  <td><p><span class="term"><em class="parameter"><code>do_overwrite_confirmation</code></em> :</span></p></td>
1179
- <td>whether to confirm overwriting in save mode
1180
- </td>
1168
+ <td>whether to confirm overwriting in save mode</td>
1181
1169
  </tr>
1182
1170
  </tbody>
1183
1171
  </table></div>
1184
1172
  <p class="since">Since 2.8</p>
1185
1173
  </div>
1186
1174
  <hr>
1187
- <div class="refsect2" title="gtk_file_chooser_get_do_overwrite_confirmation ()">
1175
+ <div class="refsect2">
1188
1176
  <a name="gtk-file-chooser-get-do-overwrite-confirmation"></a><h3>gtk_file_chooser_get_do_overwrite_confirmation ()</h3>
1189
1177
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_get_do_overwrite_confirmation
1190
1178
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
@@ -1202,17 +1190,16 @@ types a file name that already exists.
1202
1190
  </tr>
1203
1191
  <tr>
1204
1192
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1205
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser will present a confirmation dialog;
1206
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1207
-
1208
- </td>
1193
+ <td>
1194
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser will present a confirmation dialog;
1195
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1209
1196
  </tr>
1210
1197
  </tbody>
1211
1198
  </table></div>
1212
1199
  <p class="since">Since 2.8</p>
1213
1200
  </div>
1214
1201
  <hr>
1215
- <div class="refsect2" title="gtk_file_chooser_set_create_folders ()">
1202
+ <div class="refsect2">
1216
1203
  <a name="gtk-file-chooser-set-create-folders"></a><h3>gtk_file_chooser_set_create_folders ()</h3>
1217
1204
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_create_folders (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1218
1205
  <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> create_folders</code></em>);</pre>
@@ -1232,15 +1219,14 @@ This is only relevant if the action is not set to be
1232
1219
  <tr>
1233
1220
  <td><p><span class="term"><em class="parameter"><code>create_folders</code></em> :</span></p></td>
1234
1221
  <td>
1235
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed
1236
- </td>
1222
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed</td>
1237
1223
  </tr>
1238
1224
  </tbody>
1239
1225
  </table></div>
1240
1226
  <p class="since">Since 2.18</p>
1241
1227
  </div>
1242
1228
  <hr>
1243
- <div class="refsect2" title="gtk_file_chooser_get_create_folders ()">
1229
+ <div class="refsect2">
1244
1230
  <a name="gtk-file-chooser-get-create-folders"></a><h3>gtk_file_chooser_get_create_folders ()</h3>
1245
1231
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_get_create_folders (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1246
1232
  <p>
@@ -1257,16 +1243,15 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-create-folder
1257
1243
  </tr>
1258
1244
  <tr>
1259
1245
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1260
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed.
1261
-
1262
- </td>
1246
+ <td>
1247
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed.</td>
1263
1248
  </tr>
1264
1249
  </tbody>
1265
1250
  </table></div>
1266
1251
  <p class="since">Since 2.18</p>
1267
1252
  </div>
1268
1253
  <hr>
1269
- <div class="refsect2" title="gtk_file_chooser_set_current_name ()">
1254
+ <div class="refsect2">
1270
1255
  <a name="gtk-file-chooser-set-current-name"></a><h3>gtk_file_chooser_set_current_name ()</h3>
1271
1256
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_current_name (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1272
1257
  <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> *name</code></em>);</pre>
@@ -1278,7 +1263,7 @@ such uses as a suggested name in a "Save As..." dialog.
1278
1263
  </p>
1279
1264
  <p>
1280
1265
  If you want to preselect a particular existing file, you should use
1281
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-filename" title="gtk_file_chooser_set_filename ()"><code class="function">gtk_file_chooser_set_filename()</code></a> or <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-uri" title="gtk_file_chooser_set_uri ()"><code class="function">gtk_file_chooser_set_uri()</code></a> instead.
1266
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-filename" title="gtk_file_chooser_set_filename"><code class="function">gtk_file_chooser_set_filename()</code></a> or <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-uri" title="gtk_file_chooser_set_uri ()"><code class="function">gtk_file_chooser_set_uri()</code></a> instead.
1282
1267
  Please see the documentation for those functions for an example of using
1283
1268
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-name" title="gtk_file_chooser_set_current_name ()"><code class="function">gtk_file_chooser_set_current_name()</code></a> as well.
1284
1269
  </p>
@@ -1292,17 +1277,17 @@ Please see the documentation for those functions for an example of using
1292
1277
  </tr>
1293
1278
  <tr>
1294
1279
  <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
1295
- <td>the filename to use, as a UTF-8 string
1296
- </td>
1280
+ <td>the filename to use, as a UTF-8 string</td>
1297
1281
  </tr>
1298
1282
  </tbody>
1299
1283
  </table></div>
1300
1284
  <p class="since">Since 2.4</p>
1301
1285
  </div>
1302
1286
  <hr>
1303
- <div class="refsect2" title="gtk_file_chooser_get_filename ()">
1304
- <a name="gtk-file-chooser-get-filename"></a><h3>gtk_file_chooser_get_filename ()</h3>
1305
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_file_chooser_get_filename (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1287
+ <div class="refsect2">
1288
+ <a name="gtk-file-chooser-get-filename"></a><h3>gtk_file_chooser_get_filename</h3>
1289
+ <pre class="programlisting">#define gtk_file_chooser_get_filename gtk_file_chooser_get_filename_utf8
1290
+ </pre>
1306
1291
  <p>
1307
1292
  Gets the filename for the currently selected file in
1308
1293
  the file selector. If multiple files are selected,
@@ -1322,21 +1307,19 @@ folder.
1322
1307
  </tr>
1323
1308
  <tr>
1324
1309
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1325
- <td> The currently selected filename, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1326
- if no file is selected, or the selected file can't
1327
- be represented with a local filename. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
1328
-
1329
- </td>
1310
+ <td>The currently selected filename, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1311
+ if no file is selected, or the selected file can't
1312
+ be represented with a local filename. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
1330
1313
  </tr>
1331
1314
  </tbody>
1332
1315
  </table></div>
1333
1316
  <p class="since">Since 2.4</p>
1334
1317
  </div>
1335
1318
  <hr>
1336
- <div class="refsect2" title="gtk_file_chooser_set_filename ()">
1337
- <a name="gtk-file-chooser-set-filename"></a><h3>gtk_file_chooser_set_filename ()</h3>
1338
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_set_filename (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1339
- <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>);</pre>
1319
+ <div class="refsect2">
1320
+ <a name="gtk-file-chooser-set-filename"></a><h3>gtk_file_chooser_set_filename</h3>
1321
+ <pre class="programlisting">#define gtk_file_chooser_set_filename gtk_file_chooser_set_filename_utf8
1322
+ </pre>
1340
1323
  <p>
1341
1324
  Sets <em class="parameter"><code>filename</code></em> as the current filename for the file chooser, by changing
1342
1325
  to the file's parent folder and actually selecting the file in list. If
@@ -1347,7 +1330,7 @@ will also appear in the dialog's file name entry.
1347
1330
  If the file name isn't in the current folder of <em class="parameter"><code>chooser</code></em>, then the current
1348
1331
  folder of <em class="parameter"><code>chooser</code></em> will be changed to the folder containing <em class="parameter"><code>filename</code></em>. This
1349
1332
  is equivalent to a sequence of <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-all" title="gtk_file_chooser_unselect_all ()"><code class="function">gtk_file_chooser_unselect_all()</code></a> followed by
1350
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename ()"><code class="function">gtk_file_chooser_select_filename()</code></a>.
1333
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename"><code class="function">gtk_file_chooser_select_filename()</code></a>.
1351
1334
  </p>
1352
1335
  <p>
1353
1336
  Note that the file must exist, or nothing will be done except
@@ -1405,25 +1388,23 @@ Instead, use something similar to this:
1405
1388
  </tr>
1406
1389
  <tr>
1407
1390
  <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
1408
- <td>the filename to set as current
1409
- </td>
1391
+ <td>the filename to set as current</td>
1410
1392
  </tr>
1411
1393
  <tr>
1412
1394
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1413
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
1414
- selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1415
-
1416
- </td>
1395
+ <td>
1396
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
1397
+ selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1417
1398
  </tr>
1418
1399
  </tbody>
1419
1400
  </table></div>
1420
1401
  <p class="since">Since 2.4</p>
1421
1402
  </div>
1422
1403
  <hr>
1423
- <div class="refsect2" title="gtk_file_chooser_select_filename ()">
1424
- <a name="gtk-file-chooser-select-filename"></a><h3>gtk_file_chooser_select_filename ()</h3>
1425
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_select_filename (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1426
- <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>);</pre>
1404
+ <div class="refsect2">
1405
+ <a name="gtk-file-chooser-select-filename"></a><h3>gtk_file_chooser_select_filename</h3>
1406
+ <pre class="programlisting">#define gtk_file_chooser_select_filename gtk_file_chooser_select_filename_utf8
1407
+ </pre>
1427
1408
  <p>
1428
1409
  Selects a filename. If the file name isn't in the current
1429
1410
  folder of <em class="parameter"><code>chooser</code></em>, then the current folder of <em class="parameter"><code>chooser</code></em> will
@@ -1439,25 +1420,23 @@ be changed to the folder containing <em class="parameter"><code>filename</code><
1439
1420
  </tr>
1440
1421
  <tr>
1441
1422
  <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
1442
- <td>the filename to select
1443
- </td>
1423
+ <td>the filename to select</td>
1444
1424
  </tr>
1445
1425
  <tr>
1446
1426
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1447
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
1448
- selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1449
-
1450
- </td>
1427
+ <td>
1428
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
1429
+ selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1451
1430
  </tr>
1452
1431
  </tbody>
1453
1432
  </table></div>
1454
1433
  <p class="since">Since 2.4</p>
1455
1434
  </div>
1456
1435
  <hr>
1457
- <div class="refsect2" title="gtk_file_chooser_unselect_filename ()">
1458
- <a name="gtk-file-chooser-unselect-filename"></a><h3>gtk_file_chooser_unselect_filename ()</h3>
1459
- <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_unselect_filename (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1460
- <em class="parameter"><code>const <span class="type">char</span> *filename</code></em>);</pre>
1436
+ <div class="refsect2">
1437
+ <a name="gtk-file-chooser-unselect-filename"></a><h3>gtk_file_chooser_unselect_filename</h3>
1438
+ <pre class="programlisting">#define gtk_file_chooser_unselect_filename gtk_file_chooser_unselect_filename_utf8
1439
+ </pre>
1461
1440
  <p>
1462
1441
  Unselects a currently selected filename. If the filename
1463
1442
  is not in the current directory, does not exist, or
@@ -1473,15 +1452,14 @@ is otherwise not currently selected, does nothing.
1473
1452
  </tr>
1474
1453
  <tr>
1475
1454
  <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
1476
- <td>the filename to unselect
1477
- </td>
1455
+ <td>the filename to unselect</td>
1478
1456
  </tr>
1479
1457
  </tbody>
1480
1458
  </table></div>
1481
1459
  <p class="since">Since 2.4</p>
1482
1460
  </div>
1483
1461
  <hr>
1484
- <div class="refsect2" title="gtk_file_chooser_select_all ()">
1462
+ <div class="refsect2">
1485
1463
  <a name="gtk-file-chooser-select-all"></a><h3>gtk_file_chooser_select_all ()</h3>
1486
1464
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_select_all (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1487
1465
  <p>
@@ -1498,7 +1476,7 @@ Selects all the files in the current folder of a file chooser.
1498
1476
  <p class="since">Since 2.4</p>
1499
1477
  </div>
1500
1478
  <hr>
1501
- <div class="refsect2" title="gtk_file_chooser_unselect_all ()">
1479
+ <div class="refsect2">
1502
1480
  <a name="gtk-file-chooser-unselect-all"></a><h3>gtk_file_chooser_unselect_all ()</h3>
1503
1481
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_unselect_all (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1504
1482
  <p>
@@ -1515,9 +1493,10 @@ Unselects all the files in the current folder of a file chooser.
1515
1493
  <p class="since">Since 2.4</p>
1516
1494
  </div>
1517
1495
  <hr>
1518
- <div class="refsect2" title="gtk_file_chooser_get_filenames ()">
1519
- <a name="gtk-file-chooser-get-filenames"></a><h3>gtk_file_chooser_get_filenames ()</h3>
1520
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * gtk_file_chooser_get_filenames (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1496
+ <div class="refsect2">
1497
+ <a name="gtk-file-chooser-get-filenames"></a><h3>gtk_file_chooser_get_filenames</h3>
1498
+ <pre class="programlisting">#define gtk_file_chooser_get_filenames gtk_file_chooser_get_filenames_utf8
1499
+ </pre>
1521
1500
  <p>
1522
1501
  Lists all the selected files and subfolders in the current folder of
1523
1502
  <em class="parameter"><code>chooser</code></em>. The returned names are full absolute paths. If files in the current
@@ -1534,9 +1513,9 @@ folder cannot be represented as local filenames they will be ignored. (See
1534
1513
  </tr>
1535
1514
  <tr>
1536
1515
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1537
- <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the filenames of all selected
1538
- files and subfolders in the current folder. Free the returned list
1539
- with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym> utf8]</span>
1516
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the filenames of all selected
1517
+ files and subfolders in the current folder. Free the returned list
1518
+ with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1540
1519
  </td>
1541
1520
  </tr>
1542
1521
  </tbody>
@@ -1544,10 +1523,10 @@ folder cannot be represented as local filenames they will be ignored. (See
1544
1523
  <p class="since">Since 2.4</p>
1545
1524
  </div>
1546
1525
  <hr>
1547
- <div class="refsect2" title="gtk_file_chooser_set_current_folder ()">
1548
- <a name="gtk-file-chooser-set-current-folder"></a><h3>gtk_file_chooser_set_current_folder ()</h3>
1549
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_set_current_folder (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1550
- <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>
1526
+ <div class="refsect2">
1527
+ <a name="gtk-file-chooser-set-current-folder"></a><h3>gtk_file_chooser_set_current_folder</h3>
1528
+ <pre class="programlisting">#define gtk_file_chooser_set_current_folder gtk_file_chooser_set_current_folder_utf8
1529
+ </pre>
1551
1530
  <p>
1552
1531
  Sets the current folder for <em class="parameter"><code>chooser</code></em> from a local filename.
1553
1532
  The user will be shown the full contents of the current folder,
@@ -1563,27 +1542,26 @@ plus user interface elements for navigating to other folders.
1563
1542
  </tr>
1564
1543
  <tr>
1565
1544
  <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
1566
- <td>the full path of the new current folder
1567
- </td>
1545
+ <td>the full path of the new current folder</td>
1568
1546
  </tr>
1569
1547
  <tr>
1570
1548
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1571
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1572
- otherwise.
1573
-
1574
- </td>
1549
+ <td>
1550
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1551
+ otherwise.</td>
1575
1552
  </tr>
1576
1553
  </tbody>
1577
1554
  </table></div>
1578
1555
  <p class="since">Since 2.4</p>
1579
1556
  </div>
1580
1557
  <hr>
1581
- <div class="refsect2" title="gtk_file_chooser_get_current_folder ()">
1582
- <a name="gtk-file-chooser-get-current-folder"></a><h3>gtk_file_chooser_get_current_folder ()</h3>
1583
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_file_chooser_get_current_folder (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1558
+ <div class="refsect2">
1559
+ <a name="gtk-file-chooser-get-current-folder"></a><h3>gtk_file_chooser_get_current_folder</h3>
1560
+ <pre class="programlisting">#define gtk_file_chooser_get_current_folder gtk_file_chooser_get_current_folder_utf8
1561
+ </pre>
1584
1562
  <p>
1585
1563
  Gets the current folder of <em class="parameter"><code>chooser</code></em> as a local filename.
1586
- See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder ()"><code class="function">gtk_file_chooser_set_current_folder()</code></a>.
1564
+ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder"><code class="function">gtk_file_chooser_set_current_folder()</code></a>.
1587
1565
  </p>
1588
1566
  <p>
1589
1567
  Note that this is the folder that the file chooser is currently displaying
@@ -1604,20 +1582,18 @@ usual way to get the selection.
1604
1582
  </tr>
1605
1583
  <tr>
1606
1584
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1607
- <td> the full path of the current folder, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the current
1585
+ <td>the full path of the current folder, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the current
1608
1586
  path cannot be represented as a local filename. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. This
1609
1587
  function will also return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the
1610
1588
  last folder that was requested from it; for example, as would be for calling
1611
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder ()"><code class="function">gtk_file_chooser_set_current_folder()</code></a> on a nonexistent folder.
1612
-
1613
- </td>
1589
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder"><code class="function">gtk_file_chooser_set_current_folder()</code></a> on a nonexistent folder.</td>
1614
1590
  </tr>
1615
1591
  </tbody>
1616
1592
  </table></div>
1617
1593
  <p class="since">Since 2.4</p>
1618
1594
  </div>
1619
1595
  <hr>
1620
- <div class="refsect2" title="gtk_file_chooser_get_uri ()">
1596
+ <div class="refsect2">
1621
1597
  <a name="gtk-file-chooser-get-uri"></a><h3>gtk_file_chooser_get_uri ()</h3>
1622
1598
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_file_chooser_get_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1623
1599
  <p>
@@ -1639,9 +1615,8 @@ folder.
1639
1615
  </tr>
1640
1616
  <tr>
1641
1617
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1642
- <td> The currently selected URI, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1643
- if no file is selected. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
1644
-
1618
+ <td>The currently selected URI, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1619
+ if no file is selected. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
1645
1620
  </td>
1646
1621
  </tr>
1647
1622
  </tbody>
@@ -1649,7 +1624,7 @@ folder.
1649
1624
  <p class="since">Since 2.4</p>
1650
1625
  </div>
1651
1626
  <hr>
1652
- <div class="refsect2" title="gtk_file_chooser_set_uri ()">
1627
+ <div class="refsect2">
1653
1628
  <a name="gtk-file-chooser-set-uri"></a><h3>gtk_file_chooser_set_uri ()</h3>
1654
1629
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_set_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1655
1630
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
@@ -1719,22 +1694,20 @@ Instead, use something similar to this:
1719
1694
  </tr>
1720
1695
  <tr>
1721
1696
  <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1722
- <td>the URI to set as current
1723
- </td>
1697
+ <td>the URI to set as current</td>
1724
1698
  </tr>
1725
1699
  <tr>
1726
1700
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1727
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
1728
- selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1729
-
1730
- </td>
1701
+ <td>
1702
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
1703
+ selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1731
1704
  </tr>
1732
1705
  </tbody>
1733
1706
  </table></div>
1734
1707
  <p class="since">Since 2.4</p>
1735
1708
  </div>
1736
1709
  <hr>
1737
- <div class="refsect2" title="gtk_file_chooser_select_uri ()">
1710
+ <div class="refsect2">
1738
1711
  <a name="gtk-file-chooser-select-uri"></a><h3>gtk_file_chooser_select_uri ()</h3>
1739
1712
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_select_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1740
1713
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
@@ -1753,22 +1726,20 @@ file in the current folder of <em class="parameter"><code>chooser</code></em>, t
1753
1726
  </tr>
1754
1727
  <tr>
1755
1728
  <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1756
- <td>the URI to select
1757
- </td>
1729
+ <td>the URI to select</td>
1758
1730
  </tr>
1759
1731
  <tr>
1760
1732
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1761
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
1762
- selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1763
-
1764
- </td>
1733
+ <td>
1734
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
1735
+ selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1765
1736
  </tr>
1766
1737
  </tbody>
1767
1738
  </table></div>
1768
1739
  <p class="since">Since 2.4</p>
1769
1740
  </div>
1770
1741
  <hr>
1771
- <div class="refsect2" title="gtk_file_chooser_unselect_uri ()">
1742
+ <div class="refsect2">
1772
1743
  <a name="gtk-file-chooser-unselect-uri"></a><h3>gtk_file_chooser_unselect_uri ()</h3>
1773
1744
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_unselect_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1774
1745
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
@@ -1787,15 +1758,14 @@ is otherwise not currently selected, does nothing.
1787
1758
  </tr>
1788
1759
  <tr>
1789
1760
  <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1790
- <td>the URI to unselect
1791
- </td>
1761
+ <td>the URI to unselect</td>
1792
1762
  </tr>
1793
1763
  </tbody>
1794
1764
  </table></div>
1795
1765
  <p class="since">Since 2.4</p>
1796
1766
  </div>
1797
1767
  <hr>
1798
- <div class="refsect2" title="gtk_file_chooser_get_uris ()">
1768
+ <div class="refsect2">
1799
1769
  <a name="gtk-file-chooser-get-uris"></a><h3>gtk_file_chooser_get_uris ()</h3>
1800
1770
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * gtk_file_chooser_get_uris (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1801
1771
  <p>
@@ -1812,9 +1782,9 @@ Lists all the selected files and subfolders in the current folder of
1812
1782
  </tr>
1813
1783
  <tr>
1814
1784
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1815
- <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the URIs of all selected
1816
- files and subfolders in the current folder. Free the returned list
1817
- with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym> utf8]</span>
1785
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the URIs of all selected
1786
+ files and subfolders in the current folder. Free the returned list
1787
+ with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1818
1788
  </td>
1819
1789
  </tr>
1820
1790
  </tbody>
@@ -1822,7 +1792,7 @@ Lists all the selected files and subfolders in the current folder of
1822
1792
  <p class="since">Since 2.4</p>
1823
1793
  </div>
1824
1794
  <hr>
1825
- <div class="refsect2" title="gtk_file_chooser_set_current_folder_uri ()">
1795
+ <div class="refsect2">
1826
1796
  <a name="gtk-file-chooser-set-current-folder-uri"></a><h3>gtk_file_chooser_set_current_folder_uri ()</h3>
1827
1797
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_set_current_folder_uri
1828
1798
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
@@ -1842,22 +1812,20 @@ plus user interface elements for navigating to other folders.
1842
1812
  </tr>
1843
1813
  <tr>
1844
1814
  <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
1845
- <td>the URI for the new current folder
1846
- </td>
1815
+ <td>the URI for the new current folder</td>
1847
1816
  </tr>
1848
1817
  <tr>
1849
1818
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1850
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1851
- otherwise.
1852
-
1853
- </td>
1819
+ <td>
1820
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1821
+ otherwise.</td>
1854
1822
  </tr>
1855
1823
  </tbody>
1856
1824
  </table></div>
1857
1825
  <p class="since">Since 2.4</p>
1858
1826
  </div>
1859
1827
  <hr>
1860
- <div class="refsect2" title="gtk_file_chooser_get_current_folder_uri ()">
1828
+ <div class="refsect2">
1861
1829
  <a name="gtk-file-chooser-get-current-folder-uri"></a><h3>gtk_file_chooser_get_current_folder_uri ()</h3>
1862
1830
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * gtk_file_chooser_get_current_folder_uri
1863
1831
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
@@ -1884,19 +1852,17 @@ usual way to get the selection.
1884
1852
  </tr>
1885
1853
  <tr>
1886
1854
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1887
- <td> the URI for the current folder. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. This
1855
+ <td>the URI for the current folder. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. This
1888
1856
  function will also return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the
1889
1857
  last folder that was requested from it; for example, as would be for calling
1890
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()"><code class="function">gtk_file_chooser_set_current_folder_uri()</code></a> on a nonexistent folder.
1891
-
1892
- </td>
1858
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()"><code class="function">gtk_file_chooser_set_current_folder_uri()</code></a> on a nonexistent folder.</td>
1893
1859
  </tr>
1894
1860
  </tbody>
1895
1861
  </table></div>
1896
1862
  <p class="since">Since 2.4</p>
1897
1863
  </div>
1898
1864
  <hr>
1899
- <div class="refsect2" title="gtk_file_chooser_set_preview_widget ()">
1865
+ <div class="refsect2">
1900
1866
  <a name="gtk-file-chooser-set-preview-widget"></a><h3>gtk_file_chooser_set_preview_widget ()</h3>
1901
1867
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_preview_widget (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1902
1868
  <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *preview_widget</code></em>);</pre>
@@ -1904,7 +1870,7 @@ last folder that was requested from it; for example, as would be for calling
1904
1870
  Sets an application-supplied widget to use to display a custom preview
1905
1871
  of the currently selected file. To implement a preview, after setting the
1906
1872
  preview widget, you connect to the <a class="link" href="GtkFileChooser.html#GtkFileChooser-update-preview" title='The "update-preview" signal'><span class="type">"update-preview"</span></a>
1907
- signal, and call <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename ()"><code class="function">gtk_file_chooser_get_preview_filename()</code></a> or
1873
+ signal, and call <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename"><code class="function">gtk_file_chooser_get_preview_filename()</code></a> or
1908
1874
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()"><code class="function">gtk_file_chooser_get_preview_uri()</code></a> on each change. If you can
1909
1875
  display a preview of the new file, update your widget and
1910
1876
  set the preview active using <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()"><code class="function">gtk_file_chooser_set_preview_widget_active()</code></a>.
@@ -1926,15 +1892,14 @@ it may display no preview at all.
1926
1892
  </tr>
1927
1893
  <tr>
1928
1894
  <td><p><span class="term"><em class="parameter"><code>preview_widget</code></em> :</span></p></td>
1929
- <td>widget for displaying preview.
1930
- </td>
1895
+ <td>widget for displaying preview.</td>
1931
1896
  </tr>
1932
1897
  </tbody>
1933
1898
  </table></div>
1934
1899
  <p class="since">Since 2.4</p>
1935
1900
  </div>
1936
1901
  <hr>
1937
- <div class="refsect2" title="gtk_file_chooser_get_preview_widget ()">
1902
+ <div class="refsect2">
1938
1903
  <a name="gtk-file-chooser-get-preview-widget"></a><h3>gtk_file_chooser_get_preview_widget ()</h3>
1939
1904
  <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_file_chooser_get_preview_widget (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1940
1905
  <p>
@@ -1951,8 +1916,7 @@ Gets the current preview widget; see
1951
1916
  </tr>
1952
1917
  <tr>
1953
1918
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1954
- <td> the current preview widget, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1955
-
1919
+ <td>the current preview widget, 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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1956
1920
  </td>
1957
1921
  </tr>
1958
1922
  </tbody>
@@ -1960,7 +1924,7 @@ Gets the current preview widget; see
1960
1924
  <p class="since">Since 2.4</p>
1961
1925
  </div>
1962
1926
  <hr>
1963
- <div class="refsect2" title="gtk_file_chooser_set_preview_widget_active ()">
1927
+ <div class="refsect2">
1964
1928
  <a name="gtk-file-chooser-set-preview-widget-active"></a><h3>gtk_file_chooser_set_preview_widget_active ()</h3>
1965
1929
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_preview_widget_active
1966
1930
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
@@ -1983,15 +1947,14 @@ or it may display no preview at all. See
1983
1947
  </tr>
1984
1948
  <tr>
1985
1949
  <td><p><span class="term"><em class="parameter"><code>active</code></em> :</span></p></td>
1986
- <td>whether to display the user-specified preview widget
1987
- </td>
1950
+ <td>whether to display the user-specified preview widget</td>
1988
1951
  </tr>
1989
1952
  </tbody>
1990
1953
  </table></div>
1991
1954
  <p class="since">Since 2.4</p>
1992
1955
  </div>
1993
1956
  <hr>
1994
- <div class="refsect2" title="gtk_file_chooser_get_preview_widget_active ()">
1957
+ <div class="refsect2">
1995
1958
  <a name="gtk-file-chooser-get-preview-widget-active"></a><h3>gtk_file_chooser_get_preview_widget_active ()</h3>
1996
1959
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_get_preview_widget_active
1997
1960
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
@@ -2010,16 +1973,15 @@ should be shown for the current filename. See
2010
1973
  </tr>
2011
1974
  <tr>
2012
1975
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2013
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the preview widget is active for the current filename.
2014
-
2015
- </td>
1976
+ <td>
1977
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the preview widget is active for the current filename.</td>
2016
1978
  </tr>
2017
1979
  </tbody>
2018
1980
  </table></div>
2019
1981
  <p class="since">Since 2.4</p>
2020
1982
  </div>
2021
1983
  <hr>
2022
- <div class="refsect2" title="gtk_file_chooser_set_use_preview_label ()">
1984
+ <div class="refsect2">
2023
1985
  <a name="gtk-file-chooser-set-use-preview-label"></a><h3>gtk_file_chooser_set_use_preview_label ()</h3>
2024
1986
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_use_preview_label
2025
1987
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
@@ -2043,15 +2005,14 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview
2043
2005
  </tr>
2044
2006
  <tr>
2045
2007
  <td><p><span class="term"><em class="parameter"><code>use_label</code></em> :</span></p></td>
2046
- <td>whether to display a stock label with the name of the previewed file
2047
- </td>
2008
+ <td>whether to display a stock label with the name of the previewed file</td>
2048
2009
  </tr>
2049
2010
  </tbody>
2050
2011
  </table></div>
2051
2012
  <p class="since">Since 2.4</p>
2052
2013
  </div>
2053
2014
  <hr>
2054
- <div class="refsect2" title="gtk_file_chooser_get_use_preview_label ()">
2015
+ <div class="refsect2">
2055
2016
  <a name="gtk-file-chooser-get-use-preview-label"></a><h3>gtk_file_chooser_get_use_preview_label ()</h3>
2056
2017
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_get_use_preview_label
2057
2018
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
@@ -2069,18 +2030,18 @@ file. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-use-pr
2069
2030
  </tr>
2070
2031
  <tr>
2071
2032
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2072
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser is set to display a label with the
2073
- name of the previewed file, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2074
- </td>
2033
+ <td>
2034
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser is set to display a label with the
2035
+ name of the previewed file, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
2075
2036
  </tr>
2076
2037
  </tbody>
2077
2038
  </table></div>
2078
2039
  </div>
2079
2040
  <hr>
2080
- <div class="refsect2" title="gtk_file_chooser_get_preview_filename ()">
2081
- <a name="gtk-file-chooser-get-preview-filename"></a><h3>gtk_file_chooser_get_preview_filename ()</h3>
2082
- <pre class="programlisting"><span class="returnvalue">char</span> * gtk_file_chooser_get_preview_filename
2083
- (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2041
+ <div class="refsect2">
2042
+ <a name="gtk-file-chooser-get-preview-filename"></a><h3>gtk_file_chooser_get_preview_filename</h3>
2043
+ <pre class="programlisting">#define gtk_file_chooser_get_preview_filename gtk_file_chooser_get_preview_filename_utf8
2044
+ </pre>
2084
2045
  <p>
2085
2046
  Gets the filename that should be previewed in a custom preview
2086
2047
  widget. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>.
@@ -2095,10 +2056,9 @@ widget. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-previ
2095
2056
  </tr>
2096
2057
  <tr>
2097
2058
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2098
- <td> the filename to preview, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file
2099
- is selected, or if the selected file cannot be represented
2100
- as a local filename. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
2101
-
2059
+ <td>the filename to preview, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file
2060
+ is selected, or if the selected file cannot be represented
2061
+ as a local filename. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
2102
2062
  </td>
2103
2063
  </tr>
2104
2064
  </tbody>
@@ -2106,7 +2066,7 @@ widget. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-previ
2106
2066
  <p class="since">Since 2.4</p>
2107
2067
  </div>
2108
2068
  <hr>
2109
- <div class="refsect2" title="gtk_file_chooser_get_preview_uri ()">
2069
+ <div class="refsect2">
2110
2070
  <a name="gtk-file-chooser-get-preview-uri"></a><h3>gtk_file_chooser_get_preview_uri ()</h3>
2111
2071
  <pre class="programlisting"><span class="returnvalue">char</span> * gtk_file_chooser_get_preview_uri (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2112
2072
  <p>
@@ -2123,17 +2083,15 @@ widget. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-previ
2123
2083
  </tr>
2124
2084
  <tr>
2125
2085
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2126
- <td> the URI for the file to preview, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is
2127
- selected. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
2128
-
2129
- </td>
2086
+ <td>the URI for the file to preview, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is
2087
+ selected. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
2130
2088
  </tr>
2131
2089
  </tbody>
2132
2090
  </table></div>
2133
2091
  <p class="since">Since 2.4</p>
2134
2092
  </div>
2135
2093
  <hr>
2136
- <div class="refsect2" title="gtk_file_chooser_set_extra_widget ()">
2094
+ <div class="refsect2">
2137
2095
  <a name="gtk-file-chooser-set-extra-widget"></a><h3>gtk_file_chooser_set_extra_widget ()</h3>
2138
2096
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_extra_widget (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2139
2097
  <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *extra_widget</code></em>);</pre>
@@ -2150,15 +2108,14 @@ Sets an application-supplied widget to provide extra options to the user.
2150
2108
  </tr>
2151
2109
  <tr>
2152
2110
  <td><p><span class="term"><em class="parameter"><code>extra_widget</code></em> :</span></p></td>
2153
- <td>widget for extra options
2154
- </td>
2111
+ <td>widget for extra options</td>
2155
2112
  </tr>
2156
2113
  </tbody>
2157
2114
  </table></div>
2158
2115
  <p class="since">Since 2.4</p>
2159
2116
  </div>
2160
2117
  <hr>
2161
- <div class="refsect2" title="gtk_file_chooser_get_extra_widget ()">
2118
+ <div class="refsect2">
2162
2119
  <a name="gtk-file-chooser-get-extra-widget"></a><h3>gtk_file_chooser_get_extra_widget ()</h3>
2163
2120
  <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> * gtk_file_chooser_get_extra_widget (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2164
2121
  <p>
@@ -2175,8 +2132,7 @@ Gets the current preview widget; see
2175
2132
  </tr>
2176
2133
  <tr>
2177
2134
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2178
- <td> the current extra widget, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2179
-
2135
+ <td>the current extra widget, 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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2180
2136
  </td>
2181
2137
  </tr>
2182
2138
  </tbody>
@@ -2184,7 +2140,7 @@ Gets the current preview widget; see
2184
2140
  <p class="since">Since 2.4</p>
2185
2141
  </div>
2186
2142
  <hr>
2187
- <div class="refsect2" title="gtk_file_chooser_add_filter ()">
2143
+ <div class="refsect2">
2188
2144
  <a name="gtk-file-chooser-add-filter"></a><h3>gtk_file_chooser_add_filter ()</h3>
2189
2145
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_add_filter (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2190
2146
  <em class="parameter"><code><a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);</pre>
@@ -2215,7 +2171,7 @@ ref and sink it if you want to keep a reference.
2215
2171
  <p class="since">Since 2.4</p>
2216
2172
  </div>
2217
2173
  <hr>
2218
- <div class="refsect2" title="gtk_file_chooser_remove_filter ()">
2174
+ <div class="refsect2">
2219
2175
  <a name="gtk-file-chooser-remove-filter"></a><h3>gtk_file_chooser_remove_filter ()</h3>
2220
2176
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_remove_filter (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2221
2177
  <em class="parameter"><code><a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);</pre>
@@ -2240,7 +2196,7 @@ Removes <em class="parameter"><code>filter</code></em> from the list of filters
2240
2196
  <p class="since">Since 2.4</p>
2241
2197
  </div>
2242
2198
  <hr>
2243
- <div class="refsect2" title="gtk_file_chooser_list_filters ()">
2199
+ <div class="refsect2">
2244
2200
  <a name="gtk-file-chooser-list-filters"></a><h3>gtk_file_chooser_list_filters ()</h3>
2245
2201
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * gtk_file_chooser_list_filters (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2246
2202
  <p>
@@ -2257,10 +2213,10 @@ Lists the current set of user-selectable filters; see
2257
2213
  </tr>
2258
2214
  <tr>
2259
2215
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2260
- <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the current set of
2261
- user selectable filters. The contents of the list are
2262
- owned by GTK+, but you must free the list itself with
2263
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> when you are done with it. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym> utf8]</span>
2216
+ <td>a
2217
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the current set of user selectable filters. The
2218
+ contents of the list are owned by GTK+, but you must free the list
2219
+ itself with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> when you are done with it. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkFileFilter][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
2264
2220
  </td>
2265
2221
  </tr>
2266
2222
  </tbody>
@@ -2268,7 +2224,7 @@ Lists the current set of user-selectable filters; see
2268
2224
  <p class="since">Since 2.4</p>
2269
2225
  </div>
2270
2226
  <hr>
2271
- <div class="refsect2" title="gtk_file_chooser_set_filter ()">
2227
+ <div class="refsect2">
2272
2228
  <a name="gtk-file-chooser-set-filter"></a><h3>gtk_file_chooser_set_filter ()</h3>
2273
2229
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_set_filter (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2274
2230
  <em class="parameter"><code><a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);</pre>
@@ -2298,7 +2254,7 @@ set of files without letting the user change it.
2298
2254
  <p class="since">Since 2.4</p>
2299
2255
  </div>
2300
2256
  <hr>
2301
- <div class="refsect2" title="gtk_file_chooser_get_filter ()">
2257
+ <div class="refsect2">
2302
2258
  <a name="gtk-file-chooser-get-filter"></a><h3>gtk_file_chooser_get_filter ()</h3>
2303
2259
  <pre class="programlisting"><a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="returnvalue">GtkFileFilter</span></a> * gtk_file_chooser_get_filter (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2304
2260
  <p>
@@ -2314,8 +2270,7 @@ Gets the current filter; see <a class="link" href="GtkFileChooser.html#gtk-file-
2314
2270
  </tr>
2315
2271
  <tr>
2316
2272
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2317
- <td> the current filter, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
2318
-
2273
+ <td>the current filter, 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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2319
2274
  </td>
2320
2275
  </tr>
2321
2276
  </tbody>
@@ -2323,12 +2278,10 @@ Gets the current filter; see <a class="link" href="GtkFileChooser.html#gtk-file-
2323
2278
  <p class="since">Since 2.4</p>
2324
2279
  </div>
2325
2280
  <hr>
2326
- <div class="refsect2" title="gtk_file_chooser_add_shortcut_folder ()">
2327
- <a name="gtk-file-chooser-add-shortcut-folder"></a><h3>gtk_file_chooser_add_shortcut_folder ()</h3>
2328
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_add_shortcut_folder
2329
- (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2330
- <em class="parameter"><code>const <span class="type">char</span> *folder</code></em>,
2331
- <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>
2281
+ <div class="refsect2">
2282
+ <a name="gtk-file-chooser-add-shortcut-folder"></a><h3>gtk_file_chooser_add_shortcut_folder</h3>
2283
+ <pre class="programlisting">#define gtk_file_chooser_add_shortcut_folder gtk_file_chooser_add_shortcut_folder_utf8
2284
+ </pre>
2332
2285
  <p>
2333
2286
  Adds a folder to be displayed with the shortcut folders in a file chooser.
2334
2287
  Note that shortcut folders do not get saved, as they are provided by the
@@ -2345,32 +2298,28 @@ application. For example, you can use this to add a
2345
2298
  </tr>
2346
2299
  <tr>
2347
2300
  <td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
2348
- <td>filename of the folder to add
2349
- </td>
2301
+ <td>filename of the folder to add</td>
2350
2302
  </tr>
2351
2303
  <tr>
2352
2304
  <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2353
- <td> location to store error, 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>
2305
+ <td>location to store error, 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>
2354
2306
  </td>
2355
2307
  </tr>
2356
2308
  <tr>
2357
2309
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2358
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2359
- otherwise. In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.
2360
-
2361
- </td>
2310
+ <td>
2311
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2312
+ otherwise. In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.</td>
2362
2313
  </tr>
2363
2314
  </tbody>
2364
2315
  </table></div>
2365
2316
  <p class="since">Since 2.4</p>
2366
2317
  </div>
2367
2318
  <hr>
2368
- <div class="refsect2" title="gtk_file_chooser_remove_shortcut_folder ()">
2369
- <a name="gtk-file-chooser-remove-shortcut-folder"></a><h3>gtk_file_chooser_remove_shortcut_folder ()</h3>
2370
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_remove_shortcut_folder
2371
- (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2372
- <em class="parameter"><code>const <span class="type">char</span> *folder</code></em>,
2373
- <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>
2319
+ <div class="refsect2">
2320
+ <a name="gtk-file-chooser-remove-shortcut-folder"></a><h3>gtk_file_chooser_remove_shortcut_folder</h3>
2321
+ <pre class="programlisting">#define gtk_file_chooser_remove_shortcut_folder gtk_file_chooser_remove_shortcut_folder_utf8
2322
+ </pre>
2374
2323
  <p>
2375
2324
  Removes a folder from a file chooser's list of shortcut folders.
2376
2325
  </p>
@@ -2384,21 +2333,19 @@ Removes a folder from a file chooser's list of shortcut folders.
2384
2333
  </tr>
2385
2334
  <tr>
2386
2335
  <td><p><span class="term"><em class="parameter"><code>folder</code></em> :</span></p></td>
2387
- <td>filename of the folder to remove
2388
- </td>
2336
+ <td>filename of the folder to remove</td>
2389
2337
  </tr>
2390
2338
  <tr>
2391
2339
  <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2392
- <td> location to store error, 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>
2340
+ <td>location to store error, 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>
2393
2341
  </td>
2394
2342
  </tr>
2395
2343
  <tr>
2396
2344
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2397
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2345
+ <td>
2346
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2398
2347
  In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.
2399
-
2400
- See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder ()"><code class="function">gtk_file_chooser_add_shortcut_folder()</code></a>
2401
-
2348
+ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder"><code class="function">gtk_file_chooser_add_shortcut_folder()</code></a>
2402
2349
  </td>
2403
2350
  </tr>
2404
2351
  </tbody>
@@ -2406,13 +2353,13 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcu
2406
2353
  <p class="since">Since 2.4</p>
2407
2354
  </div>
2408
2355
  <hr>
2409
- <div class="refsect2" title="gtk_file_chooser_list_shortcut_folders ()">
2410
- <a name="gtk-file-chooser-list-shortcut-folders"></a><h3>gtk_file_chooser_list_shortcut_folders ()</h3>
2411
- <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * gtk_file_chooser_list_shortcut_folders
2412
- (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2356
+ <div class="refsect2">
2357
+ <a name="gtk-file-chooser-list-shortcut-folders"></a><h3>gtk_file_chooser_list_shortcut_folders</h3>
2358
+ <pre class="programlisting">#define gtk_file_chooser_list_shortcut_folders gtk_file_chooser_list_shortcut_folders_utf8
2359
+ </pre>
2413
2360
  <p>
2414
2361
  Queries the list of shortcut folders in the file chooser, as set by
2415
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder ()"><code class="function">gtk_file_chooser_add_shortcut_folder()</code></a>.
2362
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder"><code class="function">gtk_file_chooser_add_shortcut_folder()</code></a>.
2416
2363
  </p>
2417
2364
  <div class="variablelist"><table border="0">
2418
2365
  <col align="left" valign="top">
@@ -2424,9 +2371,9 @@ Queries the list of shortcut folders in the file chooser, as set by
2424
2371
  </tr>
2425
2372
  <tr>
2426
2373
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2427
- <td> A list of folder filenames, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut
2374
+ <td>A list of folder filenames, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut
2428
2375
  folders. Free the returned list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with
2429
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym> utf8]</span>
2376
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2430
2377
  </td>
2431
2378
  </tr>
2432
2379
  </tbody>
@@ -2434,7 +2381,7 @@ folders. Free the returned list with <a href="http://library.gnome.org/devel/gl
2434
2381
  <p class="since">Since 2.4</p>
2435
2382
  </div>
2436
2383
  <hr>
2437
- <div class="refsect2" title="gtk_file_chooser_add_shortcut_folder_uri ()">
2384
+ <div class="refsect2">
2438
2385
  <a name="gtk-file-chooser-add-shortcut-folder-uri"></a><h3>gtk_file_chooser_add_shortcut_folder_uri ()</h3>
2439
2386
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_add_shortcut_folder_uri
2440
2387
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
@@ -2456,27 +2403,25 @@ by the application. For example, you can use this to add a
2456
2403
  </tr>
2457
2404
  <tr>
2458
2405
  <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
2459
- <td>URI of the folder to add
2460
- </td>
2406
+ <td>URI of the folder to add</td>
2461
2407
  </tr>
2462
2408
  <tr>
2463
2409
  <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2464
- <td> location to store error, 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>
2410
+ <td>location to store error, 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>
2465
2411
  </td>
2466
2412
  </tr>
2467
2413
  <tr>
2468
2414
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2469
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2470
- otherwise. In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.
2471
-
2472
- </td>
2415
+ <td>
2416
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2417
+ otherwise. In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.</td>
2473
2418
  </tr>
2474
2419
  </tbody>
2475
2420
  </table></div>
2476
2421
  <p class="since">Since 2.4</p>
2477
2422
  </div>
2478
2423
  <hr>
2479
- <div class="refsect2" title="gtk_file_chooser_remove_shortcut_folder_uri ()">
2424
+ <div class="refsect2">
2480
2425
  <a name="gtk-file-chooser-remove-shortcut-folder-uri"></a><h3>gtk_file_chooser_remove_shortcut_folder_uri ()</h3>
2481
2426
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_remove_shortcut_folder_uri
2482
2427
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
@@ -2495,21 +2440,19 @@ Removes a folder URI from a file chooser's list of shortcut folders.
2495
2440
  </tr>
2496
2441
  <tr>
2497
2442
  <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
2498
- <td>URI of the folder to remove
2499
- </td>
2443
+ <td>URI of the folder to remove</td>
2500
2444
  </tr>
2501
2445
  <tr>
2502
2446
  <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2503
- <td> location to store error, 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>
2447
+ <td>location to store error, 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>
2504
2448
  </td>
2505
2449
  </tr>
2506
2450
  <tr>
2507
2451
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2508
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2452
+ <td>
2453
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2509
2454
  In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.
2510
-
2511
2455
  See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder-uri" title="gtk_file_chooser_add_shortcut_folder_uri ()"><code class="function">gtk_file_chooser_add_shortcut_folder_uri()</code></a>
2512
-
2513
2456
  </td>
2514
2457
  </tr>
2515
2458
  </tbody>
@@ -2517,7 +2460,7 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcu
2517
2460
  <p class="since">Since 2.4</p>
2518
2461
  </div>
2519
2462
  <hr>
2520
- <div class="refsect2" title="gtk_file_chooser_list_shortcut_folder_uris ()">
2463
+ <div class="refsect2">
2521
2464
  <a name="gtk-file-chooser-list-shortcut-folder-uris"></a><h3>gtk_file_chooser_list_shortcut_folder_uris ()</h3>
2522
2465
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * gtk_file_chooser_list_shortcut_folder_uris
2523
2466
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
@@ -2535,9 +2478,9 @@ Queries the list of shortcut folders in the file chooser, as set by
2535
2478
  </tr>
2536
2479
  <tr>
2537
2480
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2538
- <td> A list of folder URIs, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut
2481
+ <td>A list of folder URIs, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut
2539
2482
  folders. Free the returned list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the URIs with
2540
- <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym> utf8]</span>
2483
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2541
2484
  </td>
2542
2485
  </tr>
2543
2486
  </tbody>
@@ -2545,7 +2488,7 @@ folders. Free the returned list with <a href="http://library.gnome.org/devel/gl
2545
2488
  <p class="since">Since 2.4</p>
2546
2489
  </div>
2547
2490
  <hr>
2548
- <div class="refsect2" title="gtk_file_chooser_get_current_folder_file ()">
2491
+ <div class="refsect2">
2549
2492
  <a name="gtk-file-chooser-get-current-folder-file"></a><h3>gtk_file_chooser_get_current_folder_file ()</h3>
2550
2493
  <pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="returnvalue">GFile</span></a> * gtk_file_chooser_get_current_folder_file
2551
2494
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
@@ -2563,8 +2506,7 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folde
2563
2506
  </tr>
2564
2507
  <tr>
2565
2508
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2566
- <td> the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the current folder.
2567
-
2509
+ <td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the current folder. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2568
2510
  </td>
2569
2511
  </tr>
2570
2512
  </tbody>
@@ -2572,7 +2514,7 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folde
2572
2514
  <p class="since">Since 2.14</p>
2573
2515
  </div>
2574
2516
  <hr>
2575
- <div class="refsect2" title="gtk_file_chooser_get_file ()">
2517
+ <div class="refsect2">
2576
2518
  <a name="gtk-file-chooser-get-file"></a><h3>gtk_file_chooser_get_file ()</h3>
2577
2519
  <pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="returnvalue">GFile</span></a> * gtk_file_chooser_get_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2578
2520
  <p>
@@ -2594,9 +2536,8 @@ folder.
2594
2536
  </tr>
2595
2537
  <tr>
2596
2538
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2597
- <td> a selected <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a>. You own the returned file; use
2598
- <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release it.
2599
-
2539
+ <td>a selected <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a>. You own the returned file;
2540
+ use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2600
2541
  </td>
2601
2542
  </tr>
2602
2543
  </tbody>
@@ -2604,7 +2545,7 @@ folder.
2604
2545
  <p class="since">Since 2.14</p>
2605
2546
  </div>
2606
2547
  <hr>
2607
- <div class="refsect2" title="gtk_file_chooser_get_files ()">
2548
+ <div class="refsect2">
2608
2549
  <a name="gtk-file-chooser-get-files"></a><h3>gtk_file_chooser_get_files ()</h3>
2609
2550
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> * gtk_file_chooser_get_files (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2610
2551
  <p>
@@ -2621,9 +2562,10 @@ as <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class=
2621
2562
  </tr>
2622
2563
  <tr>
2623
2564
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2624
- <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing a <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for each selected
2625
- file and subfolder in the current folder. Free the returned list
2626
- with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the files with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym> utf8]</span>
2565
+ <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
2566
+ containing a <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for each selected file and subfolder in the
2567
+ current folder. Free the returned list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and
2568
+ the files with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GFile][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2627
2569
  </td>
2628
2570
  </tr>
2629
2571
  </tbody>
@@ -2631,7 +2573,7 @@ as <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class=
2631
2573
  <p class="since">Since 2.14</p>
2632
2574
  </div>
2633
2575
  <hr>
2634
- <div class="refsect2" title="gtk_file_chooser_get_preview_file ()">
2576
+ <div class="refsect2">
2635
2577
  <a name="gtk-file-chooser-get-preview-file"></a><h3>gtk_file_chooser_get_preview_file ()</h3>
2636
2578
  <pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="returnvalue">GFile</span></a> * gtk_file_chooser_get_preview_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2637
2579
  <p>
@@ -2648,9 +2590,8 @@ Internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-choose
2648
2590
  </tr>
2649
2591
  <tr>
2650
2592
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2651
- <td> the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the file to preview, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file
2652
- is selected. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.
2653
-
2593
+ <td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the file to preview,
2594
+ or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is selected. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2654
2595
  </td>
2655
2596
  </tr>
2656
2597
  </tbody>
@@ -2658,7 +2599,7 @@ Internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-choose
2658
2599
  <p class="since">Since 2.14</p>
2659
2600
  </div>
2660
2601
  <hr>
2661
- <div class="refsect2" title="gtk_file_chooser_select_file ()">
2602
+ <div class="refsect2">
2662
2603
  <a name="gtk-file-chooser-select-file"></a><h3>gtk_file_chooser_select_file ()</h3>
2663
2604
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_select_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2664
2605
  <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
@@ -2677,27 +2618,25 @@ Selects the file referred to by <em class="parameter"><code>file</code></em>. An
2677
2618
  </tr>
2678
2619
  <tr>
2679
2620
  <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2680
- <td>the file to select
2681
- </td>
2621
+ <td>the file to select</td>
2682
2622
  </tr>
2683
2623
  <tr>
2684
2624
  <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2685
- <td> location to store error, 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>
2625
+ <td>location to store error, 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>
2686
2626
  </td>
2687
2627
  </tr>
2688
2628
  <tr>
2689
2629
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2690
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the path was
2691
- selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2692
-
2693
- </td>
2630
+ <td>
2631
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the path was
2632
+ selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
2694
2633
  </tr>
2695
2634
  </tbody>
2696
2635
  </table></div>
2697
2636
  <p class="since">Since 2.14</p>
2698
2637
  </div>
2699
2638
  <hr>
2700
- <div class="refsect2" title="gtk_file_chooser_set_current_folder_file ()">
2639
+ <div class="refsect2">
2701
2640
  <a name="gtk-file-chooser-set-current-folder-file"></a><h3>gtk_file_chooser_set_current_folder_file ()</h3>
2702
2641
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_set_current_folder_file
2703
2642
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
@@ -2717,27 +2656,25 @@ Internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-choose
2717
2656
  </tr>
2718
2657
  <tr>
2719
2658
  <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2720
- <td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the new folder
2721
- </td>
2659
+ <td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the new folder</td>
2722
2660
  </tr>
2723
2661
  <tr>
2724
2662
  <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2725
- <td> location to store error, 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>
2663
+ <td>location to store error, 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>
2726
2664
  </td>
2727
2665
  </tr>
2728
2666
  <tr>
2729
2667
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2730
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2731
- otherwise.
2732
-
2733
- </td>
2668
+ <td>
2669
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2670
+ otherwise.</td>
2734
2671
  </tr>
2735
2672
  </tbody>
2736
2673
  </table></div>
2737
2674
  <p class="since">Since 2.14</p>
2738
2675
  </div>
2739
2676
  <hr>
2740
- <div class="refsect2" title="gtk_file_chooser_set_file ()">
2677
+ <div class="refsect2">
2741
2678
  <a name="gtk-file-chooser-set-file"></a><h3>gtk_file_chooser_set_file ()</h3>
2742
2679
  <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gtk_file_chooser_set_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2743
2680
  <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
@@ -2752,7 +2689,7 @@ will also appear in the dialog's file name entry.
2752
2689
  If the file name isn't in the current folder of <em class="parameter"><code>chooser</code></em>, then the current
2753
2690
  folder of <em class="parameter"><code>chooser</code></em> will be changed to the folder containing <em class="parameter"><code>filename</code></em>. This
2754
2691
  is equivalent to a sequence of <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-all" title="gtk_file_chooser_unselect_all ()"><code class="function">gtk_file_chooser_unselect_all()</code></a> followed by
2755
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename ()"><code class="function">gtk_file_chooser_select_filename()</code></a>.
2692
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename"><code class="function">gtk_file_chooser_select_filename()</code></a>.
2756
2693
  </p>
2757
2694
  <p>
2758
2695
  Note that the file must exist, or nothing will be done except
@@ -2810,27 +2747,25 @@ Instead, use something similar to this:
2810
2747
  </tr>
2811
2748
  <tr>
2812
2749
  <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2813
- <td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> to set as current
2814
- </td>
2750
+ <td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> to set as current</td>
2815
2751
  </tr>
2816
2752
  <tr>
2817
2753
  <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2818
- <td> location to store the error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2754
+ <td>location to store the error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2819
2755
  </td>
2820
2756
  </tr>
2821
2757
  <tr>
2822
2758
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2823
- <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
2824
- selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2825
-
2826
- </td>
2759
+ <td>
2760
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
2761
+ selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
2827
2762
  </tr>
2828
2763
  </tbody>
2829
2764
  </table></div>
2830
2765
  <p class="since">Since 2.14</p>
2831
2766
  </div>
2832
2767
  <hr>
2833
- <div class="refsect2" title="gtk_file_chooser_unselect_file ()">
2768
+ <div class="refsect2">
2834
2769
  <a name="gtk-file-chooser-unselect-file"></a><h3>gtk_file_chooser_unselect_file ()</h3>
2835
2770
  <pre class="programlisting"><span class="returnvalue">void</span> gtk_file_chooser_unselect_file (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2836
2771
  <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>);</pre>
@@ -2856,16 +2791,16 @@ directory, does not exist, or is otherwise not currently selected, does nothing.
2856
2791
  <p class="since">Since 2.14</p>
2857
2792
  </div>
2858
2793
  </div>
2859
- <div class="refsect1" title="Property Details">
2794
+ <div class="refsect1">
2860
2795
  <a name="GtkFileChooser.property-details"></a><h2>Property Details</h2>
2861
- <div class="refsect2" title='The "action" property'>
2796
+ <div class="refsect2">
2862
2797
  <a name="GtkFileChooser--action"></a><h3>The <code class="literal">"action"</code> property</h3>
2863
2798
  <pre class="programlisting"> "action" <a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> : Read / Write</pre>
2864
2799
  <p>The type of operation that the file selector is performing.</p>
2865
2800
  <p>Default value: GTK_FILE_CHOOSER_ACTION_OPEN</p>
2866
2801
  </div>
2867
2802
  <hr>
2868
- <div class="refsect2" title='The "create-folders" property'>
2803
+ <div class="refsect2">
2869
2804
  <a name="GtkFileChooser--create-folders"></a><h3>The <code class="literal">"create-folders"</code> property</h3>
2870
2805
  <pre class="programlisting"> "create-folders" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
2871
2806
  <p>
@@ -2876,7 +2811,7 @@ will offer the user to create new folders.
2876
2811
  <p class="since">Since 2.18</p>
2877
2812
  </div>
2878
2813
  <hr>
2879
- <div class="refsect2" title='The "do-overwrite-confirmation" property'>
2814
+ <div class="refsect2">
2880
2815
  <a name="GtkFileChooser--do-overwrite-confirmation"></a><h3>The <code class="literal">"do-overwrite-confirmation"</code> property</h3>
2881
2816
  <pre class="programlisting"> "do-overwrite-confirmation" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
2882
2817
  <p>
@@ -2888,72 +2823,72 @@ selects a file name that already exists.
2888
2823
  <p class="since">Since 2.8</p>
2889
2824
  </div>
2890
2825
  <hr>
2891
- <div class="refsect2" title='The "extra-widget" property'>
2826
+ <div class="refsect2">
2892
2827
  <a name="GtkFileChooser--extra-widget"></a><h3>The <code class="literal">"extra-widget"</code> property</h3>
2893
2828
  <pre class="programlisting"> "extra-widget" <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>* : Read / Write</pre>
2894
2829
  <p>Application supplied widget for extra options.</p>
2895
2830
  </div>
2896
2831
  <hr>
2897
- <div class="refsect2" title='The "file-system-backend" property'>
2832
+ <div class="refsect2">
2898
2833
  <a name="GtkFileChooser--file-system-backend"></a><h3>The <code class="literal">"file-system-backend"</code> property</h3>
2899
2834
  <pre class="programlisting"> "file-system-backend" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Write / Construct Only</pre>
2900
2835
  <p>Name of file system backend to use.</p>
2901
2836
  <p>Default value: NULL</p>
2902
2837
  </div>
2903
2838
  <hr>
2904
- <div class="refsect2" title='The "filter" property'>
2839
+ <div class="refsect2">
2905
2840
  <a name="GtkFileChooser--filter"></a><h3>The <code class="literal">"filter"</code> property</h3>
2906
2841
  <pre class="programlisting"> "filter" <a class="link" href="gtk-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a>* : Read / Write</pre>
2907
2842
  <p>The current filter for selecting which files are displayed.</p>
2908
2843
  </div>
2909
2844
  <hr>
2910
- <div class="refsect2" title='The "local-only" property'>
2845
+ <div class="refsect2">
2911
2846
  <a name="GtkFileChooser--local-only"></a><h3>The <code class="literal">"local-only"</code> property</h3>
2912
2847
  <pre class="programlisting"> "local-only" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
2913
2848
  <p>Whether the selected file(s) should be limited to local file: URLs.</p>
2914
2849
  <p>Default value: TRUE</p>
2915
2850
  </div>
2916
2851
  <hr>
2917
- <div class="refsect2" title='The "preview-widget" property'>
2852
+ <div class="refsect2">
2918
2853
  <a name="GtkFileChooser--preview-widget"></a><h3>The <code class="literal">"preview-widget"</code> property</h3>
2919
2854
  <pre class="programlisting"> "preview-widget" <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>* : Read / Write</pre>
2920
2855
  <p>Application supplied widget for custom previews.</p>
2921
2856
  </div>
2922
2857
  <hr>
2923
- <div class="refsect2" title='The "preview-widget-active" property'>
2858
+ <div class="refsect2">
2924
2859
  <a name="GtkFileChooser--preview-widget-active"></a><h3>The <code class="literal">"preview-widget-active"</code> property</h3>
2925
2860
  <pre class="programlisting"> "preview-widget-active" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
2926
2861
  <p>Whether the application supplied widget for custom previews should be shown.</p>
2927
2862
  <p>Default value: TRUE</p>
2928
2863
  </div>
2929
2864
  <hr>
2930
- <div class="refsect2" title='The "select-multiple" property'>
2865
+ <div class="refsect2">
2931
2866
  <a name="GtkFileChooser--select-multiple"></a><h3>The <code class="literal">"select-multiple"</code> property</h3>
2932
2867
  <pre class="programlisting"> "select-multiple" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
2933
2868
  <p>Whether to allow multiple files to be selected.</p>
2934
2869
  <p>Default value: FALSE</p>
2935
2870
  </div>
2936
2871
  <hr>
2937
- <div class="refsect2" title='The "show-hidden" property'>
2872
+ <div class="refsect2">
2938
2873
  <a name="GtkFileChooser--show-hidden"></a><h3>The <code class="literal">"show-hidden"</code> property</h3>
2939
2874
  <pre class="programlisting"> "show-hidden" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
2940
2875
  <p>Whether the hidden files and folders should be displayed.</p>
2941
2876
  <p>Default value: FALSE</p>
2942
2877
  </div>
2943
2878
  <hr>
2944
- <div class="refsect2" title='The "use-preview-label" property'>
2879
+ <div class="refsect2">
2945
2880
  <a name="GtkFileChooser--use-preview-label"></a><h3>The <code class="literal">"use-preview-label"</code> property</h3>
2946
2881
  <pre class="programlisting"> "use-preview-label" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> : Read / Write</pre>
2947
2882
  <p>Whether to display a stock label with the name of the previewed file.</p>
2948
2883
  <p>Default value: TRUE</p>
2949
2884
  </div>
2950
2885
  </div>
2951
- <div class="refsect1" title="Signal Details">
2886
+ <div class="refsect1">
2952
2887
  <a name="GtkFileChooser.signal-details"></a><h2>Signal Details</h2>
2953
- <div class="refsect2" title='The "confirm-overwrite" signal'>
2888
+ <div class="refsect2">
2954
2889
  <a name="GtkFileChooser-confirm-overwrite"></a><h3>The <code class="literal">"confirm-overwrite"</code> signal</h3>
2955
2890
  <pre class="programlisting"><a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="returnvalue">GtkFileChooserConfirmation</span></a>user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
2956
- <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>
2891
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
2957
2892
  <p>
2958
2893
  This signal gets emitted whenever it is appropriate to present a
2959
2894
  confirmation dialog when the user has selected a file name that
@@ -2983,7 +2918,7 @@ dialog should be used, it should return
2983
2918
  illustrates this.
2984
2919
  </p>
2985
2920
  <div class="example">
2986
- <a name="gtkfilechooser-confirmation"></a><p class="title"><b>Example 40. Custom confirmation</b></p>
2921
+ <a name="gtkfilechooser-confirmation"></a><p class="title"><b>Example 43. Custom confirmation</b></p>
2987
2922
  <div class="example-contents">
2988
2923
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2989
2924
  <tbody>
@@ -3057,8 +2992,7 @@ illustrates this.
3057
2992
  <tbody>
3058
2993
  <tr>
3059
2994
  <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
3060
- <td>the object which received the signal.
3061
- </td>
2995
+ <td>the object which received the signal.</td>
3062
2996
  </tr>
3063
2997
  <tr>
3064
2998
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
@@ -3066,20 +3000,18 @@ illustrates this.
3066
3000
  </tr>
3067
3001
  <tr>
3068
3002
  <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
3069
- <td> a <a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value that indicates which
3070
- action to take after emitting the signal.
3071
-
3072
- </td>
3003
+ <td>a <a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value that indicates which
3004
+ action to take after emitting the signal.</td>
3073
3005
  </tr>
3074
3006
  </tbody>
3075
3007
  </table></div>
3076
3008
  <p class="since">Since 2.8</p>
3077
3009
  </div>
3078
3010
  <hr>
3079
- <div class="refsect2" title='The "current-folder-changed" signal'>
3011
+ <div class="refsect2">
3080
3012
  <a name="GtkFileChooser-current-folder-changed"></a><h3>The <code class="literal">"current-folder-changed"</code> signal</h3>
3081
3013
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3082
- <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>
3014
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
3083
3015
  <p>
3084
3016
  This signal is emitted when the current folder in a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>
3085
3017
  changes. This can happen due to the user performing some action that
@@ -3092,8 +3024,8 @@ Normally you do not need to connect to this signal, unless you need to keep
3092
3024
  track of which folder a file chooser is showing.
3093
3025
  </p>
3094
3026
  <p>
3095
- See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder ()"><code class="function">gtk_file_chooser_set_current_folder()</code></a>,
3096
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder" title="gtk_file_chooser_get_current_folder ()"><code class="function">gtk_file_chooser_get_current_folder()</code></a>,
3027
+ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder"><code class="function">gtk_file_chooser_set_current_folder()</code></a>,
3028
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder" title="gtk_file_chooser_get_current_folder"><code class="function">gtk_file_chooser_get_current_folder()</code></a>,
3097
3029
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()"><code class="function">gtk_file_chooser_set_current_folder_uri()</code></a>,
3098
3030
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-uri" title="gtk_file_chooser_get_current_folder_uri ()"><code class="function">gtk_file_chooser_get_current_folder_uri()</code></a>.
3099
3031
  </p>
@@ -3102,8 +3034,7 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-curren
3102
3034
  <tbody>
3103
3035
  <tr>
3104
3036
  <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
3105
- <td>the object which received the signal.
3106
- </td>
3037
+ <td>the object which received the signal.</td>
3107
3038
  </tr>
3108
3039
  <tr>
3109
3040
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
@@ -3113,10 +3044,10 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-curren
3113
3044
  </table></div>
3114
3045
  </div>
3115
3046
  <hr>
3116
- <div class="refsect2" title='The "file-activated" signal'>
3047
+ <div class="refsect2">
3117
3048
  <a name="GtkFileChooser-file-activated"></a><h3>The <code class="literal">"file-activated"</code> signal</h3>
3118
3049
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3119
- <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>
3050
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
3120
3051
  <p>
3121
3052
  This signal is emitted when the user "activates" a file in the file
3122
3053
  chooser. This can happen by double-clicking on a file in the file list, or
@@ -3128,8 +3059,8 @@ by <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"
3128
3059
  dialog.
3129
3060
  </p>
3130
3061
  <p>
3131
- See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename ()"><code class="function">gtk_file_chooser_get_filename()</code></a>,
3132
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenames" title="gtk_file_chooser_get_filenames ()"><code class="function">gtk_file_chooser_get_filenames()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a>,
3062
+ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename"><code class="function">gtk_file_chooser_get_filename()</code></a>,
3063
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenames" title="gtk_file_chooser_get_filenames"><code class="function">gtk_file_chooser_get_filenames()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a>,
3133
3064
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()"><code class="function">gtk_file_chooser_get_uris()</code></a>.
3134
3065
  </p>
3135
3066
  <div class="variablelist"><table border="0">
@@ -3137,8 +3068,7 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenam
3137
3068
  <tbody>
3138
3069
  <tr>
3139
3070
  <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
3140
- <td>the object which received the signal.
3141
- </td>
3071
+ <td>the object which received the signal.</td>
3142
3072
  </tr>
3143
3073
  <tr>
3144
3074
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
@@ -3148,10 +3078,10 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenam
3148
3078
  </table></div>
3149
3079
  </div>
3150
3080
  <hr>
3151
- <div class="refsect2" title='The "selection-changed" signal'>
3081
+ <div class="refsect2">
3152
3082
  <a name="GtkFileChooser-selection-changed"></a><h3>The <code class="literal">"selection-changed"</code> signal</h3>
3153
3083
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3154
- <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>
3084
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
3155
3085
  <p>
3156
3086
  This signal is emitted when there is a change in the set of selected files
3157
3087
  in a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>. This can happen when the user modifies the selection
@@ -3164,9 +3094,9 @@ for the file chooser to finish running, and then to get the list of
3164
3094
  selected files using the functions mentioned below.
3165
3095
  </p>
3166
3096
  <p>
3167
- See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename ()"><code class="function">gtk_file_chooser_select_filename()</code></a>,
3168
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-filename" title="gtk_file_chooser_unselect_filename ()"><code class="function">gtk_file_chooser_unselect_filename()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename ()"><code class="function">gtk_file_chooser_get_filename()</code></a>,
3169
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenames" title="gtk_file_chooser_get_filenames ()"><code class="function">gtk_file_chooser_get_filenames()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-uri" title="gtk_file_chooser_select_uri ()"><code class="function">gtk_file_chooser_select_uri()</code></a>,
3097
+ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename"><code class="function">gtk_file_chooser_select_filename()</code></a>,
3098
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-filename" title="gtk_file_chooser_unselect_filename"><code class="function">gtk_file_chooser_unselect_filename()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename"><code class="function">gtk_file_chooser_get_filename()</code></a>,
3099
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenames" title="gtk_file_chooser_get_filenames"><code class="function">gtk_file_chooser_get_filenames()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-uri" title="gtk_file_chooser_select_uri ()"><code class="function">gtk_file_chooser_select_uri()</code></a>,
3170
3100
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-uri" title="gtk_file_chooser_unselect_uri ()"><code class="function">gtk_file_chooser_unselect_uri()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a>,
3171
3101
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()"><code class="function">gtk_file_chooser_get_uris()</code></a>.
3172
3102
  </p>
@@ -3175,8 +3105,7 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-file
3175
3105
  <tbody>
3176
3106
  <tr>
3177
3107
  <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
3178
- <td>the object which received the signal.
3179
- </td>
3108
+ <td>the object which received the signal.</td>
3180
3109
  </tr>
3181
3110
  <tr>
3182
3111
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
@@ -3186,10 +3115,10 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-file
3186
3115
  </table></div>
3187
3116
  </div>
3188
3117
  <hr>
3189
- <div class="refsect2" title='The "update-preview" signal'>
3118
+ <div class="refsect2">
3190
3119
  <a name="GtkFileChooser-update-preview"></a><h3>The <code class="literal">"update-preview"</code> signal</h3>
3191
3120
  <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3192
- <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>
3121
+ <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
3193
3122
  <p>
3194
3123
  This signal is emitted when the preview in a file chooser should be
3195
3124
  regenerated. For example, this can happen when the currently selected file
@@ -3200,7 +3129,7 @@ a preview widget.
3200
3129
  Once you have installed a preview widget with
3201
3130
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>, you should update it when this
3202
3131
  signal is emitted. You can use the functions
3203
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename ()"><code class="function">gtk_file_chooser_get_preview_filename()</code></a> or
3132
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename"><code class="function">gtk_file_chooser_get_preview_filename()</code></a> or
3204
3133
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()"><code class="function">gtk_file_chooser_get_preview_uri()</code></a> to get the name of the file to preview.
3205
3134
  Your widget may not be able to preview all kinds of files; your callback
3206
3135
  must call <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()"><code class="function">gtk_file_chooser_set_preview_widget_active()</code></a> to inform the file
@@ -3213,7 +3142,7 @@ Please see the example code in <a class="xref" href="GtkFileChooser.html#gtkfile
3213
3142
  See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>,
3214
3143
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()"><code class="function">gtk_file_chooser_set_preview_widget_active()</code></a>,
3215
3144
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-use-preview-label" title="gtk_file_chooser_set_use_preview_label ()"><code class="function">gtk_file_chooser_set_use_preview_label()</code></a>,
3216
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename ()"><code class="function">gtk_file_chooser_get_preview_filename()</code></a>,
3145
+ <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename"><code class="function">gtk_file_chooser_get_preview_filename()</code></a>,
3217
3146
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()"><code class="function">gtk_file_chooser_get_preview_uri()</code></a>.
3218
3147
  </p>
3219
3148
  <div class="variablelist"><table border="0">
@@ -3221,8 +3150,7 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview
3221
3150
  <tbody>
3222
3151
  <tr>
3223
3152
  <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
3224
- <td>the object which received the signal.
3225
- </td>
3153
+ <td>the object which received the signal.</td>
3226
3154
  </tr>
3227
3155
  <tr>
3228
3156
  <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
@@ -3232,13 +3160,13 @@ See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview
3232
3160
  </table></div>
3233
3161
  </div>
3234
3162
  </div>
3235
- <div class="refsect1" title="See Also">
3163
+ <div class="refsect1">
3236
3164
  <a name="GtkFileChooser.see-also"></a><h2>See Also</h2>
3237
3165
  <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a>, <a class="link" href="GtkFileChooserWidget.html" title="GtkFileChooserWidget"><span class="type">GtkFileChooserWidget</span></a>, <a class="link" href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a>
3238
3166
  </div>
3239
3167
  </div>
3240
3168
  <div class="footer">
3241
3169
  <hr>
3242
- Generated by GTK-Doc V1.15</div>
3170
+ Generated by GTK-Doc V1.16.1</div>
3243
3171
  </body>
3244
3172
  </html>