gtk2 3.0.7-x64-mingw32 → 3.0.8-x64-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (581) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +2 -2
  3. data/ext/gtk2/extconf.rb +1 -0
  4. data/lib/2.2/gtk2.so +0 -0
  5. data/lib/2.3/gtk2.so +0 -0
  6. data/sample/misc/threads.rb +0 -1
  7. data/vendor/local/bin/gtk-demo.exe +0 -0
  8. data/vendor/local/bin/gtk-query-immodules-2.0.exe +0 -0
  9. data/vendor/local/bin/gtk-update-icon-cache.exe +0 -0
  10. data/vendor/local/bin/libgailutil-18.dll +0 -0
  11. data/vendor/local/bin/libgdk-win32-2.0-0.dll +0 -0
  12. data/vendor/local/bin/libgtk-win32-2.0-0.dll +0 -0
  13. data/vendor/local/include/gtk-2.0/gtk/gtkcontainer.h +2 -1
  14. data/vendor/local/include/gtk-2.0/gtk/gtkversion.h +3 -3
  15. data/vendor/local/lib/gtk-2.0/2.10.0/engines/libpixmap.dll +0 -0
  16. data/vendor/local/lib/gtk-2.0/2.10.0/engines/libpixmap.dll.a +0 -0
  17. data/vendor/local/lib/gtk-2.0/2.10.0/engines/libpixmap.la +2 -2
  18. data/vendor/local/lib/gtk-2.0/2.10.0/engines/libwimp.dll +0 -0
  19. data/vendor/local/lib/gtk-2.0/2.10.0/engines/libwimp.dll.a +0 -0
  20. data/vendor/local/lib/gtk-2.0/2.10.0/engines/libwimp.la +2 -2
  21. data/vendor/local/lib/gtk-2.0/2.10.0/immodules.cache +1 -1
  22. data/vendor/local/lib/gtk-2.0/modules/libgail.dll +0 -0
  23. data/vendor/local/lib/gtk-2.0/modules/libgail.dll.a +0 -0
  24. data/vendor/local/lib/gtk-2.0/modules/libgail.la +2 -2
  25. data/vendor/local/lib/libgailutil.dll.a +0 -0
  26. data/vendor/local/lib/libgailutil.la +2 -2
  27. data/vendor/local/lib/libgdk-win32-2.0.dll.a +0 -0
  28. data/vendor/local/lib/libgdk-win32-2.0.la +3 -3
  29. data/vendor/local/lib/libgtk-win32-2.0.dll.a +0 -0
  30. data/vendor/local/lib/libgtk-win32-2.0.la +3 -3
  31. data/vendor/local/lib/pkgconfig/gail.pc +1 -1
  32. data/vendor/local/lib/pkgconfig/gdk-2.0.pc +1 -1
  33. data/vendor/local/lib/pkgconfig/gdk-win32-2.0.pc +1 -1
  34. data/vendor/local/lib/pkgconfig/gtk+-2.0.pc +1 -1
  35. data/vendor/local/lib/pkgconfig/gtk+-win32-2.0.pc +1 -1
  36. data/vendor/local/share/aclocal/gtk-2.0.m4 +2 -13
  37. data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util-GailMisc.html +38 -45
  38. data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util-GailTextUtil.html +14 -20
  39. data/vendor/local/share/gtk-doc/html/gail-libgail-util/gail-libgail-util.devhelp2 +1 -2
  40. data/vendor/local/share/gtk-doc/html/gail-libgail-util/index.html +3 -4
  41. data/vendor/local/share/gtk-doc/html/gail-libgail-util/libgail-util-main.html +3 -4
  42. data/vendor/local/share/gtk-doc/html/gail-libgail-util/style.css +9 -6
  43. data/vendor/local/share/gtk-doc/html/gdk2/GdkDisplay.html +105 -127
  44. data/vendor/local/share/gtk-doc/html/gdk2/GdkDisplayManager.html +19 -21
  45. data/vendor/local/share/gtk-doc/html/gdk2/GdkScreen.html +123 -146
  46. data/vendor/local/share/gtk-doc/html/gdk2/annotation-glossary.html +2 -3
  47. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-10.html +2 -3
  48. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-12.html +2 -3
  49. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-14.html +2 -3
  50. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-16.html +2 -3
  51. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-18.html +2 -3
  52. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-2.html +2 -3
  53. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-20.html +2 -3
  54. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-22.html +2 -3
  55. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-4.html +2 -3
  56. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-6.html +2 -3
  57. data/vendor/local/share/gtk-doc/html/gdk2/api-index-2-8.html +2 -3
  58. data/vendor/local/share/gtk-doc/html/gdk2/api-index-deprecated.html +2 -3
  59. data/vendor/local/share/gtk-doc/html/gdk2/api-index-full.html +2 -3
  60. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Application-launching.html +20 -22
  61. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Bitmaps-and-Pixmaps.html +25 -31
  62. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Cairo-Interaction.html +24 -27
  63. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Colormaps-and-Colors.html +54 -76
  64. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Cursors.html +34 -43
  65. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Drag-and-Drop.html +46 -61
  66. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Drawing-Primitives.html +91 -103
  67. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Event-Structures.html +34 -34
  68. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Events.html +62 -79
  69. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Fonts.html +62 -86
  70. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-GdkRGB.html +33 -39
  71. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-General.html +40 -55
  72. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Graphics-Contexts.html +46 -52
  73. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Images.html +50 -71
  74. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Input-Devices.html +43 -57
  75. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Input.html +13 -16
  76. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Keyboard-Handling.html +56 -74
  77. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Pango-Interaction.html +106 -116
  78. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Pixbufs.html +25 -28
  79. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Points-Rectangles-and-Regions.html +40 -51
  80. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Properties-and-Atoms.html +43 -57
  81. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Selections.html +19 -25
  82. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Testing.html +10 -13
  83. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Threads.html +22 -29
  84. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Visuals.html +51 -64
  85. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-Windows.html +295 -335
  86. data/vendor/local/share/gtk-doc/html/gdk2/gdk2-X-Window-System-Interaction.html +190 -264
  87. data/vendor/local/share/gtk-doc/html/gdk2/gdk2.devhelp2 +236 -5
  88. data/vendor/local/share/gtk-doc/html/gdk2/index.html +2 -3
  89. data/vendor/local/share/gtk-doc/html/gdk2/multihead.html +2 -3
  90. data/vendor/local/share/gtk-doc/html/gdk2/reference.html +2 -3
  91. data/vendor/local/share/gtk-doc/html/gdk2/style.css +9 -6
  92. data/vendor/local/share/gtk-doc/html/gtk2/AbstractObjects.html +4 -5
  93. data/vendor/local/share/gtk-doc/html/gtk2/Actions.html +4 -5
  94. data/vendor/local/share/gtk-doc/html/gtk2/Builder.html +3 -4
  95. data/vendor/local/share/gtk-doc/html/gtk2/ButtonWidgets.html +3 -4
  96. data/vendor/local/share/gtk-doc/html/gtk2/DeprecatedObjects.html +2 -3
  97. data/vendor/local/share/gtk-doc/html/gtk2/DisplayWidgets.html +6 -7
  98. data/vendor/local/share/gtk-doc/html/gtk2/GtkAboutDialog.html +123 -134
  99. data/vendor/local/share/gtk-doc/html/gtk2/GtkAccelLabel.html +4 -216
  100. data/vendor/local/share/gtk-doc/html/gtk2/GtkAccessible.html +6 -72
  101. data/vendor/local/share/gtk-doc/html/gtk2/GtkAction.html +65 -1250
  102. data/vendor/local/share/gtk-doc/html/gtk2/GtkActionGroup.html +62 -68
  103. data/vendor/local/share/gtk-doc/html/gtk2/GtkActivatable.html +16 -678
  104. data/vendor/local/share/gtk-doc/html/gtk2/GtkAdjustment.html +46 -54
  105. data/vendor/local/share/gtk-doc/html/gtk2/GtkAlignment.html +10 -199
  106. data/vendor/local/share/gtk-doc/html/gtk2/GtkArrow.html +4 -78
  107. data/vendor/local/share/gtk-doc/html/gtk2/GtkAspectFrame.html +4 -107
  108. data/vendor/local/share/gtk-doc/html/gtk2/GtkAssistant.html +59 -903
  109. data/vendor/local/share/gtk-doc/html/gtk2/GtkBin.html +4 -35
  110. data/vendor/local/share/gtk-doc/html/gtk2/GtkBox.html +19 -24
  111. data/vendor/local/share/gtk-doc/html/gtk2/GtkBuildable.html +23 -498
  112. data/vendor/local/share/gtk-doc/html/gtk2/GtkBuilder.html +69 -79
  113. data/vendor/local/share/gtk-doc/html/gtk2/GtkButton.html +62 -73
  114. data/vendor/local/share/gtk-doc/html/gtk2/GtkButtonBox.html +17 -21
  115. data/vendor/local/share/gtk-doc/html/gtk2/GtkCList.html +160 -185
  116. data/vendor/local/share/gtk-doc/html/gtk2/GtkCTree.html +95 -158
  117. data/vendor/local/share/gtk-doc/html/gtk2/GtkCalendar.html +51 -60
  118. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellEditable.html +12 -13
  119. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellLayout.html +25 -26
  120. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRenderer.html +58 -62
  121. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererAccel.html +17 -19
  122. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererCombo.html +10 -12
  123. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererPixbuf.html +16 -18
  124. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererProgress.html +11 -13
  125. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererSpin.html +8 -10
  126. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererSpinner.html +9 -37
  127. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererText.html +34 -36
  128. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellRendererToggle.html +16 -21
  129. data/vendor/local/share/gtk-doc/html/gtk2/GtkCellView.html +36 -44
  130. data/vendor/local/share/gtk-doc/html/gtk2/GtkCheckButton.html +8 -12
  131. data/vendor/local/share/gtk-doc/html/gtk2/GtkColorButton.html +42 -48
  132. data/vendor/local/share/gtk-doc/html/gtk2/GtkColorSelection.html +53 -64
  133. data/vendor/local/share/gtk-doc/html/gtk2/GtkColorSelectionDialog.html +8 -10
  134. data/vendor/local/share/gtk-doc/html/gtk2/GtkCombo.html +15 -17
  135. data/vendor/local/share/gtk-doc/html/gtk2/GtkComboBox.html +116 -134
  136. data/vendor/local/share/gtk-doc/html/gtk2/GtkComboBoxEntry.html +15 -20
  137. data/vendor/local/share/gtk-doc/html/gtk2/GtkComboBoxText.html +11 -216
  138. data/vendor/local/share/gtk-doc/html/gtk2/GtkContainer.html +54 -60
  139. data/vendor/local/share/gtk-doc/html/gtk2/GtkCurve.html +11 -13
  140. data/vendor/local/share/gtk-doc/html/gtk2/GtkDialog.html +48 -55
  141. data/vendor/local/share/gtk-doc/html/gtk2/GtkDrawingArea.html +10 -12
  142. data/vendor/local/share/gtk-doc/html/gtk2/GtkEditable.html +24 -29
  143. data/vendor/local/share/gtk-doc/html/gtk2/GtkEntry.html +247 -275
  144. data/vendor/local/share/gtk-doc/html/gtk2/GtkEntryBuffer.html +39 -47
  145. data/vendor/local/share/gtk-doc/html/gtk2/GtkEntryCompletion.html +82 -96
  146. data/vendor/local/share/gtk-doc/html/gtk2/GtkEventBox.html +16 -20
  147. data/vendor/local/share/gtk-doc/html/gtk2/GtkExpander.html +46 -55
  148. data/vendor/local/share/gtk-doc/html/gtk2/GtkFileChooser.html +116 -2831
  149. data/vendor/local/share/gtk-doc/html/gtk2/GtkFileChooserButton.html +34 -41
  150. data/vendor/local/share/gtk-doc/html/gtk2/GtkFileChooserDialog.html +10 -13
  151. data/vendor/local/share/gtk-doc/html/gtk2/GtkFileChooserWidget.html +9 -12
  152. data/vendor/local/share/gtk-doc/html/gtk2/GtkFileSelection.html +16 -21
  153. data/vendor/local/share/gtk-doc/html/gtk2/GtkFixed.html +12 -15
  154. data/vendor/local/share/gtk-doc/html/gtk2/GtkFontButton.html +49 -59
  155. data/vendor/local/share/gtk-doc/html/gtk2/GtkFontSelection.html +51 -58
  156. data/vendor/local/share/gtk-doc/html/gtk2/GtkFontSelectionDialog.html +30 -37
  157. data/vendor/local/share/gtk-doc/html/gtk2/GtkFrame.html +17 -21
  158. data/vendor/local/share/gtk-doc/html/gtk2/GtkGammaCurve.html +4 -6
  159. data/vendor/local/share/gtk-doc/html/gtk2/GtkHBox.html +4 -43
  160. data/vendor/local/share/gtk-doc/html/gtk2/GtkHButtonBox.html +8 -12
  161. data/vendor/local/share/gtk-doc/html/gtk2/GtkHPaned.html +4 -6
  162. data/vendor/local/share/gtk-doc/html/gtk2/GtkHRuler.html +4 -6
  163. data/vendor/local/share/gtk-doc/html/gtk2/GtkHSV.html +22 -25
  164. data/vendor/local/share/gtk-doc/html/gtk2/GtkHScale.html +7 -10
  165. data/vendor/local/share/gtk-doc/html/gtk2/GtkHScrollbar.html +5 -7
  166. data/vendor/local/share/gtk-doc/html/gtk2/GtkHSeparator.html +4 -6
  167. data/vendor/local/share/gtk-doc/html/gtk2/GtkHandleBox.html +18 -24
  168. data/vendor/local/share/gtk-doc/html/gtk2/GtkIMContext.html +33 -39
  169. data/vendor/local/share/gtk-doc/html/gtk2/GtkIMContextSimple.html +5 -7
  170. data/vendor/local/share/gtk-doc/html/gtk2/GtkIMMulticontext.html +10 -13
  171. data/vendor/local/share/gtk-doc/html/gtk2/GtkIconTheme.html +107 -122
  172. data/vendor/local/share/gtk-doc/html/gtk2/GtkIconView.html +188 -215
  173. data/vendor/local/share/gtk-doc/html/gtk2/GtkImage.html +77 -1174
  174. data/vendor/local/share/gtk-doc/html/gtk2/GtkImageMenuItem.html +28 -35
  175. data/vendor/local/share/gtk-doc/html/gtk2/GtkInfoBar.html +27 -499
  176. data/vendor/local/share/gtk-doc/html/gtk2/GtkInputDialog.html +11 -13
  177. data/vendor/local/share/gtk-doc/html/gtk2/GtkInvisible.html +23 -26
  178. data/vendor/local/share/gtk-doc/html/gtk2/GtkItem.html +9 -10
  179. data/vendor/local/share/gtk-doc/html/gtk2/GtkItemFactory.html +39 -45
  180. data/vendor/local/share/gtk-doc/html/gtk2/GtkLabel.html +137 -159
  181. data/vendor/local/share/gtk-doc/html/gtk2/GtkLayout.html +24 -26
  182. data/vendor/local/share/gtk-doc/html/gtk2/GtkLinkButton.html +25 -30
  183. data/vendor/local/share/gtk-doc/html/gtk2/GtkList.html +32 -36
  184. data/vendor/local/share/gtk-doc/html/gtk2/GtkListItem.html +18 -21
  185. data/vendor/local/share/gtk-doc/html/gtk2/GtkListStore.html +42 -46
  186. data/vendor/local/share/gtk-doc/html/gtk2/GtkMenu.html +67 -74
  187. data/vendor/local/share/gtk-doc/html/gtk2/GtkMenuBar.html +20 -24
  188. data/vendor/local/share/gtk-doc/html/gtk2/GtkMenuItem.html +46 -54
  189. data/vendor/local/share/gtk-doc/html/gtk2/GtkMenuShell.html +33 -36
  190. data/vendor/local/share/gtk-doc/html/gtk2/GtkMenuToolButton.html +22 -25
  191. data/vendor/local/share/gtk-doc/html/gtk2/GtkMessageDialog.html +49 -486
  192. data/vendor/local/share/gtk-doc/html/gtk2/GtkMisc.html +7 -8
  193. data/vendor/local/share/gtk-doc/html/gtk2/GtkNotebook.html +127 -166
  194. data/vendor/local/share/gtk-doc/html/gtk2/GtkObject.html +43 -49
  195. data/vendor/local/share/gtk-doc/html/gtk2/GtkOffscreenWindow.html +11 -88
  196. data/vendor/local/share/gtk-doc/html/gtk2/GtkOldEditable.html +18 -21
  197. data/vendor/local/share/gtk-doc/html/gtk2/GtkOptionMenu.html +12 -16
  198. data/vendor/local/share/gtk-doc/html/gtk2/GtkPageSetup.html +70 -87
  199. data/vendor/local/share/gtk-doc/html/gtk2/GtkPageSetupUnixDialog.html +16 -18
  200. data/vendor/local/share/gtk-doc/html/gtk2/GtkPaned.html +40 -42
  201. data/vendor/local/share/gtk-doc/html/gtk2/GtkPaperSize.html +62 -80
  202. data/vendor/local/share/gtk-doc/html/gtk2/GtkPixmap.html +22 -24
  203. data/vendor/local/share/gtk-doc/html/gtk2/GtkPlug.html +23 -245
  204. data/vendor/local/share/gtk-doc/html/gtk2/GtkPreview.html +29 -34
  205. data/vendor/local/share/gtk-doc/html/gtk2/GtkPrintContext.html +51 -57
  206. data/vendor/local/share/gtk-doc/html/gtk2/GtkPrintJob.html +34 -40
  207. data/vendor/local/share/gtk-doc/html/gtk2/GtkPrintSettings.html +197 -237
  208. data/vendor/local/share/gtk-doc/html/gtk2/GtkPrintUnixDialog.html +51 -60
  209. data/vendor/local/share/gtk-doc/html/gtk2/GtkPrinter.html +76 -97
  210. data/vendor/local/share/gtk-doc/html/gtk2/GtkProgress.html +21 -27
  211. data/vendor/local/share/gtk-doc/html/gtk2/GtkProgressBar.html +44 -51
  212. data/vendor/local/share/gtk-doc/html/gtk2/GtkRadioAction.html +21 -24
  213. data/vendor/local/share/gtk-doc/html/gtk2/GtkRadioButton.html +23 -25
  214. data/vendor/local/share/gtk-doc/html/gtk2/GtkRadioMenuItem.html +24 -27
  215. data/vendor/local/share/gtk-doc/html/gtk2/GtkRadioToolButton.html +22 -25
  216. data/vendor/local/share/gtk-doc/html/gtk2/GtkRange.html +81 -94
  217. data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentAction.html +14 -18
  218. data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentChooser.html +102 -120
  219. data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentChooserDialog.html +10 -13
  220. data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentChooserMenu.html +14 -18
  221. data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentChooserWidget.html +8 -11
  222. data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentFilter.html +34 -40
  223. data/vendor/local/share/gtk-doc/html/gtk2/GtkRecentManager.html +124 -154
  224. data/vendor/local/share/gtk-doc/html/gtk2/GtkRuler.html +9 -11
  225. data/vendor/local/share/gtk-doc/html/gtk2/GtkScale.html +30 -35
  226. data/vendor/local/share/gtk-doc/html/gtk2/GtkScaleButton.html +41 -45
  227. data/vendor/local/share/gtk-doc/html/gtk2/GtkScrollbar.html +4 -4
  228. data/vendor/local/share/gtk-doc/html/gtk2/GtkScrolledWindow.html +34 -38
  229. data/vendor/local/share/gtk-doc/html/gtk2/GtkSeparator.html +4 -4
  230. data/vendor/local/share/gtk-doc/html/gtk2/GtkSeparatorMenuItem.html +4 -6
  231. data/vendor/local/share/gtk-doc/html/gtk2/GtkSeparatorToolItem.html +11 -14
  232. data/vendor/local/share/gtk-doc/html/gtk2/GtkSettings.html +49 -55
  233. data/vendor/local/share/gtk-doc/html/gtk2/GtkSizeGroup.html +21 -25
  234. data/vendor/local/share/gtk-doc/html/gtk2/GtkSocket.html +11 -259
  235. data/vendor/local/share/gtk-doc/html/gtk2/GtkSpinButton.html +51 -67
  236. data/vendor/local/share/gtk-doc/html/gtk2/GtkSpinner.html +11 -63
  237. data/vendor/local/share/gtk-doc/html/gtk2/GtkStatusIcon.html +162 -187
  238. data/vendor/local/share/gtk-doc/html/gtk2/GtkStatusbar.html +21 -26
  239. data/vendor/local/share/gtk-doc/html/gtk2/GtkStyle.html +227 -239
  240. data/vendor/local/share/gtk-doc/html/gtk2/GtkTable.html +25 -32
  241. data/vendor/local/share/gtk-doc/html/gtk2/GtkTearoffMenuItem.html +4 -6
  242. data/vendor/local/share/gtk-doc/html/gtk2/GtkText.html +28 -34
  243. data/vendor/local/share/gtk-doc/html/gtk2/GtkTextBuffer.html +184 -203
  244. data/vendor/local/share/gtk-doc/html/gtk2/GtkTextIter.html +195 -275
  245. data/vendor/local/share/gtk-doc/html/gtk2/GtkTextMark.html +17 -23
  246. data/vendor/local/share/gtk-doc/html/gtk2/GtkTextTag.html +57 -65
  247. data/vendor/local/share/gtk-doc/html/gtk2/GtkTextTagTable.html +15 -18
  248. data/vendor/local/share/gtk-doc/html/gtk2/GtkTextView.html +161 -192
  249. data/vendor/local/share/gtk-doc/html/gtk2/GtkTipsQuery.html +14 -17
  250. data/vendor/local/share/gtk-doc/html/gtk2/GtkToggleAction.html +20 -24
  251. data/vendor/local/share/gtk-doc/html/gtk2/GtkToggleButton.html +20 -27
  252. data/vendor/local/share/gtk-doc/html/gtk2/GtkToggleToolButton.html +15 -19
  253. data/vendor/local/share/gtk-doc/html/gtk2/GtkToolButton.html +42 -49
  254. data/vendor/local/share/gtk-doc/html/gtk2/GtkToolItem.html +85 -101
  255. data/vendor/local/share/gtk-doc/html/gtk2/GtkToolItemGroup.html +26 -482
  256. data/vendor/local/share/gtk-doc/html/gtk2/GtkToolPalette.html +43 -749
  257. data/vendor/local/share/gtk-doc/html/gtk2/GtkToolShell.html +15 -290
  258. data/vendor/local/share/gtk-doc/html/gtk2/GtkToolbar.html +74 -93
  259. data/vendor/local/share/gtk-doc/html/gtk2/GtkTooltip.html +30 -31
  260. data/vendor/local/share/gtk-doc/html/gtk2/GtkTooltips.html +15 -19
  261. data/vendor/local/share/gtk-doc/html/gtk2/GtkTree.html +25 -28
  262. data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeItem.html +5 -14
  263. data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeModel.html +120 -156
  264. data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeModelFilter.html +33 -38
  265. data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeModelSort.html +21 -26
  266. data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeSelection.html +42 -49
  267. data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeSortable.html +15 -19
  268. data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeStore.html +43 -49
  269. data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeView.html +231 -302
  270. data/vendor/local/share/gtk-doc/html/gtk2/GtkTreeViewColumn.html +87 -109
  271. data/vendor/local/share/gtk-doc/html/gtk2/GtkUIManager.html +62 -69
  272. data/vendor/local/share/gtk-doc/html/gtk2/GtkVBox.html +4 -43
  273. data/vendor/local/share/gtk-doc/html/gtk2/GtkVButtonBox.html +4 -78
  274. data/vendor/local/share/gtk-doc/html/gtk2/GtkVPaned.html +4 -17
  275. data/vendor/local/share/gtk-doc/html/gtk2/GtkVRuler.html +4 -28
  276. data/vendor/local/share/gtk-doc/html/gtk2/GtkVScale.html +4 -78
  277. data/vendor/local/share/gtk-doc/html/gtk2/GtkVScrollbar.html +4 -38
  278. data/vendor/local/share/gtk-doc/html/gtk2/GtkVSeparator.html +4 -20
  279. data/vendor/local/share/gtk-doc/html/gtk2/GtkViewport.html +10 -262
  280. data/vendor/local/share/gtk-doc/html/gtk2/GtkVolumeButton.html +5 -19
  281. data/vendor/local/share/gtk-doc/html/gtk2/GtkWidget.html +265 -8803
  282. data/vendor/local/share/gtk-doc/html/gtk2/GtkWindow.html +251 -291
  283. data/vendor/local/share/gtk-doc/html/gtk2/GtkWindowGroup.html +10 -16
  284. data/vendor/local/share/gtk-doc/html/gtk2/LayoutContainers.html +8 -9
  285. data/vendor/local/share/gtk-doc/html/gtk2/MenusAndCombos.html +6 -7
  286. data/vendor/local/share/gtk-doc/html/gtk2/MiscObjects.html +5 -6
  287. data/vendor/local/share/gtk-doc/html/gtk2/NumericEntry.html +3 -4
  288. data/vendor/local/share/gtk-doc/html/gtk2/Ornaments.html +3 -4
  289. data/vendor/local/share/gtk-doc/html/gtk2/PlugSocket.html +4 -5
  290. data/vendor/local/share/gtk-doc/html/gtk2/Printing.html +2 -3
  291. data/vendor/local/share/gtk-doc/html/gtk2/RecentDocuments.html +2 -3
  292. data/vendor/local/share/gtk-doc/html/gtk2/ScrollingWidgets.html +3 -4
  293. data/vendor/local/share/gtk-doc/html/gtk2/SelectorWidgets.html +3 -4
  294. data/vendor/local/share/gtk-doc/html/gtk2/SpecialObjects.html +3 -4
  295. data/vendor/local/share/gtk-doc/html/gtk2/TextWidget.html +5 -6
  296. data/vendor/local/share/gtk-doc/html/gtk2/TextWidgetObjects.html +2 -3
  297. data/vendor/local/share/gtk-doc/html/gtk2/TreeWidget.html +2 -3
  298. data/vendor/local/share/gtk-doc/html/gtk2/TreeWidgetObjects.html +3 -4
  299. data/vendor/local/share/gtk-doc/html/gtk2/WindowWidgets.html +5 -7
  300. data/vendor/local/share/gtk-doc/html/gtk2/annotation-glossary.html +9 -3
  301. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-10.html +2 -3
  302. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-12.html +2 -3
  303. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-14.html +2 -3
  304. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-16.html +2 -3
  305. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-18.html +2 -3
  306. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-2.html +2 -3
  307. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-20.html +2 -3
  308. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-22.html +2 -3
  309. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-24.html +2 -3
  310. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-4.html +2 -3
  311. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-6.html +2 -3
  312. data/vendor/local/share/gtk-doc/html/gtk2/api-index-2-8.html +2 -3
  313. data/vendor/local/share/gtk-doc/html/gtk2/api-index-deprecated.html +2 -7
  314. data/vendor/local/share/gtk-doc/html/gtk2/api-index-full.html +2 -3
  315. data/vendor/local/share/gtk-doc/html/gtk2/ch01.html +6 -7
  316. data/vendor/local/share/gtk-doc/html/gtk2/ch02.html +2 -3
  317. data/vendor/local/share/gtk-doc/html/gtk2/chap-drawing-model.html +6 -7
  318. data/vendor/local/share/gtk-doc/html/gtk2/checklist-gdkeventexpose-region.html +3 -4
  319. data/vendor/local/share/gtk-doc/html/gtk2/checklist-modifiers.html +2 -3
  320. data/vendor/local/share/gtk-doc/html/gtk2/checklist-named-icons.html +2 -3
  321. data/vendor/local/share/gtk-doc/html/gtk2/decorating-the-assistant-pages.html +2 -3
  322. data/vendor/local/share/gtk-doc/html/gtk2/glossary.html +2 -3
  323. data/vendor/local/share/gtk-doc/html/gtk2/gtk-builder-convert.html +2 -3
  324. data/vendor/local/share/gtk-doc/html/gtk2/gtk-building.html +2 -3
  325. data/vendor/local/share/gtk-doc/html/gtk2/gtk-changes-1-2.html +2 -3
  326. data/vendor/local/share/gtk-doc/html/gtk2/gtk-changes-2-0.html +2 -3
  327. data/vendor/local/share/gtk-doc/html/gtk2/gtk-compiling.html +2 -3
  328. data/vendor/local/share/gtk-doc/html/gtk2/gtk-directfb.html +2 -3
  329. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-ClientSideWindows.html +12 -13
  330. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkAboutDialog.html +2 -3
  331. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkAction.html +2 -3
  332. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkAssistant.html +2 -3
  333. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkBuilder.html +3 -4
  334. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkColorButton.html +2 -3
  335. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkComboBox.html +2 -3
  336. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkFileChooser.html +3 -4
  337. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkIconView.html +2 -3
  338. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkLinkButton.html +2 -3
  339. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-GtkRecentChooser.html +2 -3
  340. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-checklist.html +2 -3
  341. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-entry-icons.html +4 -5
  342. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-label-links.html +2 -3
  343. data/vendor/local/share/gtk-doc/html/gtk2/gtk-migrating-tooltips.html +2 -3
  344. data/vendor/local/share/gtk-doc/html/gtk2/gtk-osx.html +2 -3
  345. data/vendor/local/share/gtk-doc/html/gtk2/gtk-query-immodules-2.0.html +2 -3
  346. data/vendor/local/share/gtk-doc/html/gtk2/gtk-question-index.html +31 -32
  347. data/vendor/local/share/gtk-doc/html/gtk2/gtk-resources.html +2 -3
  348. data/vendor/local/share/gtk-doc/html/gtk2/gtk-running.html +3 -4
  349. data/vendor/local/share/gtk-doc/html/gtk2/gtk-update-icon-cache.html +2 -3
  350. data/vendor/local/share/gtk-doc/html/gtk2/gtk-windows.html +2 -3
  351. data/vendor/local/share/gtk-doc/html/gtk2/gtk-x11.html +2 -3
  352. data/vendor/local/share/gtk-doc/html/gtk2/gtk.html +2 -3
  353. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Accelerator-Maps.html +28 -32
  354. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Bindings.html +41 -48
  355. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Clipboards.html +118 -129
  356. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Drag-and-Drop.html +106 -109
  357. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Feature-Test-Macros.html +8 -10
  358. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Filesystem-utilities.html +20 -223
  359. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-General.html +124 -149
  360. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Graphics-Contexts.html +26 -28
  361. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-GtkTreeView-drag-and-drop.html +17 -25
  362. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-High-level-Printing-API.html +149 -162
  363. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Keyboard-Accelerators.html +135 -134
  364. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Orientable.html +10 -12
  365. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Resource-Files.html +50 -68
  366. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Selections.html +149 -173
  367. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Signals.html +46 -58
  368. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Standard-Enumerations.html +44 -44
  369. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Stock-Items.html +39 -485
  370. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Testing.html +21 -534
  371. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Themeable-Stock-Images.html +79 -98
  372. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-Types.html +97 -110
  373. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-gtkcheckmenuitem.html +22 -29
  374. data/vendor/local/share/gtk-doc/html/gtk2/gtk2-gtkfilefilter.html +28 -34
  375. data/vendor/local/share/gtk-doc/html/gtk2/gtk2.devhelp2 +137 -87
  376. data/vendor/local/share/gtk-doc/html/gtk2/gtkbase.html +5 -6
  377. data/vendor/local/share/gtk-doc/html/gtk2/gtkfilechooser-installing-extra-widgets.html +4 -5
  378. data/vendor/local/share/gtk-doc/html/gtk2/gtkfilechooser-installing-preview.html +4 -5
  379. data/vendor/local/share/gtk-doc/html/gtk2/gtkfilechooser-new-features.html +2 -3
  380. data/vendor/local/share/gtk-doc/html/gtk2/gtkfilechooser-selection-modes.html +2 -3
  381. data/vendor/local/share/gtk-doc/html/gtk2/gtkobjects.html +36 -38
  382. data/vendor/local/share/gtk-doc/html/gtk2/gtkrecent-advanced.html +2 -3
  383. data/vendor/local/share/gtk-doc/html/gtk2/gtkrecent-chooser.html +2 -3
  384. data/vendor/local/share/gtk-doc/html/gtk2/index.html +39 -41
  385. data/vendor/local/share/gtk-doc/html/gtk2/migrating-GtkCombo.html +2 -3
  386. data/vendor/local/share/gtk-doc/html/gtk2/migrating-gnomeuiinfo.html +13 -14
  387. data/vendor/local/share/gtk-doc/html/gtk2/migrating.html +2 -3
  388. data/vendor/local/share/gtk-doc/html/gtk2/new-features-GtkComboBox.html +2 -3
  389. data/vendor/local/share/gtk-doc/html/gtk2/pt05.html +2 -3
  390. data/vendor/local/share/gtk-doc/html/gtk2/setting-the-page-flow.html +2 -3
  391. data/vendor/local/share/gtk-doc/html/gtk2/style.css +9 -6
  392. data/vendor/local/share/gtk-doc/html/gtk2/ui-manager.html +2 -3
  393. data/vendor/local/share/locale/af/LC_MESSAGES/gtk20-properties.mo +0 -0
  394. data/vendor/local/share/locale/am/LC_MESSAGES/gtk20-properties.mo +0 -0
  395. data/vendor/local/share/locale/am/LC_MESSAGES/gtk20.mo +0 -0
  396. data/vendor/local/share/locale/ang/LC_MESSAGES/gtk20-properties.mo +0 -0
  397. data/vendor/local/share/locale/ang/LC_MESSAGES/gtk20.mo +0 -0
  398. data/vendor/local/share/locale/ar/LC_MESSAGES/gtk20-properties.mo +0 -0
  399. data/vendor/local/share/locale/as/LC_MESSAGES/gtk20-properties.mo +0 -0
  400. data/vendor/local/share/locale/as/LC_MESSAGES/gtk20.mo +0 -0
  401. data/vendor/local/share/locale/ast/LC_MESSAGES/gtk20-properties.mo +0 -0
  402. data/vendor/local/share/locale/ast/LC_MESSAGES/gtk20.mo +0 -0
  403. data/vendor/local/share/locale/az/LC_MESSAGES/gtk20-properties.mo +0 -0
  404. data/vendor/local/share/locale/az/LC_MESSAGES/gtk20.mo +0 -0
  405. data/vendor/local/share/locale/az_IR/LC_MESSAGES/gtk20-properties.mo +0 -0
  406. data/vendor/local/share/locale/az_IR/LC_MESSAGES/gtk20.mo +0 -0
  407. data/vendor/local/share/locale/be/LC_MESSAGES/gtk20-properties.mo +0 -0
  408. data/vendor/local/share/locale/be@latin/LC_MESSAGES/gtk20-properties.mo +0 -0
  409. data/vendor/local/share/locale/be@latin/LC_MESSAGES/gtk20.mo +0 -0
  410. data/vendor/local/share/locale/bg/LC_MESSAGES/gtk20-properties.mo +0 -0
  411. data/vendor/local/share/locale/bg/LC_MESSAGES/gtk20.mo +0 -0
  412. data/vendor/local/share/locale/bn/LC_MESSAGES/gtk20-properties.mo +0 -0
  413. data/vendor/local/share/locale/bn/LC_MESSAGES/gtk20.mo +0 -0
  414. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/gtk20-properties.mo +0 -0
  415. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/gtk20.mo +0 -0
  416. data/vendor/local/share/locale/br/LC_MESSAGES/gtk20-properties.mo +0 -0
  417. data/vendor/local/share/locale/br/LC_MESSAGES/gtk20.mo +0 -0
  418. data/vendor/local/share/locale/bs/LC_MESSAGES/gtk20-properties.mo +0 -0
  419. data/vendor/local/share/locale/bs/LC_MESSAGES/gtk20.mo +0 -0
  420. data/vendor/local/share/locale/ca/LC_MESSAGES/gtk20-properties.mo +0 -0
  421. data/vendor/local/share/locale/ca/LC_MESSAGES/gtk20.mo +0 -0
  422. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gtk20-properties.mo +0 -0
  423. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gtk20.mo +0 -0
  424. data/vendor/local/share/locale/crh/LC_MESSAGES/gtk20-properties.mo +0 -0
  425. data/vendor/local/share/locale/crh/LC_MESSAGES/gtk20.mo +0 -0
  426. data/vendor/local/share/locale/da/LC_MESSAGES/gtk20-properties.mo +0 -0
  427. data/vendor/local/share/locale/da/LC_MESSAGES/gtk20.mo +0 -0
  428. data/vendor/local/share/locale/de/LC_MESSAGES/gtk20.mo +0 -0
  429. data/vendor/local/share/locale/dz/LC_MESSAGES/gtk20-properties.mo +0 -0
  430. data/vendor/local/share/locale/dz/LC_MESSAGES/gtk20.mo +0 -0
  431. data/vendor/local/share/locale/el/LC_MESSAGES/gtk20-properties.mo +0 -0
  432. data/vendor/local/share/locale/en_CA/LC_MESSAGES/gtk20-properties.mo +0 -0
  433. data/vendor/local/share/locale/en_CA/LC_MESSAGES/gtk20.mo +0 -0
  434. data/vendor/local/share/locale/eo/LC_MESSAGES/gtk20-properties.mo +0 -0
  435. data/vendor/local/share/locale/eo/LC_MESSAGES/gtk20.mo +0 -0
  436. data/vendor/local/share/locale/es/LC_MESSAGES/gtk20-properties.mo +0 -0
  437. data/vendor/local/share/locale/es/LC_MESSAGES/gtk20.mo +0 -0
  438. data/vendor/local/share/locale/et/LC_MESSAGES/gtk20-properties.mo +0 -0
  439. data/vendor/local/share/locale/et/LC_MESSAGES/gtk20.mo +0 -0
  440. data/vendor/local/share/locale/eu/LC_MESSAGES/gtk20-properties.mo +0 -0
  441. data/vendor/local/share/locale/eu/LC_MESSAGES/gtk20.mo +0 -0
  442. data/vendor/local/share/locale/fa/LC_MESSAGES/gtk20-properties.mo +0 -0
  443. data/vendor/local/share/locale/fa/LC_MESSAGES/gtk20.mo +0 -0
  444. data/vendor/local/share/locale/fi/LC_MESSAGES/gtk20-properties.mo +0 -0
  445. data/vendor/local/share/locale/fi/LC_MESSAGES/gtk20.mo +0 -0
  446. data/vendor/local/share/locale/fr/LC_MESSAGES/gtk20-properties.mo +0 -0
  447. data/vendor/local/share/locale/fr/LC_MESSAGES/gtk20.mo +0 -0
  448. data/vendor/local/share/locale/ga/LC_MESSAGES/gtk20-properties.mo +0 -0
  449. data/vendor/local/share/locale/ga/LC_MESSAGES/gtk20.mo +0 -0
  450. data/vendor/local/share/locale/gu/LC_MESSAGES/gtk20-properties.mo +0 -0
  451. data/vendor/local/share/locale/gu/LC_MESSAGES/gtk20.mo +0 -0
  452. data/vendor/local/share/locale/he/LC_MESSAGES/gtk20-properties.mo +0 -0
  453. data/vendor/local/share/locale/hi/LC_MESSAGES/gtk20-properties.mo +0 -0
  454. data/vendor/local/share/locale/hi/LC_MESSAGES/gtk20.mo +0 -0
  455. data/vendor/local/share/locale/hr/LC_MESSAGES/gtk20-properties.mo +0 -0
  456. data/vendor/local/share/locale/hr/LC_MESSAGES/gtk20.mo +0 -0
  457. data/vendor/local/share/locale/hu/LC_MESSAGES/gtk20-properties.mo +0 -0
  458. data/vendor/local/share/locale/hu/LC_MESSAGES/gtk20.mo +0 -0
  459. data/vendor/local/share/locale/hy/LC_MESSAGES/gtk20-properties.mo +0 -0
  460. data/vendor/local/share/locale/hy/LC_MESSAGES/gtk20.mo +0 -0
  461. data/vendor/local/share/locale/ia/LC_MESSAGES/gtk20-properties.mo +0 -0
  462. data/vendor/local/share/locale/id/LC_MESSAGES/gtk20-properties.mo +0 -0
  463. data/vendor/local/share/locale/id/LC_MESSAGES/gtk20.mo +0 -0
  464. data/vendor/local/share/locale/io/LC_MESSAGES/gtk20-properties.mo +0 -0
  465. data/vendor/local/share/locale/io/LC_MESSAGES/gtk20.mo +0 -0
  466. data/vendor/local/share/locale/is/LC_MESSAGES/gtk20-properties.mo +0 -0
  467. data/vendor/local/share/locale/is/LC_MESSAGES/gtk20.mo +0 -0
  468. data/vendor/local/share/locale/ja/LC_MESSAGES/gtk20-properties.mo +0 -0
  469. data/vendor/local/share/locale/ja/LC_MESSAGES/gtk20.mo +0 -0
  470. data/vendor/local/share/locale/ka/LC_MESSAGES/gtk20-properties.mo +0 -0
  471. data/vendor/local/share/locale/ka/LC_MESSAGES/gtk20.mo +0 -0
  472. data/vendor/local/share/locale/kk/LC_MESSAGES/gtk20-properties.mo +0 -0
  473. data/vendor/local/share/locale/kn/LC_MESSAGES/gtk20-properties.mo +0 -0
  474. data/vendor/local/share/locale/kn/LC_MESSAGES/gtk20.mo +0 -0
  475. data/vendor/local/share/locale/ko/LC_MESSAGES/gtk20-properties.mo +0 -0
  476. data/vendor/local/share/locale/ko/LC_MESSAGES/gtk20.mo +0 -0
  477. data/vendor/local/share/locale/ku/LC_MESSAGES/gtk20-properties.mo +0 -0
  478. data/vendor/local/share/locale/ku/LC_MESSAGES/gtk20.mo +0 -0
  479. data/vendor/local/share/locale/li/LC_MESSAGES/gtk20-properties.mo +0 -0
  480. data/vendor/local/share/locale/li/LC_MESSAGES/gtk20.mo +0 -0
  481. data/vendor/local/share/locale/lv/LC_MESSAGES/gtk20-properties.mo +0 -0
  482. data/vendor/local/share/locale/lv/LC_MESSAGES/gtk20.mo +0 -0
  483. data/vendor/local/share/locale/mai/LC_MESSAGES/gtk20-properties.mo +0 -0
  484. data/vendor/local/share/locale/mai/LC_MESSAGES/gtk20.mo +0 -0
  485. data/vendor/local/share/locale/mi/LC_MESSAGES/gtk20-properties.mo +0 -0
  486. data/vendor/local/share/locale/mi/LC_MESSAGES/gtk20.mo +0 -0
  487. data/vendor/local/share/locale/mk/LC_MESSAGES/gtk20-properties.mo +0 -0
  488. data/vendor/local/share/locale/mk/LC_MESSAGES/gtk20.mo +0 -0
  489. data/vendor/local/share/locale/ml/LC_MESSAGES/gtk20-properties.mo +0 -0
  490. data/vendor/local/share/locale/ml/LC_MESSAGES/gtk20.mo +0 -0
  491. data/vendor/local/share/locale/mn/LC_MESSAGES/gtk20-properties.mo +0 -0
  492. data/vendor/local/share/locale/mn/LC_MESSAGES/gtk20.mo +0 -0
  493. data/vendor/local/share/locale/mr/LC_MESSAGES/gtk20-properties.mo +0 -0
  494. data/vendor/local/share/locale/mr/LC_MESSAGES/gtk20.mo +0 -0
  495. data/vendor/local/share/locale/ms/LC_MESSAGES/gtk20-properties.mo +0 -0
  496. data/vendor/local/share/locale/ms/LC_MESSAGES/gtk20.mo +0 -0
  497. data/vendor/local/share/locale/my/LC_MESSAGES/gtk20-properties.mo +0 -0
  498. data/vendor/local/share/locale/my/LC_MESSAGES/gtk20.mo +0 -0
  499. data/vendor/local/share/locale/nb/LC_MESSAGES/gtk20-properties.mo +0 -0
  500. data/vendor/local/share/locale/nb/LC_MESSAGES/gtk20.mo +0 -0
  501. data/vendor/local/share/locale/nds/LC_MESSAGES/gtk20-properties.mo +0 -0
  502. data/vendor/local/share/locale/nds/LC_MESSAGES/gtk20.mo +0 -0
  503. data/vendor/local/share/locale/ne/LC_MESSAGES/gtk20-properties.mo +0 -0
  504. data/vendor/local/share/locale/ne/LC_MESSAGES/gtk20.mo +0 -0
  505. data/vendor/local/share/locale/nl/LC_MESSAGES/gtk20-properties.mo +0 -0
  506. data/vendor/local/share/locale/nn/LC_MESSAGES/gtk20-properties.mo +0 -0
  507. data/vendor/local/share/locale/nn/LC_MESSAGES/gtk20.mo +0 -0
  508. data/vendor/local/share/locale/nso/LC_MESSAGES/gtk20-properties.mo +0 -0
  509. data/vendor/local/share/locale/nso/LC_MESSAGES/gtk20.mo +0 -0
  510. data/vendor/local/share/locale/oc/LC_MESSAGES/gtk20-properties.mo +0 -0
  511. data/vendor/local/share/locale/oc/LC_MESSAGES/gtk20.mo +0 -0
  512. data/vendor/local/share/locale/or/LC_MESSAGES/gtk20-properties.mo +0 -0
  513. data/vendor/local/share/locale/or/LC_MESSAGES/gtk20.mo +0 -0
  514. data/vendor/local/share/locale/pa/LC_MESSAGES/gtk20-properties.mo +0 -0
  515. data/vendor/local/share/locale/pa/LC_MESSAGES/gtk20.mo +0 -0
  516. data/vendor/local/share/locale/ps/LC_MESSAGES/gtk20-properties.mo +0 -0
  517. data/vendor/local/share/locale/ps/LC_MESSAGES/gtk20.mo +0 -0
  518. data/vendor/local/share/locale/pt/LC_MESSAGES/gtk20-properties.mo +0 -0
  519. data/vendor/local/share/locale/pt/LC_MESSAGES/gtk20.mo +0 -0
  520. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gtk20-properties.mo +0 -0
  521. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gtk20.mo +0 -0
  522. data/vendor/local/share/locale/ru/LC_MESSAGES/gtk20-properties.mo +0 -0
  523. data/vendor/local/share/locale/ru/LC_MESSAGES/gtk20.mo +0 -0
  524. data/vendor/local/share/locale/rw/LC_MESSAGES/gtk20-properties.mo +0 -0
  525. data/vendor/local/share/locale/rw/LC_MESSAGES/gtk20.mo +0 -0
  526. data/vendor/local/share/locale/si/LC_MESSAGES/gtk20-properties.mo +0 -0
  527. data/vendor/local/share/locale/si/LC_MESSAGES/gtk20.mo +0 -0
  528. data/vendor/local/share/locale/sk/LC_MESSAGES/gtk20-properties.mo +0 -0
  529. data/vendor/local/share/locale/sk/LC_MESSAGES/gtk20.mo +0 -0
  530. data/vendor/local/share/locale/sl/LC_MESSAGES/gtk20-properties.mo +0 -0
  531. data/vendor/local/share/locale/sl/LC_MESSAGES/gtk20.mo +0 -0
  532. data/vendor/local/share/locale/sq/LC_MESSAGES/gtk20-properties.mo +0 -0
  533. data/vendor/local/share/locale/sq/LC_MESSAGES/gtk20.mo +0 -0
  534. data/vendor/local/share/locale/sr/LC_MESSAGES/gtk20-properties.mo +0 -0
  535. data/vendor/local/share/locale/sr/LC_MESSAGES/gtk20.mo +0 -0
  536. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/gtk20-properties.mo +0 -0
  537. data/vendor/local/share/locale/sr@ije/LC_MESSAGES/gtk20.mo +0 -0
  538. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gtk20-properties.mo +0 -0
  539. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gtk20.mo +0 -0
  540. data/vendor/local/share/locale/sv/LC_MESSAGES/gtk20-properties.mo +0 -0
  541. data/vendor/local/share/locale/sv/LC_MESSAGES/gtk20.mo +0 -0
  542. data/vendor/local/share/locale/ta/LC_MESSAGES/gtk20-properties.mo +0 -0
  543. data/vendor/local/share/locale/ta/LC_MESSAGES/gtk20.mo +0 -0
  544. data/vendor/local/share/locale/te/LC_MESSAGES/gtk20-properties.mo +0 -0
  545. data/vendor/local/share/locale/te/LC_MESSAGES/gtk20.mo +0 -0
  546. data/vendor/local/share/locale/th/LC_MESSAGES/gtk20-properties.mo +0 -0
  547. data/vendor/local/share/locale/th/LC_MESSAGES/gtk20.mo +0 -0
  548. data/vendor/local/share/locale/tk/LC_MESSAGES/gtk20-properties.mo +0 -0
  549. data/vendor/local/share/locale/tk/LC_MESSAGES/gtk20.mo +0 -0
  550. data/vendor/local/share/locale/tr/LC_MESSAGES/gtk20-properties.mo +0 -0
  551. data/vendor/local/share/locale/tr/LC_MESSAGES/gtk20.mo +0 -0
  552. data/vendor/local/share/locale/tt/LC_MESSAGES/gtk20-properties.mo +0 -0
  553. data/vendor/local/share/locale/tt/LC_MESSAGES/gtk20.mo +0 -0
  554. data/vendor/local/share/locale/ug/LC_MESSAGES/gtk20-properties.mo +0 -0
  555. data/vendor/local/share/locale/ug/LC_MESSAGES/gtk20.mo +0 -0
  556. data/vendor/local/share/locale/uk/LC_MESSAGES/gtk20-properties.mo +0 -0
  557. data/vendor/local/share/locale/uk/LC_MESSAGES/gtk20.mo +0 -0
  558. data/vendor/local/share/locale/ur/LC_MESSAGES/gtk20-properties.mo +0 -0
  559. data/vendor/local/share/locale/ur/LC_MESSAGES/gtk20.mo +0 -0
  560. data/vendor/local/share/locale/uz/LC_MESSAGES/gtk20-properties.mo +0 -0
  561. data/vendor/local/share/locale/uz/LC_MESSAGES/gtk20.mo +0 -0
  562. data/vendor/local/share/locale/uz@cyrillic/LC_MESSAGES/gtk20-properties.mo +0 -0
  563. data/vendor/local/share/locale/uz@cyrillic/LC_MESSAGES/gtk20.mo +0 -0
  564. data/vendor/local/share/locale/vi/LC_MESSAGES/gtk20-properties.mo +0 -0
  565. data/vendor/local/share/locale/vi/LC_MESSAGES/gtk20.mo +0 -0
  566. data/vendor/local/share/locale/wa/LC_MESSAGES/gtk20-properties.mo +0 -0
  567. data/vendor/local/share/locale/wa/LC_MESSAGES/gtk20.mo +0 -0
  568. data/vendor/local/share/locale/xh/LC_MESSAGES/gtk20-properties.mo +0 -0
  569. data/vendor/local/share/locale/xh/LC_MESSAGES/gtk20.mo +0 -0
  570. data/vendor/local/share/locale/yi/LC_MESSAGES/gtk20-properties.mo +0 -0
  571. data/vendor/local/share/locale/yi/LC_MESSAGES/gtk20.mo +0 -0
  572. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gtk20-properties.mo +0 -0
  573. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gtk20-properties.mo +0 -0
  574. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gtk20.mo +0 -0
  575. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gtk20-properties.mo +0 -0
  576. metadata +10 -14
  577. data/lib/2.0/gtk2.so +0 -0
  578. data/lib/2.1/gtk2.so +0 -0
  579. data/vendor/local/share/gtk-doc/html/gail-libgail-util/index.sgml +0 -30
  580. data/vendor/local/share/gtk-doc/html/gdk2/index.sgml +0 -1534
  581. data/vendor/local/share/gtk-doc/html/gtk2/index.sgml +0 -8851
@@ -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.21.1 (XML mode)">
11
+ <meta name="generator" content="GTK-Doc V1.24.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">
@@ -32,7 +32,7 @@
32
32
  <div class="refnamediv"><table width="100%"><tr>
33
33
  <td valign="top">
34
34
  <h2><span class="refentrytitle"><a name="GtkFileChooser.top_of_page"></a>GtkFileChooser</span></h2>
35
- <p>GtkFileChooser — File chooser interface used by GtkFileChooserWidget and GtkFileChooserDialog</p>
35
+ <p>GtkFileChooser</p>
36
36
  </td>
37
37
  <td class="gallery_image" valign="top" align="right"></td>
38
38
  </tr></table></div>
@@ -45,10 +45,6 @@
45
45
  </colgroup>
46
46
  <tbody>
47
47
  <tr>
48
- <td class="define_keyword">#define</td>
49
- <td class="function_name"><a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ERROR:CAPS" title="GTK_FILE_CHOOSER_ERROR">GTK_FILE_CHOOSER_ERROR</a></td>
50
- </tr>
51
- <tr>
52
48
  <td class="function_type">
53
49
  <span class="returnvalue">void</span>
54
50
  </td>
@@ -362,7 +358,7 @@
362
358
  </tr>
363
359
  <tr>
364
360
  <td class="function_type">
365
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
361
+ <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
366
362
  </td>
367
363
  <td class="function_name">
368
364
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-file" title="gtk_file_chooser_get_current_folder_file ()">gtk_file_chooser_get_current_folder_file</a> <span class="c_punctuation">()</span>
@@ -370,7 +366,7 @@
370
366
  </tr>
371
367
  <tr>
372
368
  <td class="function_type">
373
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
369
+ <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
374
370
  </td>
375
371
  <td class="function_name">
376
372
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-file" title="gtk_file_chooser_get_file ()">gtk_file_chooser_get_file</a> <span class="c_punctuation">()</span>
@@ -386,7 +382,7 @@
386
382
  </tr>
387
383
  <tr>
388
384
  <td class="function_type">
389
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
385
+ <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
390
386
  </td>
391
387
  <td class="function_name">
392
388
  <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-file" title="gtk_file_chooser_get_preview_file ()">gtk_file_chooser_get_preview_file</a> <span class="c_punctuation">()</span>
@@ -561,6 +557,10 @@
561
557
  <td class="function_name"><a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation">GtkFileChooserConfirmation</a></td>
562
558
  </tr>
563
559
  <tr>
560
+ <td class="define_keyword">#define</td>
561
+ <td class="function_name"><a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ERROR:CAPS" title="GTK_FILE_CHOOSER_ERROR">GTK_FILE_CHOOSER_ERROR</a></td>
562
+ </tr>
563
+ <tr>
564
564
  <td class="datatype_keyword">enum</td>
565
565
  <td class="function_name"><a class="link" href="GtkFileChooser.html#GtkFileChooserError" title="enum GtkFileChooserError">GtkFileChooserError</a></td>
566
566
  </tr>
@@ -613,7 +613,7 @@
613
613
  </div>
614
614
  <div class="refsect1">
615
615
  <a name="GtkFileChooser.object-hierarchy"></a><h2>Object Hierarchy</h2>
616
- <pre class="screen"> GInterface
616
+ <pre class="screen"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>
617
617
  <span class="lineart">╰──</span> GtkFileChooser
618
618
  </pre>
619
619
  </div>
@@ -636,740 +636,22 @@ GtkFileChooser is implemented by
636
636
  </div>
637
637
  <div class="refsect1">
638
638
  <a name="GtkFileChooser.description"></a><h2>Description</h2>
639
- <p><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> is an interface that can be implemented by file
640
- selection widgets. In GTK+, the main objects that implement this
641
- interface are <a class="link" href="GtkFileChooserWidget.html" title="GtkFileChooserWidget"><span class="type">GtkFileChooserWidget</span></a>, <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a>, and
642
- <a class="link" href="GtkFileChooserButton.html" title="GtkFileChooserButton"><span class="type">GtkFileChooserButton</span></a>. You do not need to write an object that
643
- implements the <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> interface unless you are trying to
644
- adapt an existing file selector to expose a standard programming
645
- interface.</p>
646
- <p><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> allows for shortcuts to various places in the filesystem.
647
- In the default implementation these are displayed in the left pane. It
648
- may be a bit confusing at first that these shortcuts come from various
649
- sources and in various flavours, so lets explain the terminology here:</p>
650
- <div class="variablelist"><table border="0" class="variablelist">
651
- <colgroup>
652
- <col align="left" valign="top">
653
- <col>
654
- </colgroup>
655
- <tbody>
656
- <tr>
657
- <td><p><span class="term">Bookmarks</span></p></td>
658
- <td>
659
- are created by the user, by dragging folders from the
660
- right pane to the left pane, or by using the "Add". Bookmarks
661
- can be renamed and deleted by the user.
662
- </td>
663
- </tr>
664
- <tr>
665
- <td><p><span class="term">Shortcuts</span></p></td>
666
- <td>
667
- can be provided by the application or by the underlying filesystem
668
- abstraction (e.g. both the gnome-vfs and the Windows filesystems
669
- provide "Desktop" shortcuts). Shortcuts cannot be modified by the
670
- user.
671
- </td>
672
- </tr>
673
- <tr>
674
- <td><p><span class="term">Volumes</span></p></td>
675
- <td>
676
- are provided by the underlying filesystem abstraction. They are
677
- the "roots" of the filesystem.
678
- </td>
679
- </tr>
680
- </tbody>
681
- </table></div>
682
- <div class="refsect2">
683
- <a name="gtkfilechooser-encodings"></a><h3>File Names and Encodings</h3>
684
- When the user is finished selecting files in a
685
- <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>, your program can get the selected names
686
- either as filenames or as URIs. For URIs, the normal escaping
687
- rules are applied if the URI contains non-ASCII characters.
688
- However, filenames are <span class="emphasis"><em>always</em></span> returned in
689
- the character set specified by the
690
- <code class="envar">G_FILENAME_ENCODING</code> environment variable.
691
- Please see the Glib documentation for more details about this
692
- variable.
693
- <div class="note">
694
- This means that while you can pass the result of
695
- <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
696
- <code class="function">open(2)</code> or
697
- <code class="function">fopen(3)</code>, you may not be able to
698
- 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
699
- convert it first to UTF-8, which all GTK+ widgets expect.
700
- You should use <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> to convert filenames
701
- into strings that can be passed to GTK+ widgets.
702
- </div>
703
- </div>
704
- <hr>
705
- <div class="refsect2">
706
- <a name="gtkfilechooser-preview"></a><h3>Adding a Preview Widget</h3>
707
- <p>
708
- You can add a custom preview widget to a file chooser and then
709
- get notification about when the preview needs to be updated.
710
- To install a preview widget, use
711
- <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>. Then, connect to the
712
- <a class="link" href="GtkFileChooser.html#GtkFileChooser-update-preview" title="The “update-preview” signal"><span class="type">“update-preview”</span></a> signal to get notified when
713
- you need to update the contents of the preview.
714
- </p>
715
- <p>
716
- Your callback should use
717
- <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
718
- previewing. Once you have generated the preview for the
719
- corresponding file, you must call
720
- <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
721
- flag that indicates whether your callback could successfully
722
- generate a preview.
723
- </p>
724
- <div class="example">
725
- <a name="example-gtkfilechooser-preview"></a><p class="title"><b>Example 40. Sample Usage</b></p>
726
- <div class="example-contents">
727
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
728
- <tbody>
729
- <tr>
730
- <td class="listing_lines" align="right"><pre>1
731
- 2
732
- 3
733
- 4
734
- 5
735
- 6
736
- 7
737
- 8
738
- 9
739
- 10
740
- 11
741
- 12
742
- 13
743
- 14
744
- 15
745
- 16
746
- 17
747
- 18
748
- 19
749
- 20
750
- 21
751
- 22
752
- 23
753
- 24
754
- 25
755
- 26
756
- 27
757
- 28
758
- 29
759
- 30
760
- 31
761
- 32
762
- 33</pre></td>
763
- <td class="listing_code"><pre class="programlisting"><span class="cbracket">{</span>
764
- <span class="normal"> </span><span class="usertype">GtkImage</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">preview</span><span class="symbol">;</span>
765
-
766
- <span class="normal"> </span><span class="symbol">...</span>
767
-
768
- <span class="normal"> preview </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkImage.html#gtk-image-new">gtk_image_new</a></span><span class="normal"> </span><span class="symbol">();</span>
769
-
770
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget">gtk_file_chooser_set_preview_widget</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_file_chooser</span><span class="symbol">,</span><span class="normal"> preview</span><span class="symbol">);</span>
771
- <span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_file_chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"update-preview"</span><span class="symbol">,</span>
772
- <span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update_preview_cb</span><span class="symbol">),</span><span class="normal"> preview</span><span class="symbol">);</span>
773
- <span class="cbracket">}</span>
774
-
775
- <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
776
- <span class="function">update_preview_cb</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkFileChooser</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">file_chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
777
- <span class="cbracket">{</span>
778
- <span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">preview</span><span class="symbol">;</span>
779
- <span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">filename</span><span class="symbol">;</span>
780
- <span class="normal"> </span><span class="usertype">GdkPixbuf</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">pixbuf</span><span class="symbol">;</span>
781
- <span class="normal"> </span><span class="usertype">gboolean</span><span class="normal"> have_preview</span><span class="symbol">;</span>
782
-
783
- <span class="normal"> preview </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GTK_WIDGET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">);</span>
784
- <span class="normal"> filename </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename">gtk_file_chooser_get_preview_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_chooser</span><span class="symbol">);</span>
785
-
786
- <span class="normal"> pixbuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-size">gdk_pixbuf_new_from_file_at_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">,</span><span class="normal"> </span><span class="number">128</span><span class="symbol">,</span><span class="normal"> </span><span class="number">128</span><span class="symbol">,</span><span class="normal"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
787
- <span class="normal"> have_preview </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf </span><span class="symbol">!=</span><span class="normal"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
788
- <span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">);</span>
789
-
790
- <span class="normal"> </span><span class="function"><a href="GtkImage.html#gtk-image-set-from-pixbuf">gtk_image_set_from_pixbuf</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_IMAGE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">preview</span><span class="symbol">),</span><span class="normal"> pixbuf</span><span class="symbol">);</span>
791
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">)</span>
792
- <span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">);</span>
793
-
794
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active">gtk_file_chooser_set_preview_widget_active</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_chooser</span><span class="symbol">,</span><span class="normal"> have_preview</span><span class="symbol">);</span>
795
- <span class="cbracket">}</span></pre></td>
796
- </tr>
797
- </tbody>
798
- </table>
799
- </div>
800
-
801
- </div>
802
- <br class="example-break">
803
- </div>
804
- <hr>
805
- <div class="refsect2">
806
- <a name="gtkfilechooser-extra"></a><h3>Adding Extra Widgets</h3>
807
- <p>
808
- You can add extra widgets to a file chooser to provide options
809
- that are not present in the default design. For example, you
810
- can add a toggle button to give the user the option to open a
811
- file in read-only mode. You can use
812
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-extra-widget" title="gtk_file_chooser_set_extra_widget ()"><code class="function">gtk_file_chooser_set_extra_widget()</code></a> to insert additional
813
- widgets in a file chooser.
814
- </p>
815
- <div class="example">
816
- <a name="example-gtkfilechooser-extra"></a><p class="title"><b>Example 41. Sample Usage</b></p>
817
- <div class="example-contents">
818
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
819
- <tbody>
820
- <tr>
821
- <td class="listing_lines" align="right"><pre>1
822
- 2
823
- 3
824
- 4
825
- 5
826
- 6
827
- 7
828
- 8</pre></td>
829
- <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">toggle</span><span class="symbol">;</span>
830
-
831
- <span class="symbol">...</span>
832
-
833
- <span class="normal">toggle </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkCheckButton.html#gtk-check-button-new-with-label">gtk_check_button_new_with_label</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Open file read-only"</span><span class="symbol">);</span>
834
- <span class="function"><a href="GtkWidget.html#gtk-widget-show">gtk_widget_show</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">toggle</span><span class="symbol">);</span>
835
- <span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-extra-widget">gtk_file_chooser_set_extra_widget</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_file_chooser</span><span class="symbol">,</span><span class="normal"> toggle</span><span class="symbol">);</span>
836
- <span class="cbracket">}</span></pre></td>
837
- </tr>
838
- </tbody>
839
- </table>
840
- </div>
841
-
842
- </div>
843
- <br class="example-break"><div class="note">
844
- If you want to set more than one extra widget in the file
845
- 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>
846
- and include your widgets in it. Then, set the container as
847
- the whole extra widget.
848
- </div>
849
- </div>
850
- <hr>
851
- <div class="refsect2">
852
- <a name="gtkfilechooser-key-bindings"></a><h3>Key Bindings</h3>
853
- <p>
854
- Internally, GTK+ implements a file chooser's graphical user
855
- interface with the private
856
- <code class="classname">GtkFileChooserDefaultClass</code>. This
857
- widget has several <GTKDOCLINK HREF="gtk-Bindings">key
858
- bindings</GTKDOCLINK> and their associated signals. This section
859
- describes the available key binding signals.
860
- </p>
861
- <div class="example">
862
- <a name="gtkfilechooser-key-binding-example"></a><p class="title"><b>Example 42. GtkFileChooser key binding example</b></p>
863
- <div class="example-contents">
864
- <p>
865
- The default keys that activate the key-binding signals in
866
- <code class="classname">GtkFileChooserDefaultClass</code> are as
867
- follows:
868
- </p>
869
- <div class="informaltable"><table border="1">
870
- <colgroup>
871
- <col>
872
- <col>
873
- </colgroup>
874
- <tbody>
875
- <tr>
876
- <td>Signal name</td>
877
- <td>Default key combinations</td>
878
- </tr>
879
- <tr>
880
- <td>location-popup</td>
881
- <td>
882
- <span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>L</strong></span> (empty path);
883
- <span class="keycap"><strong>/</strong></span> (path of "/")
884
- <a href="#ftn.id-1.4.12.6.11.8.3.3.1.1.2.2.3" class="footnote" name="id-1.4.12.6.11.8.3.3.1.1.2.2.3"><sup class="footnote">[a]</sup></a>;
885
- <span class="keycap"><strong>~</strong></span> (path of "~")
886
- </td>
887
- </tr>
888
- <tr>
889
- <td>up-folder</td>
890
- <td>
891
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Up</strong></span>;
892
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Up</strong></span>
893
- <a href="#ftn.id-1.4.12.6.11.8.3.3.1.1.3.2.3" class="footnote" name="id-1.4.12.6.11.8.3.3.1.1.3.2.3"><sup class="footnote">[b]</sup></a>;
894
- <span class="keycap"><strong>Backspace</strong></span>
895
- </td>
896
- </tr>
897
- <tr>
898
- <td>down-folder</td>
899
- <td>
900
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Down</strong></span>;
901
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Down</strong></span>
902
- <a href="#ftn.id-1.4.12.6.11.8.3.3.1.1.4.2.3" class="footnote" name="id-1.4.12.6.11.8.3.3.1.1.4.2.3"><sup class="footnote">[c]</sup></a>
903
- </td>
904
- </tr>
905
- <tr>
906
- <td>home-folder</td>
907
- <td>
908
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Home</strong></span>
909
- </td>
910
- </tr>
911
- <tr>
912
- <td>desktop-folder</td>
913
- <td>
914
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>D</strong></span>
915
- </td>
916
- </tr>
917
- <tr>
918
- <td>quick-bookmark</td>
919
- <td>
920
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>1</strong></span> through <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>0</strong></span>
921
- </td>
922
- </tr>
923
- </tbody>
924
- <tbody class="footnotes"><tr><td colspan="2">
925
- <div id="ftn.id-1.4.12.6.11.8.3.3.1.1.2.2.3" class="footnote"><span class="keycap"><strong><a href="#id-1.4.12.6.11.8.3.3.1.1.2.2.3" class="keycap"><sup>[a] </sup></a>/</strong></span></div>
926
- <div id="ftn.id-1.4.12.6.11.8.3.3.1.1.3.2.3" class="footnote"></div>
927
- <div id="ftn.id-1.4.12.6.11.8.3.3.1.1.4.2.3" class="footnote"></div>
928
- </td></tr></tbody>
929
- </table></div>
930
- <p>
931
- You can change these defaults to something else. For
932
- example, to add a <span class="keycap"><strong>Shift</strong></span> modifier to a few
933
- of the default bindings, you can include the following
934
- fragment in your <code class="filename">.gtkrc-3.0</code> file:
935
- </p>
936
- <pre class="programlisting">
937
- binding "my-own-gtkfilechooser-bindings" {
938
- bind "&lt;Alt&gt;&lt;Shift&gt;Up" {
939
- "up-folder" ()
940
- }
941
- bind "&lt;Alt&gt;&lt;Shift&gt;Down" {
942
- "down-folder" ()
943
- }
944
- bind "&lt;Alt&gt;&lt;Shift&gt;Home" {
945
- "home-folder" ()
946
- }
947
- }
948
-
949
- class "GtkFileChooserDefault" binding "my-own-gtkfilechooser-bindings"
950
- </pre>
951
- </div>
952
- </div>
953
- <br class="example-break"><div class="refsect3">
954
- <a name="GtkFileChooserDefault-location-popup"></a><h4>The "GtkFileChooserDefault::location-popup" signal</h4>
955
- <pre class="programlisting">
956
- void user_function (GtkFileChooserDefault *chooser,
957
- const char *path,
958
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
959
- </pre>
960
- <p>
961
- This is used to make the file chooser show a "Location"
962
- dialog which the user can use to manually type the name of
963
- the file he wishes to select. The
964
- <em class="parameter"><code>path</code></em> argument is a string that gets
965
- put in the text entry for the file name. By default this is bound to
966
- <span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>L</strong></span>
967
- with a <em class="parameter"><code>path</code></em> string of "" (the empty
968
- string). It is also bound to <span class="keycap"><strong>/</strong></span> with a
969
- <em class="parameter"><code>path</code></em> string of "<code class="literal">/</code>"
970
- (a slash): this lets you type <span class="keycap"><strong>/</strong></span> and
971
- immediately type a path name. On Unix systems, this is bound to
972
- <span class="keycap"><strong>~</strong></span> (tilde) with a <em class="parameter"><code>path</code></em> string
973
- of "~" itself for access to home directories.
974
- </p>
975
- <div class="variablelist"><table border="0" class="variablelist">
976
- <colgroup>
977
- <col align="left" valign="top">
978
- <col>
979
- </colgroup>
980
- <tbody>
981
- <tr>
982
- <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
983
- <td>
984
- the object which received the signal.
985
- </td>
986
- </tr>
987
- <tr>
988
- <td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
989
- <td>
990
- default contents for the text entry for the file name
991
- </td>
992
- </tr>
993
- <tr>
994
- <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
995
- <td>
996
- user data set when the signal handler was connected.
997
- </td>
998
- </tr>
999
- </tbody>
1000
- </table></div>
1001
- <div class="note">
1002
- You can create your own bindings for the
1003
- <a class="link" href="GtkFileChooser.html#GtkFileChooserDefault-location-popup" title='The "GtkFileChooserDefault::location-popup" signal'><span class="type">“location-popup”</span></a> signal with custom
1004
- <em class="parameter"><code>path</code></em> strings, and have a crude form
1005
- of easily-to-type bookmarks. For example, say you access
1006
- the path <code class="filename">/home/username/misc</code> very
1007
- frequently. You could then create an <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>M</strong></span>
1008
- shortcut by including the following in your
1009
- <code class="filename">.gtkrc-3.0</code>:
1010
- <pre class="programlisting">
1011
- binding "misc-shortcut" {
1012
- bind "&lt;Alt&gt;M" {
1013
- "location-popup" ("/home/username/misc")
1014
- }
1015
- }
1016
-
1017
- class "GtkFileChooserDefault" binding "misc-shortcut"
1018
- </pre>
1019
- </div>
1020
- </div>
1021
- <div class="refsect3">
1022
- <a name="GtkFileChooserDefault-up-folder"></a><h4>The "GtkFileChooserDefault::up-folder" signal</h4>
1023
- <pre class="programlisting">
1024
- void user_function (GtkFileChooserDefault *chooser,
1025
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
1026
- </pre>
1027
- <p>
1028
- This is used to make the file chooser go to the parent of
1029
- the current folder in the file hierarchy. By default this
1030
- is bound to <span class="keycap"><strong>Backspace</strong></span> and
1031
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Up</strong></span>
1032
- (the Up key in the numeric keypad also works).
1033
- </p>
1034
- <div class="variablelist"><table border="0" class="variablelist">
1035
- <colgroup>
1036
- <col align="left" valign="top">
1037
- <col>
1038
- </colgroup>
1039
- <tbody>
1040
- <tr>
1041
- <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
1042
- <td>
1043
- the object which received the signal.
1044
- </td>
1045
- </tr>
1046
- <tr>
1047
- <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1048
- <td>
1049
- user data set when the signal handler was connected.
1050
- </td>
1051
- </tr>
1052
- </tbody>
1053
- </table></div>
1054
- </div>
1055
- <div class="refsect3">
1056
- <a name="GtkFileChooserDefault-down-folder"></a><h4>The "GtkFileChooserDefault::down-folder" signal</h4>
1057
- <pre class="programlisting">
1058
- void user_function (GtkFileChooserDefault *chooser,
1059
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
1060
- </pre>
1061
- <p>
1062
- This is used to make the file chooser go to a child of the
1063
- current folder in the file hierarchy. The subfolder that
1064
- will be used is displayed in the path bar widget of the file
1065
- chooser. For example, if the path bar is showing
1066
- "/foo/<span class="emphasis"><em>bar/</em></span>baz", then this will cause
1067
- the file chooser to switch to the "baz" subfolder. By
1068
- default this is bound to
1069
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Down</strong></span>
1070
- (the Down key in the numeric keypad also works).
1071
- </p>
1072
- <div class="variablelist"><table border="0" class="variablelist">
1073
- <colgroup>
1074
- <col align="left" valign="top">
1075
- <col>
1076
- </colgroup>
1077
- <tbody>
1078
- <tr>
1079
- <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
1080
- <td>
1081
- the object which received the signal.
1082
- </td>
1083
- </tr>
1084
- <tr>
1085
- <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1086
- <td>
1087
- user data set when the signal handler was connected.
1088
- </td>
1089
- </tr>
1090
- </tbody>
1091
- </table></div>
1092
- </div>
1093
- <div class="refsect3">
1094
- <a name="GtkFileChooserDefault-home-folder"></a><h4>The "GtkFileChooserDefault::home-folder" signal</h4>
1095
- <pre class="programlisting">
1096
- void user_function (GtkFileChooserDefault *chooser,
1097
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
1098
- </pre>
1099
- <p>
1100
- This is used to make the file chooser show the user's home
1101
- folder in the file list. By default this is bound to
1102
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Home</strong></span>
1103
- (the Home key in the numeric keypad also works).
1104
- </p>
1105
- <div class="variablelist"><table border="0" class="variablelist">
1106
- <colgroup>
1107
- <col align="left" valign="top">
1108
- <col>
1109
- </colgroup>
1110
- <tbody>
1111
- <tr>
1112
- <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
1113
- <td>
1114
- the object which received the signal.
1115
- </td>
1116
- </tr>
1117
- <tr>
1118
- <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1119
- <td>
1120
- user data set when the signal handler was connected.
1121
- </td>
1122
- </tr>
1123
- </tbody>
1124
- </table></div>
1125
- </div>
1126
- <div class="refsect3">
1127
- <a name="GtkFileChooserDefault-desktop-folder"></a><h4>The "GtkFileChooserDefault::desktop-folder" signal</h4>
1128
- <pre class="programlisting">
1129
- void user_function (GtkFileChooserDefault *chooser,
1130
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
1131
- </pre>
1132
- <p>
1133
- This is used to make the file chooser show the user's Desktop
1134
- folder in the file list. By default this is bound to
1135
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>D</strong></span>.
1136
- </p>
1137
- <div class="variablelist"><table border="0" class="variablelist">
1138
- <colgroup>
1139
- <col align="left" valign="top">
1140
- <col>
1141
- </colgroup>
1142
- <tbody>
1143
- <tr>
1144
- <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
1145
- <td>
1146
- the object which received the signal.
1147
- </td>
1148
- </tr>
1149
- <tr>
1150
- <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1151
- <td>
1152
- user data set when the signal handler was connected.
1153
- </td>
1154
- </tr>
1155
- </tbody>
1156
- </table></div>
1157
- </div>
1158
- <div class="refsect3">
1159
- <a name="GtkFileChooserDefault-quick-bookmark"></a><h4>The "GtkFileChooserDefault::quick-bookmark" signal</h4>
1160
- <pre class="programlisting">
1161
- void user_function (GtkFileChooserDefault *chooser,
1162
- gint bookmark_index,
1163
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
1164
- </pre>
1165
- <p>
1166
- This is used to make the file chooser switch to the bookmark
1167
- specified in the <em class="parameter"><code>bookmark_index</code></em> parameter.
1168
- For example, if you have three bookmarks, you can pass 0, 1, 2 to
1169
- this signal to switch to each of them, respectively. By default this is bound to
1170
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>1</strong></span>,
1171
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>2</strong></span>,
1172
- etc. until
1173
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>0</strong></span>. Note
1174
- that in the default binding,
1175
- that <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>1</strong></span> is
1176
- actually defined to switch to the bookmark at index 0, and so on
1177
- successively;
1178
- <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>0</strong></span> is
1179
- defined to switch to the bookmark at index 10.
1180
- </p>
1181
- <div class="variablelist"><table border="0" class="variablelist">
1182
- <colgroup>
1183
- <col align="left" valign="top">
1184
- <col>
1185
- </colgroup>
1186
- <tbody>
1187
- <tr>
1188
- <td><p><span class="term"><em class="parameter"><code>chooser</code></em> :</span></p></td>
1189
- <td>
1190
- the object which received the signal.
1191
- </td>
1192
- </tr>
1193
- <tr>
1194
- <td><p><span class="term"><em class="parameter"><code>bookmark_indes</code></em> :</span></p></td>
1195
- <td>
1196
- index of the bookmark to switch to; the indices start at 0.
1197
- </td>
1198
- </tr>
1199
- <tr>
1200
- <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1201
- <td>
1202
- user data set when the signal handler was connected.
1203
- </td>
1204
- </tr>
1205
- </tbody>
1206
- </table></div>
1207
- </div>
1208
- </div>
1209
- <hr>
1210
- <div class="refsect2">
1211
- <a name="gtkfilechooser-configuration-options"></a><h3>Configuration Options</h3>
1212
- <p>
1213
- In GTK+ 2.x, the file chooser saves its state and configuration options in a
1214
- <code class="filename">gtk-2.0/gtkfilechooser.ini</code> file under the directory that
1215
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-get-user-config-dir"><code class="function">g_get_user_config_dir()</code></a> returns. (On Unix, this usually resolves to
1216
- <code class="filename">$HOME/username/.config/gtk-2.0/gtkfilechooser.ini</code>.) While some of
1217
- the available options can be changed directly through the file chooser's user
1218
- interface, a couple are only editable by hand or by third-party tools (such
1219
- as <a class="ulink" href="https://wiki.gnome.org/action/show/Apps/GnomeTweakTool" target="_top">gnome-tweak-tool</a>).
1220
- This section describes the available options.
1221
- </p>
1222
- <p>
1223
- This is a sample of the contents of a <code class="filename">gtkfilechooser.ini</code>
1224
- file. Note that all the following options go under a
1225
- <code class="literal">[Filechooser Settings]</code> heading.
1226
- </p>
1227
- <pre class="programlisting">
1228
- [Filechooser Settings]
1229
- LocationMode=filename-entry
1230
- ShowHidden=false
1231
- ExpandFolders=true
1232
- GeometryX=570
1233
- GeometryY=273
1234
- GeometryWidth=780
1235
- GeometryHeight=585
1236
- ShowSizeColumn=true
1237
- SortColumn=name
1238
- SortOrder=ascending
1239
- StartupMode=recent
1240
- </pre>
1241
- <div class="refsect3">
1242
- <a name="gtkfilechooser-settings-location-mode"></a><h4>LocationMode key</h4>
1243
- <p>
1244
- The <code class="literal">LocationMode</code> key controls whether the file chooser
1245
- shows just a path bar, or a visible entry for the filename as well, for the
1246
- benefit of typing-oriented users. The possible string values for these modes
1247
- are <code class="literal">path-bar</code> and <code class="literal">filename-entry</code>,
1248
- respectively.
1249
- </p>
1250
- </div>
1251
- <div class="refsect3">
1252
- <a name="gtkfilechooser-settings-show-hidden"></a><h4>ShowHidden key</h4>
1253
- <p>
1254
- The <code class="literal">ShowHidden</code> key controls whether the file chooser shows
1255
- hidden files or not. The value can be be <code class="literal">true</code> or
1256
- <code class="literal">false</code>.
1257
- </p>
1258
- </div>
1259
- <div class="refsect3">
1260
- <a name="gtkfilechooser-settings-show-size-column"></a><h4>ShowSizeColumn key</h4>
1261
- <p>
1262
- The <code class="literal">ShowSize</code> key controls whether the file chooser shows
1263
- a column with file sizes. The value can be be <code class="literal">true</code> or
1264
- <code class="literal">false</code>.
1265
- </p>
1266
- </div>
1267
- <div class="refsect3">
1268
- <a name="gtkfilechooser-settings-geometry-keys"></a><h4>Geometry keys</h4>
1269
- <p>
1270
- The four keys <code class="literal">GeometryX</code>, <code class="literal">GeometryY</code>,
1271
- <code class="literal">GeometryWidth</code>, <code class="literal">GeometryHeight</code> save the
1272
- position and dimensions of the <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a>'s window.
1273
- </p>
1274
- </div>
1275
- <div class="refsect3">
1276
- <a name="gtkfilechooser-settings-sort-column"></a><h4>SortColumn key</h4>
1277
- <p>
1278
- The <code class="literal">SortColumn</code> key can be one of the strings
1279
- <code class="literal">name</code>, <code class="literal">modified</code>, or
1280
- <code class="literal">size</code>. It controls which of the columns in the file
1281
- chooser is used for sorting the list of files.
1282
- </p>
1283
- </div>
1284
- <div class="refsect3">
1285
- <a name="gtkfilechooser-settings-sort-order"></a><h4>SortOrder key</h4>
1286
- <p>
1287
- The <code class="literal">SortOrder</code> key can be one of the strings
1288
- <code class="literal">ascending</code> or <code class="literal">descending</code>.
1289
- </p>
1290
- </div>
1291
- <div class="refsect3">
1292
- <a name="gtkfilechooser-settings-startup-mode"></a><h4>StartupMode key</h4>
1293
- <p>
1294
- The <code class="literal">StartupMode</code> key controls whether the file chooser
1295
- starts up showing the list of recently-used files, or the contents of the
1296
- current working directory. Respectively, the values can be
1297
- <code class="literal">recent</code> or <code class="literal">cwd</code>.
1298
- </p>
1299
- </div>
1300
- </div>
1301
639
  </div>
1302
640
  <div class="refsect1">
1303
641
  <a name="GtkFileChooser.functions_details"></a><h2>Functions</h2>
1304
642
  <div class="refsect2">
1305
- <a name="GTK-FILE-CHOOSER-ERROR:CAPS"></a><h3>GTK_FILE_CHOOSER_ERROR</h3>
1306
- <pre class="programlisting">#define GTK_FILE_CHOOSER_ERROR (gtk_file_chooser_error_quark ())
1307
- </pre>
1308
- <p>Used to get the <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> quark for <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> errors.</p>
1309
- </div>
1310
- <hr>
1311
- <div class="refsect2">
1312
643
  <a name="gtk-file-chooser-set-action"></a><h3>gtk_file_chooser_set_action ()</h3>
1313
644
  <pre class="programlisting"><span class="returnvalue">void</span>
1314
645
  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>,
1315
646
  <em class="parameter"><code><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> action</code></em>);</pre>
1316
- <p>Sets the type of operation that the chooser is performing; the
1317
- user interface is adapted to suit the selected action. For example,
1318
- an option to create a new folder might be shown if the action is
1319
- <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> but not if the action is
1320
- <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a>.</p>
1321
- <div class="refsect3">
1322
- <a name="id-1.4.12.6.12.3.5"></a><h4>Parameters</h4>
1323
- <div class="informaltable"><table width="100%" border="0">
1324
- <colgroup>
1325
- <col width="150px" class="parameters_name">
1326
- <col class="parameters_description">
1327
- <col width="200px" class="parameters_annotations">
1328
- </colgroup>
1329
- <tbody>
1330
- <tr>
1331
- <td class="parameter_name"><p>chooser</p></td>
1332
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1333
- <td class="parameter_annotations"> </td>
1334
- </tr>
1335
- <tr>
1336
- <td class="parameter_name"><p>action</p></td>
1337
- <td class="parameter_description"><p>the action that the file selector is performing</p></td>
1338
- <td class="parameter_annotations"> </td>
1339
- </tr>
1340
- </tbody>
1341
- </table></div>
1342
- </div>
1343
- <p class="since">Since 2.4</p>
647
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1344
648
  </div>
1345
649
  <hr>
1346
650
  <div class="refsect2">
1347
651
  <a name="gtk-file-chooser-get-action"></a><h3>gtk_file_chooser_get_action ()</h3>
1348
652
  <pre class="programlisting"><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a>
1349
653
  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>
1350
- <p>Gets the type of operation that the file chooser is performing; see
1351
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-action" title="gtk_file_chooser_set_action ()"><code class="function">gtk_file_chooser_set_action()</code></a>.</p>
1352
- <div class="refsect3">
1353
- <a name="id-1.4.12.6.12.4.5"></a><h4>Parameters</h4>
1354
- <div class="informaltable"><table width="100%" border="0">
1355
- <colgroup>
1356
- <col width="150px" class="parameters_name">
1357
- <col class="parameters_description">
1358
- <col width="200px" class="parameters_annotations">
1359
- </colgroup>
1360
- <tbody><tr>
1361
- <td class="parameter_name"><p>chooser</p></td>
1362
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1363
- <td class="parameter_annotations"> </td>
1364
- </tr></tbody>
1365
- </table></div>
1366
- </div>
1367
- <div class="refsect3">
1368
- <a name="id-1.4.12.6.12.4.6"></a><h4>Returns</h4>
1369
- <p> the action that the file selector is performing</p>
1370
- <p></p>
1371
- </div>
1372
- <p class="since">Since 2.4</p>
654
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1373
655
  </div>
1374
656
  <hr>
1375
657
  <div class="refsect2">
@@ -1377,71 +659,14 @@ gtk_file_chooser_get_action (<em class="parameter"><code><a class="link" href="G
1377
659
  <pre class="programlisting"><span class="returnvalue">void</span>
1378
660
  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>,
1379
661
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_only</code></em>);</pre>
1380
- <p>Sets whether only local files can be selected in the
1381
- file selector. If <em class="parameter"><code>local_only</code></em>
1382
- is <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> (the default),
1383
- then the selected file are files are guaranteed to be
1384
- accessible through the operating systems native file
1385
- file system and therefore the application only
1386
- needs to worry about the filename functions in
1387
- <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>,
1388
- rather than the URI functions like
1389
- <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>,</p>
1390
- <p>On some systems non-native files may still be
1391
- available using the native filesystem via a userspace
1392
- filesystem (FUSE).</p>
1393
- <div class="refsect3">
1394
- <a name="id-1.4.12.6.12.5.6"></a><h4>Parameters</h4>
1395
- <div class="informaltable"><table width="100%" border="0">
1396
- <colgroup>
1397
- <col width="150px" class="parameters_name">
1398
- <col class="parameters_description">
1399
- <col width="200px" class="parameters_annotations">
1400
- </colgroup>
1401
- <tbody>
1402
- <tr>
1403
- <td class="parameter_name"><p>chooser</p></td>
1404
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1405
- <td class="parameter_annotations"> </td>
1406
- </tr>
1407
- <tr>
1408
- <td class="parameter_name"><p>local_only</p></td>
1409
- <td class="parameter_description"><p><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected</p></td>
1410
- <td class="parameter_annotations"> </td>
1411
- </tr>
1412
- </tbody>
1413
- </table></div>
1414
- </div>
1415
- <p class="since">Since 2.4</p>
662
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1416
663
  </div>
1417
664
  <hr>
1418
665
  <div class="refsect2">
1419
666
  <a name="gtk-file-chooser-get-local-only"></a><h3>gtk_file_chooser_get_local_only ()</h3>
1420
667
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1421
668
  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>
1422
- <p>Gets whether only local files can be selected in the
1423
- file selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-local-only" title="gtk_file_chooser_set_local_only ()"><code class="function">gtk_file_chooser_set_local_only()</code></a></p>
1424
- <div class="refsect3">
1425
- <a name="id-1.4.12.6.12.6.5"></a><h4>Parameters</h4>
1426
- <div class="informaltable"><table width="100%" border="0">
1427
- <colgroup>
1428
- <col width="150px" class="parameters_name">
1429
- <col class="parameters_description">
1430
- <col width="200px" class="parameters_annotations">
1431
- </colgroup>
1432
- <tbody><tr>
1433
- <td class="parameter_name"><p>chooser</p></td>
1434
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1435
- <td class="parameter_annotations"> </td>
1436
- </tr></tbody>
1437
- </table></div>
1438
- </div>
1439
- <div class="refsect3">
1440
- <a name="id-1.4.12.6.12.6.6"></a><h4>Returns</h4>
1441
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected.</p>
1442
- <p></p>
1443
- </div>
1444
- <p class="since">Since 2.4</p>
669
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1445
670
  </div>
1446
671
  <hr>
1447
672
  <div class="refsect2">
@@ -1449,61 +674,14 @@ file selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-se
1449
674
  <pre class="programlisting"><span class="returnvalue">void</span>
1450
675
  gtk_file_chooser_set_select_multiple (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1451
676
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> select_multiple</code></em>);</pre>
1452
- <p>Sets whether multiple files can be selected in the file selector. This is
1453
- only relevant if the action is set to be <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a> or
1454
- <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a>.</p>
1455
- <div class="refsect3">
1456
- <a name="id-1.4.12.6.12.7.5"></a><h4>Parameters</h4>
1457
- <div class="informaltable"><table width="100%" border="0">
1458
- <colgroup>
1459
- <col width="150px" class="parameters_name">
1460
- <col class="parameters_description">
1461
- <col width="200px" class="parameters_annotations">
1462
- </colgroup>
1463
- <tbody>
1464
- <tr>
1465
- <td class="parameter_name"><p>chooser</p></td>
1466
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1467
- <td class="parameter_annotations"> </td>
1468
- </tr>
1469
- <tr>
1470
- <td class="parameter_name"><p>select_multiple</p></td>
1471
- <td class="parameter_description"><p><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.</p></td>
1472
- <td class="parameter_annotations"> </td>
1473
- </tr>
1474
- </tbody>
1475
- </table></div>
1476
- </div>
1477
- <p class="since">Since 2.4</p>
677
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1478
678
  </div>
1479
679
  <hr>
1480
680
  <div class="refsect2">
1481
681
  <a name="gtk-file-chooser-get-select-multiple"></a><h3>gtk_file_chooser_get_select_multiple ()</h3>
1482
682
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1483
683
  gtk_file_chooser_get_select_multiple (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1484
- <p>Gets whether multiple files can be selected in the file
1485
- selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-select-multiple" title="gtk_file_chooser_set_select_multiple ()"><code class="function">gtk_file_chooser_set_select_multiple()</code></a>.</p>
1486
- <div class="refsect3">
1487
- <a name="id-1.4.12.6.12.8.5"></a><h4>Parameters</h4>
1488
- <div class="informaltable"><table width="100%" border="0">
1489
- <colgroup>
1490
- <col width="150px" class="parameters_name">
1491
- <col class="parameters_description">
1492
- <col width="200px" class="parameters_annotations">
1493
- </colgroup>
1494
- <tbody><tr>
1495
- <td class="parameter_name"><p>chooser</p></td>
1496
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1497
- <td class="parameter_annotations"> </td>
1498
- </tr></tbody>
1499
- </table></div>
1500
- </div>
1501
- <div class="refsect3">
1502
- <a name="id-1.4.12.6.12.8.6"></a><h4>Returns</h4>
1503
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.</p>
1504
- <p></p>
1505
- </div>
1506
- <p class="since">Since 2.4</p>
684
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1507
685
  </div>
1508
686
  <hr>
1509
687
  <div class="refsect2">
@@ -1511,59 +689,14 @@ selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-sel
1511
689
  <pre class="programlisting"><span class="returnvalue">void</span>
1512
690
  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>,
1513
691
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_hidden</code></em>);</pre>
1514
- <p>Sets whether hidden files and folders are displayed in the file selector.</p>
1515
- <div class="refsect3">
1516
- <a name="id-1.4.12.6.12.9.5"></a><h4>Parameters</h4>
1517
- <div class="informaltable"><table width="100%" border="0">
1518
- <colgroup>
1519
- <col width="150px" class="parameters_name">
1520
- <col class="parameters_description">
1521
- <col width="200px" class="parameters_annotations">
1522
- </colgroup>
1523
- <tbody>
1524
- <tr>
1525
- <td class="parameter_name"><p>chooser</p></td>
1526
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1527
- <td class="parameter_annotations"> </td>
1528
- </tr>
1529
- <tr>
1530
- <td class="parameter_name"><p>show_hidden</p></td>
1531
- <td class="parameter_description"><p><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders should be displayed.</p></td>
1532
- <td class="parameter_annotations"> </td>
1533
- </tr>
1534
- </tbody>
1535
- </table></div>
1536
- </div>
1537
- <p class="since">Since 2.6</p>
692
+ <p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
1538
693
  </div>
1539
694
  <hr>
1540
695
  <div class="refsect2">
1541
696
  <a name="gtk-file-chooser-get-show-hidden"></a><h3>gtk_file_chooser_get_show_hidden ()</h3>
1542
697
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1543
698
  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>
1544
- <p>Gets whether hidden files and folders are displayed in the file selector.
1545
- See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-show-hidden" title="gtk_file_chooser_set_show_hidden ()"><code class="function">gtk_file_chooser_set_show_hidden()</code></a>.</p>
1546
- <div class="refsect3">
1547
- <a name="id-1.4.12.6.12.10.5"></a><h4>Parameters</h4>
1548
- <div class="informaltable"><table width="100%" border="0">
1549
- <colgroup>
1550
- <col width="150px" class="parameters_name">
1551
- <col class="parameters_description">
1552
- <col width="200px" class="parameters_annotations">
1553
- </colgroup>
1554
- <tbody><tr>
1555
- <td class="parameter_name"><p>chooser</p></td>
1556
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1557
- <td class="parameter_annotations"> </td>
1558
- </tr></tbody>
1559
- </table></div>
1560
- </div>
1561
- <div class="refsect3">
1562
- <a name="id-1.4.12.6.12.10.6"></a><h4>Returns</h4>
1563
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders are displayed.</p>
1564
- <p></p>
1565
- </div>
1566
- <p class="since">Since 2.6</p>
699
+ <p class="since">Since: <a class="link" href="api-index-2-6.html#api-index-2.6">2.6</a></p>
1567
700
  </div>
1568
701
  <hr>
1569
702
  <div class="refsect2">
@@ -1572,39 +705,7 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-show-hidden"
1572
705
  gtk_file_chooser_set_do_overwrite_confirmation
1573
706
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1574
707
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> do_overwrite_confirmation</code></em>);</pre>
1575
- <p>Sets whether a file chooser in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode will present
1576
- a confirmation dialog if the user types a file name that already exists. This
1577
- is <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> by default.</p>
1578
- <p>Regardless of this setting, the <em class="parameter"><code>chooser</code></em>
1579
- will emit the
1580
- <a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a> signal when appropriate.</p>
1581
- <p>If all you need is the stock confirmation dialog, set this property to <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
1582
- You can override the way confirmation is done by actually handling the
1583
- <a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a> signal; please refer to its documentation
1584
- for the details.</p>
1585
- <div class="refsect3">
1586
- <a name="id-1.4.12.6.12.11.7"></a><h4>Parameters</h4>
1587
- <div class="informaltable"><table width="100%" border="0">
1588
- <colgroup>
1589
- <col width="150px" class="parameters_name">
1590
- <col class="parameters_description">
1591
- <col width="200px" class="parameters_annotations">
1592
- </colgroup>
1593
- <tbody>
1594
- <tr>
1595
- <td class="parameter_name"><p>chooser</p></td>
1596
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1597
- <td class="parameter_annotations"> </td>
1598
- </tr>
1599
- <tr>
1600
- <td class="parameter_name"><p>do_overwrite_confirmation</p></td>
1601
- <td class="parameter_description"><p>whether to confirm overwriting in save mode</p></td>
1602
- <td class="parameter_annotations"> </td>
1603
- </tr>
1604
- </tbody>
1605
- </table></div>
1606
- </div>
1607
- <p class="since">Since 2.8</p>
708
+ <p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
1608
709
  </div>
1609
710
  <hr>
1610
711
  <div class="refsect2">
@@ -1612,30 +713,7 @@ for the details.</p>
1612
713
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1613
714
  gtk_file_chooser_get_do_overwrite_confirmation
1614
715
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1615
- <p>Queries whether a file chooser is set to confirm for overwriting when the user
1616
- types a file name that already exists.</p>
1617
- <div class="refsect3">
1618
- <a name="id-1.4.12.6.12.12.5"></a><h4>Parameters</h4>
1619
- <div class="informaltable"><table width="100%" border="0">
1620
- <colgroup>
1621
- <col width="150px" class="parameters_name">
1622
- <col class="parameters_description">
1623
- <col width="200px" class="parameters_annotations">
1624
- </colgroup>
1625
- <tbody><tr>
1626
- <td class="parameter_name"><p>chooser</p></td>
1627
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1628
- <td class="parameter_annotations"> </td>
1629
- </tr></tbody>
1630
- </table></div>
1631
- </div>
1632
- <div class="refsect3">
1633
- <a name="id-1.4.12.6.12.12.6"></a><h4>Returns</h4>
1634
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser will present a confirmation dialog;
1635
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
1636
- <p></p>
1637
- </div>
1638
- <p class="since">Since 2.8</p>
716
+ <p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
1639
717
  </div>
1640
718
  <hr>
1641
719
  <div class="refsect2">
@@ -1643,61 +721,14 @@ types a file name that already exists.</p>
1643
721
  <pre class="programlisting"><span class="returnvalue">void</span>
1644
722
  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>,
1645
723
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> create_folders</code></em>);</pre>
1646
- <p>Sets whether file choser will offer to create new folders.
1647
- This is only relevant if the action is not set to be
1648
- <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a>.</p>
1649
- <div class="refsect3">
1650
- <a name="id-1.4.12.6.12.13.5"></a><h4>Parameters</h4>
1651
- <div class="informaltable"><table width="100%" border="0">
1652
- <colgroup>
1653
- <col width="150px" class="parameters_name">
1654
- <col class="parameters_description">
1655
- <col width="200px" class="parameters_annotations">
1656
- </colgroup>
1657
- <tbody>
1658
- <tr>
1659
- <td class="parameter_name"><p>chooser</p></td>
1660
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1661
- <td class="parameter_annotations"> </td>
1662
- </tr>
1663
- <tr>
1664
- <td class="parameter_name"><p>create_folders</p></td>
1665
- <td class="parameter_description"><p><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed</p></td>
1666
- <td class="parameter_annotations"> </td>
1667
- </tr>
1668
- </tbody>
1669
- </table></div>
1670
- </div>
1671
- <p class="since">Since 2.18</p>
724
+ <p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
1672
725
  </div>
1673
726
  <hr>
1674
727
  <div class="refsect2">
1675
728
  <a name="gtk-file-chooser-get-create-folders"></a><h3>gtk_file_chooser_get_create_folders ()</h3>
1676
729
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1677
730
  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>
1678
- <p>Gets whether file choser will offer to create new folders.
1679
- See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-create-folders" title="gtk_file_chooser_set_create_folders ()"><code class="function">gtk_file_chooser_set_create_folders()</code></a>.</p>
1680
- <div class="refsect3">
1681
- <a name="id-1.4.12.6.12.14.5"></a><h4>Parameters</h4>
1682
- <div class="informaltable"><table width="100%" border="0">
1683
- <colgroup>
1684
- <col width="150px" class="parameters_name">
1685
- <col class="parameters_description">
1686
- <col width="200px" class="parameters_annotations">
1687
- </colgroup>
1688
- <tbody><tr>
1689
- <td class="parameter_name"><p>chooser</p></td>
1690
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1691
- <td class="parameter_annotations"> </td>
1692
- </tr></tbody>
1693
- </table></div>
1694
- </div>
1695
- <div class="refsect3">
1696
- <a name="id-1.4.12.6.12.14.6"></a><h4>Returns</h4>
1697
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed.</p>
1698
- <p></p>
1699
- </div>
1700
- <p class="since">Since 2.18</p>
731
+ <p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
1701
732
  </div>
1702
733
  <hr>
1703
734
  <div class="refsect2">
@@ -1705,118 +736,28 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-create-folder
1705
736
  <pre class="programlisting"><span class="returnvalue">void</span>
1706
737
  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>,
1707
738
  <em class="parameter"><code>const <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
1708
- <p>Sets the current name in the file selector, as if entered
1709
- by the user. Note that the name passed in here is a UTF-8
1710
- string rather than a filename. This function is meant for
1711
- such uses as a suggested name in a "Save As..." dialog.</p>
1712
- <p>If you want to preselect a particular existing file, you should use
1713
- <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.
1714
- Please see the documentation for those functions for an example of using
1715
- <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.</p>
1716
- <div class="refsect3">
1717
- <a name="id-1.4.12.6.12.15.6"></a><h4>Parameters</h4>
1718
- <div class="informaltable"><table width="100%" border="0">
1719
- <colgroup>
1720
- <col width="150px" class="parameters_name">
1721
- <col class="parameters_description">
1722
- <col width="200px" class="parameters_annotations">
1723
- </colgroup>
1724
- <tbody>
1725
- <tr>
1726
- <td class="parameter_name"><p>chooser</p></td>
1727
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1728
- <td class="parameter_annotations"> </td>
1729
- </tr>
1730
- <tr>
1731
- <td class="parameter_name"><p>name</p></td>
1732
- <td class="parameter_description"><p> the filename to use, as a UTF-8 string. </p></td>
1733
- <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
1734
- </tr>
1735
- </tbody>
1736
- </table></div>
1737
- </div>
1738
- <p class="since">Since 2.4</p>
739
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1739
740
  </div>
1740
741
  <hr>
1741
742
  <div class="refsect2">
1742
743
  <a name="gtk-file-chooser-select-all"></a><h3>gtk_file_chooser_select_all ()</h3>
1743
744
  <pre class="programlisting"><span class="returnvalue">void</span>
1744
745
  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>
1745
- <p>Selects all the files in the current folder of a file chooser.</p>
1746
- <div class="refsect3">
1747
- <a name="id-1.4.12.6.12.16.5"></a><h4>Parameters</h4>
1748
- <div class="informaltable"><table width="100%" border="0">
1749
- <colgroup>
1750
- <col width="150px" class="parameters_name">
1751
- <col class="parameters_description">
1752
- <col width="200px" class="parameters_annotations">
1753
- </colgroup>
1754
- <tbody><tr>
1755
- <td class="parameter_name"><p>chooser</p></td>
1756
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1757
- <td class="parameter_annotations"> </td>
1758
- </tr></tbody>
1759
- </table></div>
1760
- </div>
1761
- <p class="since">Since 2.4</p>
746
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1762
747
  </div>
1763
748
  <hr>
1764
749
  <div class="refsect2">
1765
750
  <a name="gtk-file-chooser-unselect-all"></a><h3>gtk_file_chooser_unselect_all ()</h3>
1766
751
  <pre class="programlisting"><span class="returnvalue">void</span>
1767
752
  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>
1768
- <p>Unselects all the files in the current folder of a file chooser.</p>
1769
- <div class="refsect3">
1770
- <a name="id-1.4.12.6.12.17.5"></a><h4>Parameters</h4>
1771
- <div class="informaltable"><table width="100%" border="0">
1772
- <colgroup>
1773
- <col width="150px" class="parameters_name">
1774
- <col class="parameters_description">
1775
- <col width="200px" class="parameters_annotations">
1776
- </colgroup>
1777
- <tbody><tr>
1778
- <td class="parameter_name"><p>chooser</p></td>
1779
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1780
- <td class="parameter_annotations"> </td>
1781
- </tr></tbody>
1782
- </table></div>
1783
- </div>
1784
- <p class="since">Since 2.4</p>
753
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1785
754
  </div>
1786
755
  <hr>
1787
756
  <div class="refsect2">
1788
757
  <a name="gtk-file-chooser-get-uri"></a><h3>gtk_file_chooser_get_uri ()</h3>
1789
758
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1790
759
  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>
1791
- <p>Gets the URI for the currently selected file in
1792
- the file selector. If multiple files are selected,
1793
- one of the filenames will be returned at random.</p>
1794
- <p>If the file chooser is in folder mode, this function returns the selected
1795
- folder.</p>
1796
- <div class="refsect3">
1797
- <a name="id-1.4.12.6.12.18.6"></a><h4>Parameters</h4>
1798
- <div class="informaltable"><table width="100%" border="0">
1799
- <colgroup>
1800
- <col width="150px" class="parameters_name">
1801
- <col class="parameters_description">
1802
- <col width="200px" class="parameters_annotations">
1803
- </colgroup>
1804
- <tbody><tr>
1805
- <td class="parameter_name"><p>chooser</p></td>
1806
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1807
- <td class="parameter_annotations"> </td>
1808
- </tr></tbody>
1809
- </table></div>
1810
- </div>
1811
- <div class="refsect3">
1812
- <a name="id-1.4.12.6.12.18.7"></a><h4>Returns</h4>
1813
- <p> The currently selected URI, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1814
- if no file is selected. If <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-local-only" title="gtk_file_chooser_set_local_only ()"><code class="function">gtk_file_chooser_set_local_only()</code></a> is set to <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>
1815
- (the default) a local URI will be returned for any FUSE locations.
1816
- Free with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a></p>
1817
- <p></p>
1818
- </div>
1819
- <p class="since">Since 2.4</p>
760
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1820
761
  </div>
1821
762
  <hr>
1822
763
  <div class="refsect2">
@@ -1824,89 +765,7 @@ Free with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-
1824
765
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1825
766
  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>,
1826
767
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
1827
- <p>Sets the file referred to by <em class="parameter"><code>uri</code></em>
1828
- as the current file for the file chooser,
1829
- by changing to the URI's parent folder and actually selecting the URI in the
1830
- list. If the <em class="parameter"><code>chooser</code></em>
1831
- is <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the URI's base
1832
- name will also appear in the dialog's file name entry.</p>
1833
- <p>If the URI isn't in the current folder of <em class="parameter"><code>chooser</code></em>
1834
- , then the current folder
1835
- of <em class="parameter"><code>chooser</code></em>
1836
- will be changed to the folder containing <em class="parameter"><code>uri</code></em>
1837
- . This is equivalent
1838
- 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
1839
- <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>.</p>
1840
- <p>Note that the URI must exist, or nothing will be done except for the
1841
- directory change.
1842
- If you are implementing a <span class="guimenuitem">File/Save As...</span> dialog,
1843
- you should use this function if you already have a file name to which the
1844
- user may save; for example, when the user opens an existing file and then
1845
- does <span class="guimenuitem">File/Save As...</span> on it. If you don't have
1846
- a file name already — for example, if the user just created a new
1847
- file and is saving it for the first time, do not call this function.
1848
- Instead, use something similar to this:</p>
1849
- <div class="informalexample">
1850
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1851
- <tbody>
1852
- <tr>
1853
- <td class="listing_lines" align="right"><pre>1
1854
- 2
1855
- 3
1856
- 4
1857
- 5
1858
- 6
1859
- 7
1860
- 8
1861
- 9
1862
- 10
1863
- 11</pre></td>
1864
- <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">document_is_new</span><span class="symbol">)</span>
1865
- <span class="normal"> </span><span class="cbracket">{</span>
1866
- <span class="normal"> </span><span class="comment">/* the user just created a new document */</span>
1867
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri">gtk_file_chooser_set_current_folder_uri</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> default_folder_for_saving</span><span class="symbol">);</span>
1868
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-name">gtk_file_chooser_set_current_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Untitled document"</span><span class="symbol">);</span>
1869
- <span class="normal"> </span><span class="cbracket">}</span>
1870
- <span class="keyword">else</span>
1871
- <span class="normal"> </span><span class="cbracket">{</span>
1872
- <span class="normal"> </span><span class="comment">/* the user edited an existing document */</span><span class="normal"> </span>
1873
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-uri">gtk_file_chooser_set_uri</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> existing_uri</span><span class="symbol">);</span>
1874
- <span class="normal"> </span><span class="cbracket">}</span></pre></td>
1875
- </tr>
1876
- </tbody>
1877
- </table>
1878
- </div>
1879
-
1880
- <p></p>
1881
- <div class="refsect3">
1882
- <a name="id-1.4.12.6.12.19.9"></a><h4>Parameters</h4>
1883
- <div class="informaltable"><table width="100%" border="0">
1884
- <colgroup>
1885
- <col width="150px" class="parameters_name">
1886
- <col class="parameters_description">
1887
- <col width="200px" class="parameters_annotations">
1888
- </colgroup>
1889
- <tbody>
1890
- <tr>
1891
- <td class="parameter_name"><p>chooser</p></td>
1892
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1893
- <td class="parameter_annotations"> </td>
1894
- </tr>
1895
- <tr>
1896
- <td class="parameter_name"><p>uri</p></td>
1897
- <td class="parameter_description"><p>the URI to set as current</p></td>
1898
- <td class="parameter_annotations"> </td>
1899
- </tr>
1900
- </tbody>
1901
- </table></div>
1902
- </div>
1903
- <div class="refsect3">
1904
- <a name="id-1.4.12.6.12.19.10"></a><h4>Returns</h4>
1905
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
1906
- selected successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
1907
- <p></p>
1908
- </div>
1909
- <p class="since">Since 2.4</p>
768
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1910
769
  </div>
1911
770
  <hr>
1912
771
  <div class="refsect2">
@@ -1914,42 +773,7 @@ selected successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/loc
1914
773
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
1915
774
  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>,
1916
775
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
1917
- <p>Selects the file to by <em class="parameter"><code>uri</code></em>
1918
- . If the URI doesn't refer to a
1919
- file in the current folder of <em class="parameter"><code>chooser</code></em>
1920
- , then the current folder of
1921
- <em class="parameter"><code>chooser</code></em>
1922
- will be changed to the folder containing <em class="parameter"><code>filename</code></em>
1923
- .</p>
1924
- <div class="refsect3">
1925
- <a name="id-1.4.12.6.12.20.5"></a><h4>Parameters</h4>
1926
- <div class="informaltable"><table width="100%" border="0">
1927
- <colgroup>
1928
- <col width="150px" class="parameters_name">
1929
- <col class="parameters_description">
1930
- <col width="200px" class="parameters_annotations">
1931
- </colgroup>
1932
- <tbody>
1933
- <tr>
1934
- <td class="parameter_name"><p>chooser</p></td>
1935
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1936
- <td class="parameter_annotations"> </td>
1937
- </tr>
1938
- <tr>
1939
- <td class="parameter_name"><p>uri</p></td>
1940
- <td class="parameter_description"><p>the URI to select</p></td>
1941
- <td class="parameter_annotations"> </td>
1942
- </tr>
1943
- </tbody>
1944
- </table></div>
1945
- </div>
1946
- <div class="refsect3">
1947
- <a name="id-1.4.12.6.12.20.6"></a><h4>Returns</h4>
1948
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
1949
- selected successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
1950
- <p></p>
1951
- </div>
1952
- <p class="since">Since 2.4</p>
776
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1953
777
  </div>
1954
778
  <hr>
1955
779
  <div class="refsect2">
@@ -1957,65 +781,14 @@ selected successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/loc
1957
781
  <pre class="programlisting"><span class="returnvalue">void</span>
1958
782
  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>,
1959
783
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
1960
- <p>Unselects the file referred to by <em class="parameter"><code>uri</code></em>
1961
- . If the file
1962
- is not in the current directory, does not exist, or
1963
- is otherwise not currently selected, does nothing.</p>
1964
- <div class="refsect3">
1965
- <a name="id-1.4.12.6.12.21.5"></a><h4>Parameters</h4>
1966
- <div class="informaltable"><table width="100%" border="0">
1967
- <colgroup>
1968
- <col width="150px" class="parameters_name">
1969
- <col class="parameters_description">
1970
- <col width="200px" class="parameters_annotations">
1971
- </colgroup>
1972
- <tbody>
1973
- <tr>
1974
- <td class="parameter_name"><p>chooser</p></td>
1975
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
1976
- <td class="parameter_annotations"> </td>
1977
- </tr>
1978
- <tr>
1979
- <td class="parameter_name"><p>uri</p></td>
1980
- <td class="parameter_description"><p>the URI to unselect</p></td>
1981
- <td class="parameter_annotations"> </td>
1982
- </tr>
1983
- </tbody>
1984
- </table></div>
1985
- </div>
1986
- <p class="since">Since 2.4</p>
784
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
1987
785
  </div>
1988
786
  <hr>
1989
787
  <div class="refsect2">
1990
788
  <a name="gtk-file-chooser-get-uris"></a><h3>gtk_file_chooser_get_uris ()</h3>
1991
789
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
1992
790
  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>
1993
- <p>Lists all the selected files and subfolders in the current folder of
1994
- <em class="parameter"><code>chooser</code></em>
1995
- . The returned names are full absolute URIs.</p>
1996
- <div class="refsect3">
1997
- <a name="id-1.4.12.6.12.22.5"></a><h4>Parameters</h4>
1998
- <div class="informaltable"><table width="100%" border="0">
1999
- <colgroup>
2000
- <col width="150px" class="parameters_name">
2001
- <col class="parameters_description">
2002
- <col width="200px" class="parameters_annotations">
2003
- </colgroup>
2004
- <tbody><tr>
2005
- <td class="parameter_name"><p>chooser</p></td>
2006
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2007
- <td class="parameter_annotations"> </td>
2008
- </tr></tbody>
2009
- </table></div>
2010
- </div>
2011
- <div class="refsect3">
2012
- <a name="id-1.4.12.6.12.22.6"></a><h4>Returns</h4>
2013
- <p> a <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the URIs of all selected
2014
- files and subfolders in the current folder. Free the returned list
2015
- with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
2016
- <p><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></p>
2017
- </div>
2018
- <p class="since">Since 2.4</p>
791
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2019
792
  </div>
2020
793
  <hr>
2021
794
  <div class="refsect2">
@@ -2024,39 +797,7 @@ with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/h
2024
797
  gtk_file_chooser_set_current_folder_uri
2025
798
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2026
799
  <em class="parameter"><code>const <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri</code></em>);</pre>
2027
- <p>Sets the current folder for <em class="parameter"><code>chooser</code></em>
2028
- from an URI.
2029
- The user will be shown the full contents of the current folder,
2030
- plus user interface elements for navigating to other folders.</p>
2031
- <div class="refsect3">
2032
- <a name="id-1.4.12.6.12.23.5"></a><h4>Parameters</h4>
2033
- <div class="informaltable"><table width="100%" border="0">
2034
- <colgroup>
2035
- <col width="150px" class="parameters_name">
2036
- <col class="parameters_description">
2037
- <col width="200px" class="parameters_annotations">
2038
- </colgroup>
2039
- <tbody>
2040
- <tr>
2041
- <td class="parameter_name"><p>chooser</p></td>
2042
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2043
- <td class="parameter_annotations"> </td>
2044
- </tr>
2045
- <tr>
2046
- <td class="parameter_name"><p>uri</p></td>
2047
- <td class="parameter_description"><p>the URI for the new current folder</p></td>
2048
- <td class="parameter_annotations"> </td>
2049
- </tr>
2050
- </tbody>
2051
- </table></div>
2052
- </div>
2053
- <div class="refsect3">
2054
- <a name="id-1.4.12.6.12.23.6"></a><h4>Returns</h4>
2055
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2056
- otherwise.</p>
2057
- <p></p>
2058
- </div>
2059
- <p class="since">Since 2.4</p>
800
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2060
801
  </div>
2061
802
  <hr>
2062
803
  <div class="refsect2">
@@ -2064,40 +805,7 @@ otherwise.</p>
2064
805
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
2065
806
  gtk_file_chooser_get_current_folder_uri
2066
807
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2067
- <p>Gets the current folder of <em class="parameter"><code>chooser</code></em>
2068
- as an URI.
2069
- See <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>.</p>
2070
- <p>Note that this is the folder that the file chooser is currently displaying
2071
- (e.g. "file:///home/username/Documents"), which is <span class="emphasis"><em>not the same</em></span>
2072
- as the currently-selected folder if the chooser is in
2073
- <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a> mode
2074
- (e.g. "file:///home/username/Documents/selected-folder/". To get the
2075
- currently-selected folder in that mode, use <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> as the
2076
- usual way to get the selection.</p>
2077
- <div class="refsect3">
2078
- <a name="id-1.4.12.6.12.24.6"></a><h4>Parameters</h4>
2079
- <div class="informaltable"><table width="100%" border="0">
2080
- <colgroup>
2081
- <col width="150px" class="parameters_name">
2082
- <col class="parameters_description">
2083
- <col width="200px" class="parameters_annotations">
2084
- </colgroup>
2085
- <tbody><tr>
2086
- <td class="parameter_name"><p>chooser</p></td>
2087
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2088
- <td class="parameter_annotations"> </td>
2089
- </tr></tbody>
2090
- </table></div>
2091
- </div>
2092
- <div class="refsect3">
2093
- <a name="id-1.4.12.6.12.24.7"></a><h4>Returns</h4>
2094
- <p> the URI for the current folder. Free with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. This
2095
- function will also return <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the
2096
- last folder that was requested from it; for example, as would be for calling
2097
- <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.</p>
2098
- <p></p>
2099
- </div>
2100
- <p class="since">Since 2.4</p>
808
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2101
809
  </div>
2102
810
  <hr>
2103
811
  <div class="refsect2">
@@ -2105,70 +813,14 @@ last folder that was requested from it; for example, as would be for calling
2105
813
  <pre class="programlisting"><span class="returnvalue">void</span>
2106
814
  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>,
2107
815
  <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *preview_widget</code></em>);</pre>
2108
- <p>Sets an application-supplied widget to use to display a custom preview
2109
- of the currently selected file. To implement a preview, after setting the
2110
- 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>
2111
- 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
2112
- <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
2113
- display a preview of the new file, update your widget and
2114
- 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>.
2115
- Otherwise, set the preview inactive.</p>
2116
- <p>When there is no application-supplied preview widget, or the
2117
- application-supplied preview widget is not active, the file chooser
2118
- may display an internally generated preview of the current file or
2119
- it may display no preview at all.</p>
2120
- <div class="refsect3">
2121
- <a name="id-1.4.12.6.12.25.6"></a><h4>Parameters</h4>
2122
- <div class="informaltable"><table width="100%" border="0">
2123
- <colgroup>
2124
- <col width="150px" class="parameters_name">
2125
- <col class="parameters_description">
2126
- <col width="200px" class="parameters_annotations">
2127
- </colgroup>
2128
- <tbody>
2129
- <tr>
2130
- <td class="parameter_name"><p>chooser</p></td>
2131
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2132
- <td class="parameter_annotations"> </td>
2133
- </tr>
2134
- <tr>
2135
- <td class="parameter_name"><p>preview_widget</p></td>
2136
- <td class="parameter_description"><p>widget for displaying preview.</p></td>
2137
- <td class="parameter_annotations"> </td>
2138
- </tr>
2139
- </tbody>
2140
- </table></div>
2141
- </div>
2142
- <p class="since">Since 2.4</p>
816
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2143
817
  </div>
2144
818
  <hr>
2145
819
  <div class="refsect2">
2146
820
  <a name="gtk-file-chooser-get-preview-widget"></a><h3>gtk_file_chooser_get_preview_widget ()</h3>
2147
821
  <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
2148
822
  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>
2149
- <p>Gets the current preview widget; see
2150
- <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>.</p>
2151
- <div class="refsect3">
2152
- <a name="id-1.4.12.6.12.26.5"></a><h4>Parameters</h4>
2153
- <div class="informaltable"><table width="100%" border="0">
2154
- <colgroup>
2155
- <col width="150px" class="parameters_name">
2156
- <col class="parameters_description">
2157
- <col width="200px" class="parameters_annotations">
2158
- </colgroup>
2159
- <tbody><tr>
2160
- <td class="parameter_name"><p>chooser</p></td>
2161
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2162
- <td class="parameter_annotations"> </td>
2163
- </tr></tbody>
2164
- </table></div>
2165
- </div>
2166
- <div class="refsect3">
2167
- <a name="id-1.4.12.6.12.26.6"></a><h4>Returns</h4>
2168
- <p> the current preview widget, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
2169
- <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
2170
- </div>
2171
- <p class="since">Since 2.4</p>
823
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2172
824
  </div>
2173
825
  <hr>
2174
826
  <div class="refsect2">
@@ -2177,36 +829,7 @@ gtk_file_chooser_get_preview_widget (<em class="parameter"><code><a class="link"
2177
829
  gtk_file_chooser_set_preview_widget_active
2178
830
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2179
831
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> active</code></em>);</pre>
2180
- <p>Sets whether the preview widget set by
2181
- <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> should be shown for the
2182
- current filename. When <em class="parameter"><code>active</code></em>
2183
- is set to false, the file chooser
2184
- may display an internally generated preview of the current file
2185
- or it may display no preview at all. See
2186
- <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> for more details.</p>
2187
- <div class="refsect3">
2188
- <a name="id-1.4.12.6.12.27.5"></a><h4>Parameters</h4>
2189
- <div class="informaltable"><table width="100%" border="0">
2190
- <colgroup>
2191
- <col width="150px" class="parameters_name">
2192
- <col class="parameters_description">
2193
- <col width="200px" class="parameters_annotations">
2194
- </colgroup>
2195
- <tbody>
2196
- <tr>
2197
- <td class="parameter_name"><p>chooser</p></td>
2198
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2199
- <td class="parameter_annotations"> </td>
2200
- </tr>
2201
- <tr>
2202
- <td class="parameter_name"><p>active</p></td>
2203
- <td class="parameter_description"><p>whether to display the user-specified preview widget</p></td>
2204
- <td class="parameter_annotations"> </td>
2205
- </tr>
2206
- </tbody>
2207
- </table></div>
2208
- </div>
2209
- <p class="since">Since 2.4</p>
832
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2210
833
  </div>
2211
834
  <hr>
2212
835
  <div class="refsect2">
@@ -2214,30 +837,7 @@ or it may display no preview at all. See
2214
837
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2215
838
  gtk_file_chooser_get_preview_widget_active
2216
839
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2217
- <p>Gets whether the preview widget set by <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>
2218
- should be shown for the current filename. See
2219
- <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>.</p>
2220
- <div class="refsect3">
2221
- <a name="id-1.4.12.6.12.28.5"></a><h4>Parameters</h4>
2222
- <div class="informaltable"><table width="100%" border="0">
2223
- <colgroup>
2224
- <col width="150px" class="parameters_name">
2225
- <col class="parameters_description">
2226
- <col width="200px" class="parameters_annotations">
2227
- </colgroup>
2228
- <tbody><tr>
2229
- <td class="parameter_name"><p>chooser</p></td>
2230
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2231
- <td class="parameter_annotations"> </td>
2232
- </tr></tbody>
2233
- </table></div>
2234
- </div>
2235
- <div class="refsect3">
2236
- <a name="id-1.4.12.6.12.28.6"></a><h4>Returns</h4>
2237
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the preview widget is active for the current filename.</p>
2238
- <p></p>
2239
- </div>
2240
- <p class="since">Since 2.4</p>
840
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2241
841
  </div>
2242
842
  <hr>
2243
843
  <div class="refsect2">
@@ -2246,34 +846,7 @@ should be shown for the current filename. See
2246
846
  gtk_file_chooser_set_use_preview_label
2247
847
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2248
848
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_label</code></em>);</pre>
2249
- <p>Sets whether the file chooser should display a stock label with the name of
2250
- the file that is being previewed; the default is <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. Applications that
2251
- want to draw the whole preview area themselves should set this to <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and
2252
- display the name themselves in their preview widget.</p>
2253
- <p>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></p>
2254
- <div class="refsect3">
2255
- <a name="id-1.4.12.6.12.29.6"></a><h4>Parameters</h4>
2256
- <div class="informaltable"><table width="100%" border="0">
2257
- <colgroup>
2258
- <col width="150px" class="parameters_name">
2259
- <col class="parameters_description">
2260
- <col width="200px" class="parameters_annotations">
2261
- </colgroup>
2262
- <tbody>
2263
- <tr>
2264
- <td class="parameter_name"><p>chooser</p></td>
2265
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2266
- <td class="parameter_annotations"> </td>
2267
- </tr>
2268
- <tr>
2269
- <td class="parameter_name"><p>use_label</p></td>
2270
- <td class="parameter_description"><p>whether to display a stock label with the name of the previewed file</p></td>
2271
- <td class="parameter_annotations"> </td>
2272
- </tr>
2273
- </tbody>
2274
- </table></div>
2275
- </div>
2276
- <p class="since">Since 2.4</p>
849
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2277
850
  </div>
2278
851
  <hr>
2279
852
  <div class="refsect2">
@@ -2281,59 +854,13 @@ display the name themselves in their preview widget.</p>
2281
854
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2282
855
  gtk_file_chooser_get_use_preview_label
2283
856
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2284
- <p>Gets whether a stock label should be drawn with the name of the previewed
2285
- file. See <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>.</p>
2286
- <div class="refsect3">
2287
- <a name="id-1.4.12.6.12.30.5"></a><h4>Parameters</h4>
2288
- <div class="informaltable"><table width="100%" border="0">
2289
- <colgroup>
2290
- <col width="150px" class="parameters_name">
2291
- <col class="parameters_description">
2292
- <col width="200px" class="parameters_annotations">
2293
- </colgroup>
2294
- <tbody><tr>
2295
- <td class="parameter_name"><p>chooser</p></td>
2296
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2297
- <td class="parameter_annotations"> </td>
2298
- </tr></tbody>
2299
- </table></div>
2300
- </div>
2301
- <div class="refsect3">
2302
- <a name="id-1.4.12.6.12.30.6"></a><h4>Returns</h4>
2303
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser is set to display a label with the
2304
- name of the previewed file, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
2305
- <p></p>
2306
- </div>
2307
857
  </div>
2308
858
  <hr>
2309
859
  <div class="refsect2">
2310
860
  <a name="gtk-file-chooser-get-preview-uri"></a><h3>gtk_file_chooser_get_preview_uri ()</h3>
2311
861
  <pre class="programlisting"><span class="returnvalue">char</span> *
2312
862
  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>
2313
- <p>Gets the URI that should be previewed in a custom preview
2314
- 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>.</p>
2315
- <div class="refsect3">
2316
- <a name="id-1.4.12.6.12.31.5"></a><h4>Parameters</h4>
2317
- <div class="informaltable"><table width="100%" border="0">
2318
- <colgroup>
2319
- <col width="150px" class="parameters_name">
2320
- <col class="parameters_description">
2321
- <col width="200px" class="parameters_annotations">
2322
- </colgroup>
2323
- <tbody><tr>
2324
- <td class="parameter_name"><p>chooser</p></td>
2325
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2326
- <td class="parameter_annotations"> </td>
2327
- </tr></tbody>
2328
- </table></div>
2329
- </div>
2330
- <div class="refsect3">
2331
- <a name="id-1.4.12.6.12.31.6"></a><h4>Returns</h4>
2332
- <p> the URI for the file to preview, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is
2333
- selected. Free with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
2334
- <p></p>
2335
- </div>
2336
- <p class="since">Since 2.4</p>
863
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2337
864
  </div>
2338
865
  <hr>
2339
866
  <div class="refsect2">
@@ -2341,59 +868,14 @@ selected. Free with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/
2341
868
  <pre class="programlisting"><span class="returnvalue">void</span>
2342
869
  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>,
2343
870
  <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *extra_widget</code></em>);</pre>
2344
- <p>Sets an application-supplied widget to provide extra options to the user.</p>
2345
- <div class="refsect3">
2346
- <a name="id-1.4.12.6.12.32.5"></a><h4>Parameters</h4>
2347
- <div class="informaltable"><table width="100%" border="0">
2348
- <colgroup>
2349
- <col width="150px" class="parameters_name">
2350
- <col class="parameters_description">
2351
- <col width="200px" class="parameters_annotations">
2352
- </colgroup>
2353
- <tbody>
2354
- <tr>
2355
- <td class="parameter_name"><p>chooser</p></td>
2356
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2357
- <td class="parameter_annotations"> </td>
2358
- </tr>
2359
- <tr>
2360
- <td class="parameter_name"><p>extra_widget</p></td>
2361
- <td class="parameter_description"><p>widget for extra options</p></td>
2362
- <td class="parameter_annotations"> </td>
2363
- </tr>
2364
- </tbody>
2365
- </table></div>
2366
- </div>
2367
- <p class="since">Since 2.4</p>
871
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2368
872
  </div>
2369
873
  <hr>
2370
874
  <div class="refsect2">
2371
875
  <a name="gtk-file-chooser-get-extra-widget"></a><h3>gtk_file_chooser_get_extra_widget ()</h3>
2372
876
  <pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
2373
877
  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>
2374
- <p>Gets the current preview widget; see
2375
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-extra-widget" title="gtk_file_chooser_set_extra_widget ()"><code class="function">gtk_file_chooser_set_extra_widget()</code></a>.</p>
2376
- <div class="refsect3">
2377
- <a name="id-1.4.12.6.12.33.5"></a><h4>Parameters</h4>
2378
- <div class="informaltable"><table width="100%" border="0">
2379
- <colgroup>
2380
- <col width="150px" class="parameters_name">
2381
- <col class="parameters_description">
2382
- <col width="200px" class="parameters_annotations">
2383
- </colgroup>
2384
- <tbody><tr>
2385
- <td class="parameter_name"><p>chooser</p></td>
2386
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2387
- <td class="parameter_annotations"> </td>
2388
- </tr></tbody>
2389
- </table></div>
2390
- </div>
2391
- <div class="refsect3">
2392
- <a name="id-1.4.12.6.12.33.6"></a><h4>Returns</h4>
2393
- <p> the current extra widget, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
2394
- <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
2395
- </div>
2396
- <p class="since">Since 2.4</p>
878
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2397
879
  </div>
2398
880
  <hr>
2399
881
  <div class="refsect2">
@@ -2401,36 +883,7 @@ gtk_file_chooser_get_extra_widget (<em class="parameter"><code><a class="link" h
2401
883
  <pre class="programlisting"><span class="returnvalue">void</span>
2402
884
  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>,
2403
885
  <em class="parameter"><code><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);</pre>
2404
- <p>Adds <em class="parameter"><code>filter</code></em>
2405
- to the list of filters that the user can select between.
2406
- When a filter is selected, only files that are passed by that
2407
- filter are displayed. </p>
2408
- <p>Note that the <em class="parameter"><code>chooser</code></em>
2409
- takes ownership of the filter, so you have to
2410
- ref and sink it if you want to keep a reference.</p>
2411
- <div class="refsect3">
2412
- <a name="id-1.4.12.6.12.34.6"></a><h4>Parameters</h4>
2413
- <div class="informaltable"><table width="100%" border="0">
2414
- <colgroup>
2415
- <col width="150px" class="parameters_name">
2416
- <col class="parameters_description">
2417
- <col width="200px" class="parameters_annotations">
2418
- </colgroup>
2419
- <tbody>
2420
- <tr>
2421
- <td class="parameter_name"><p>chooser</p></td>
2422
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2423
- <td class="parameter_annotations"> </td>
2424
- </tr>
2425
- <tr>
2426
- <td class="parameter_name"><p>filter</p></td>
2427
- <td class="parameter_description"><p>a <a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a></p></td>
2428
- <td class="parameter_annotations"> </td>
2429
- </tr>
2430
- </tbody>
2431
- </table></div>
2432
- </div>
2433
- <p class="since">Since 2.4</p>
886
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2434
887
  </div>
2435
888
  <hr>
2436
889
  <div class="refsect2">
@@ -2438,63 +891,14 @@ ref and sink it if you want to keep a reference.</p>
2438
891
  <pre class="programlisting"><span class="returnvalue">void</span>
2439
892
  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>,
2440
893
  <em class="parameter"><code><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);</pre>
2441
- <p>Removes <em class="parameter"><code>filter</code></em>
2442
- from the list of filters that the user can select between.</p>
2443
- <div class="refsect3">
2444
- <a name="id-1.4.12.6.12.35.5"></a><h4>Parameters</h4>
2445
- <div class="informaltable"><table width="100%" border="0">
2446
- <colgroup>
2447
- <col width="150px" class="parameters_name">
2448
- <col class="parameters_description">
2449
- <col width="200px" class="parameters_annotations">
2450
- </colgroup>
2451
- <tbody>
2452
- <tr>
2453
- <td class="parameter_name"><p>chooser</p></td>
2454
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2455
- <td class="parameter_annotations"> </td>
2456
- </tr>
2457
- <tr>
2458
- <td class="parameter_name"><p>filter</p></td>
2459
- <td class="parameter_description"><p>a <a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a></p></td>
2460
- <td class="parameter_annotations"> </td>
2461
- </tr>
2462
- </tbody>
2463
- </table></div>
2464
- </div>
2465
- <p class="since">Since 2.4</p>
894
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2466
895
  </div>
2467
896
  <hr>
2468
897
  <div class="refsect2">
2469
898
  <a name="gtk-file-chooser-list-filters"></a><h3>gtk_file_chooser_list_filters ()</h3>
2470
899
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
2471
900
  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>
2472
- <p>Lists the current set of user-selectable filters; see
2473
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-filter" title="gtk_file_chooser_add_filter ()"><code class="function">gtk_file_chooser_add_filter()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-remove-filter" title="gtk_file_chooser_remove_filter ()"><code class="function">gtk_file_chooser_remove_filter()</code></a>.</p>
2474
- <div class="refsect3">
2475
- <a name="id-1.4.12.6.12.36.5"></a><h4>Parameters</h4>
2476
- <div class="informaltable"><table width="100%" border="0">
2477
- <colgroup>
2478
- <col width="150px" class="parameters_name">
2479
- <col class="parameters_description">
2480
- <col width="200px" class="parameters_annotations">
2481
- </colgroup>
2482
- <tbody><tr>
2483
- <td class="parameter_name"><p>chooser</p></td>
2484
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2485
- <td class="parameter_annotations"> </td>
2486
- </tr></tbody>
2487
- </table></div>
2488
- </div>
2489
- <div class="refsect3">
2490
- <a name="id-1.4.12.6.12.36.6"></a><h4>Returns</h4>
2491
- <p> a
2492
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the current set of user selectable filters. The
2493
- contents of the list are owned by GTK+, but you must free the list
2494
- itself with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> when you are done with it. </p>
2495
- <p><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></p>
2496
- </div>
2497
- <p class="since">Since 2.4</p>
901
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2498
902
  </div>
2499
903
  <hr>
2500
904
  <div class="refsect2">
@@ -2502,63 +906,14 @@ itself with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gt
2502
906
  <pre class="programlisting"><span class="returnvalue">void</span>
2503
907
  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>,
2504
908
  <em class="parameter"><code><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);</pre>
2505
- <p>Sets the current filter; only the files that pass the
2506
- filter will be displayed. If the user-selectable list of filters
2507
- is non-empty, then the filter should be one of the filters
2508
- in that list. Setting the current filter when the list of
2509
- filters is empty is useful if you want to restrict the displayed
2510
- set of files without letting the user change it.</p>
2511
- <div class="refsect3">
2512
- <a name="id-1.4.12.6.12.37.5"></a><h4>Parameters</h4>
2513
- <div class="informaltable"><table width="100%" border="0">
2514
- <colgroup>
2515
- <col width="150px" class="parameters_name">
2516
- <col class="parameters_description">
2517
- <col width="200px" class="parameters_annotations">
2518
- </colgroup>
2519
- <tbody>
2520
- <tr>
2521
- <td class="parameter_name"><p>chooser</p></td>
2522
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2523
- <td class="parameter_annotations"> </td>
2524
- </tr>
2525
- <tr>
2526
- <td class="parameter_name"><p>filter</p></td>
2527
- <td class="parameter_description"><p>a <a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a></p></td>
2528
- <td class="parameter_annotations"> </td>
2529
- </tr>
2530
- </tbody>
2531
- </table></div>
2532
- </div>
2533
- <p class="since">Since 2.4</p>
909
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2534
910
  </div>
2535
911
  <hr>
2536
912
  <div class="refsect2">
2537
913
  <a name="gtk-file-chooser-get-filter"></a><h3>gtk_file_chooser_get_filter ()</h3>
2538
914
  <pre class="programlisting"><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="returnvalue">GtkFileFilter</span></a> *
2539
915
  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>
2540
- <p>Gets the current filter; see <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-filter" title="gtk_file_chooser_set_filter ()"><code class="function">gtk_file_chooser_set_filter()</code></a>.</p>
2541
- <div class="refsect3">
2542
- <a name="id-1.4.12.6.12.38.5"></a><h4>Parameters</h4>
2543
- <div class="informaltable"><table width="100%" border="0">
2544
- <colgroup>
2545
- <col width="150px" class="parameters_name">
2546
- <col class="parameters_description">
2547
- <col width="200px" class="parameters_annotations">
2548
- </colgroup>
2549
- <tbody><tr>
2550
- <td class="parameter_name"><p>chooser</p></td>
2551
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2552
- <td class="parameter_annotations"> </td>
2553
- </tr></tbody>
2554
- </table></div>
2555
- </div>
2556
- <div class="refsect3">
2557
- <a name="id-1.4.12.6.12.38.6"></a><h4>Returns</h4>
2558
- <p> the current filter, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
2559
- <p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
2560
- </div>
2561
- <p class="since">Since 2.4</p>
916
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2562
917
  </div>
2563
918
  <hr>
2564
919
  <div class="refsect2">
@@ -2568,45 +923,7 @@ gtk_file_chooser_add_shortcut_folder_uri
2568
923
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2569
924
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
2570
925
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2571
- <p>Adds a folder URI to be displayed with the shortcut folders in a file
2572
- chooser. Note that shortcut folders do not get saved, as they are provided
2573
- by the application. For example, you can use this to add a
2574
- "file:///usr/share/mydrawprogram/Clipart" folder to the volume list.</p>
2575
- <div class="refsect3">
2576
- <a name="id-1.4.12.6.12.39.5"></a><h4>Parameters</h4>
2577
- <div class="informaltable"><table width="100%" border="0">
2578
- <colgroup>
2579
- <col width="150px" class="parameters_name">
2580
- <col class="parameters_description">
2581
- <col width="200px" class="parameters_annotations">
2582
- </colgroup>
2583
- <tbody>
2584
- <tr>
2585
- <td class="parameter_name"><p>chooser</p></td>
2586
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2587
- <td class="parameter_annotations"> </td>
2588
- </tr>
2589
- <tr>
2590
- <td class="parameter_name"><p>uri</p></td>
2591
- <td class="parameter_description"><p>URI of the folder to add</p></td>
2592
- <td class="parameter_annotations"> </td>
2593
- </tr>
2594
- <tr>
2595
- <td class="parameter_name"><p>error</p></td>
2596
- <td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
2597
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
2598
- </tr>
2599
- </tbody>
2600
- </table></div>
2601
- </div>
2602
- <div class="refsect3">
2603
- <a name="id-1.4.12.6.12.39.6"></a><h4>Returns</h4>
2604
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2605
- otherwise. In the latter case, the <em class="parameter"><code>error</code></em>
2606
- will be set as appropriate.</p>
2607
- <p></p>
2608
- </div>
2609
- <p class="since">Since 2.4</p>
926
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2610
927
  </div>
2611
928
  <hr>
2612
929
  <div class="refsect2">
@@ -2616,43 +933,7 @@ gtk_file_chooser_remove_shortcut_folder_uri
2616
933
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2617
934
  <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
2618
935
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2619
- <p>Removes a folder URI from a file chooser's list of shortcut folders.</p>
2620
- <div class="refsect3">
2621
- <a name="id-1.4.12.6.12.40.5"></a><h4>Parameters</h4>
2622
- <div class="informaltable"><table width="100%" border="0">
2623
- <colgroup>
2624
- <col width="150px" class="parameters_name">
2625
- <col class="parameters_description">
2626
- <col width="200px" class="parameters_annotations">
2627
- </colgroup>
2628
- <tbody>
2629
- <tr>
2630
- <td class="parameter_name"><p>chooser</p></td>
2631
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2632
- <td class="parameter_annotations"> </td>
2633
- </tr>
2634
- <tr>
2635
- <td class="parameter_name"><p>uri</p></td>
2636
- <td class="parameter_description"><p>URI of the folder to remove</p></td>
2637
- <td class="parameter_annotations"> </td>
2638
- </tr>
2639
- <tr>
2640
- <td class="parameter_name"><p>error</p></td>
2641
- <td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
2642
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
2643
- </tr>
2644
- </tbody>
2645
- </table></div>
2646
- </div>
2647
- <div class="refsect3">
2648
- <a name="id-1.4.12.6.12.40.6"></a><h4>Returns</h4>
2649
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2650
- In the latter case, the <em class="parameter"><code>error</code></em>
2651
- will be set as appropriate.</p>
2652
- <p>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></p>
2653
- <p></p>
2654
- </div>
2655
- <p class="since">Since 2.4</p>
936
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2656
937
  </div>
2657
938
  <hr>
2658
939
  <div class="refsect2">
@@ -2660,203 +941,45 @@ will be set as appropriate.</p>
2660
941
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
2661
942
  gtk_file_chooser_list_shortcut_folder_uris
2662
943
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2663
- <p>Queries the list of shortcut folders in the file chooser, as set by
2664
- <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>.</p>
2665
- <div class="refsect3">
2666
- <a name="id-1.4.12.6.12.41.5"></a><h4>Parameters</h4>
2667
- <div class="informaltable"><table width="100%" border="0">
2668
- <colgroup>
2669
- <col width="150px" class="parameters_name">
2670
- <col class="parameters_description">
2671
- <col width="200px" class="parameters_annotations">
2672
- </colgroup>
2673
- <tbody><tr>
2674
- <td class="parameter_name"><p>chooser</p></td>
2675
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2676
- <td class="parameter_annotations"> </td>
2677
- </tr></tbody>
2678
- </table></div>
2679
- </div>
2680
- <div class="refsect3">
2681
- <a name="id-1.4.12.6.12.41.6"></a><h4>Returns</h4>
2682
- <p> A list of folder
2683
- URIs, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut folders. Free the returned
2684
- list with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the URIs with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
2685
- <p><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></p>
2686
- </div>
2687
- <p class="since">Since 2.4</p>
944
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
2688
945
  </div>
2689
946
  <hr>
2690
947
  <div class="refsect2">
2691
948
  <a name="gtk-file-chooser-get-current-folder-file"></a><h3>gtk_file_chooser_get_current_folder_file ()</h3>
2692
- <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
949
+ <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
2693
950
  gtk_file_chooser_get_current_folder_file
2694
951
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2695
- <p>Gets the current folder of <em class="parameter"><code>chooser</code></em>
2696
- as <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>.
2697
- See <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>.</p>
2698
- <div class="refsect3">
2699
- <a name="id-1.4.12.6.12.42.5"></a><h4>Parameters</h4>
2700
- <div class="informaltable"><table width="100%" border="0">
2701
- <colgroup>
2702
- <col width="150px" class="parameters_name">
2703
- <col class="parameters_description">
2704
- <col width="200px" class="parameters_annotations">
2705
- </colgroup>
2706
- <tbody><tr>
2707
- <td class="parameter_name"><p>chooser</p></td>
2708
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2709
- <td class="parameter_annotations"> </td>
2710
- </tr></tbody>
2711
- </table></div>
2712
- </div>
2713
- <div class="refsect3">
2714
- <a name="id-1.4.12.6.12.42.6"></a><h4>Returns</h4>
2715
- <p> the <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> for the current folder. </p>
2716
- <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
2717
- </div>
2718
- <p class="since">Since 2.14</p>
952
+ <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
2719
953
  </div>
2720
954
  <hr>
2721
955
  <div class="refsect2">
2722
956
  <a name="gtk-file-chooser-get-file"></a><h3>gtk_file_chooser_get_file ()</h3>
2723
- <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
957
+ <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
2724
958
  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>
2725
- <p>Gets the <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> for the currently selected file in
2726
- the file selector. If multiple files are selected,
2727
- one of the files will be returned at random.</p>
2728
- <p>If the file chooser is in folder mode, this function returns the selected
2729
- folder.</p>
2730
- <div class="refsect3">
2731
- <a name="id-1.4.12.6.12.43.6"></a><h4>Parameters</h4>
2732
- <div class="informaltable"><table width="100%" border="0">
2733
- <colgroup>
2734
- <col width="150px" class="parameters_name">
2735
- <col class="parameters_description">
2736
- <col width="200px" class="parameters_annotations">
2737
- </colgroup>
2738
- <tbody><tr>
2739
- <td class="parameter_name"><p>chooser</p></td>
2740
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2741
- <td class="parameter_annotations"> </td>
2742
- </tr></tbody>
2743
- </table></div>
2744
- </div>
2745
- <div class="refsect3">
2746
- <a name="id-1.4.12.6.12.43.7"></a><h4>Returns</h4>
2747
- <p> a selected <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>. You own the returned file;
2748
- use <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release it. </p>
2749
- <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
2750
- </div>
2751
- <p class="since">Since 2.14</p>
959
+ <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
2752
960
  </div>
2753
961
  <hr>
2754
962
  <div class="refsect2">
2755
963
  <a name="gtk-file-chooser-get-files"></a><h3>gtk_file_chooser_get_files ()</h3>
2756
964
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *
2757
965
  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>
2758
- <p>Lists all the selected files and subfolders in the current folder of <em class="parameter"><code>chooser</code></em>
2759
-
2760
- as <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>. An internal function, see <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>.</p>
2761
- <div class="refsect3">
2762
- <a name="id-1.4.12.6.12.44.5"></a><h4>Parameters</h4>
2763
- <div class="informaltable"><table width="100%" border="0">
2764
- <colgroup>
2765
- <col width="150px" class="parameters_name">
2766
- <col class="parameters_description">
2767
- <col width="200px" class="parameters_annotations">
2768
- </colgroup>
2769
- <tbody><tr>
2770
- <td class="parameter_name"><p>chooser</p></td>
2771
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2772
- <td class="parameter_annotations"> </td>
2773
- </tr></tbody>
2774
- </table></div>
2775
- </div>
2776
- <div class="refsect3">
2777
- <a name="id-1.4.12.6.12.44.6"></a><h4>Returns</h4>
2778
- <p> a <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
2779
- containing a <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> for each selected file and subfolder in the
2780
- current folder. Free the returned list with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and
2781
- the files with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
2782
- <p><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></p>
2783
- </div>
2784
- <p class="since">Since 2.14</p>
966
+ <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
2785
967
  </div>
2786
968
  <hr>
2787
969
  <div class="refsect2">
2788
970
  <a name="gtk-file-chooser-get-preview-file"></a><h3>gtk_file_chooser_get_preview_file ()</h3>
2789
- <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="returnvalue">GFile</span></a> *
971
+ <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="returnvalue">GFile</span></a> *
2790
972
  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>
2791
- <p>Gets the <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> that should be previewed in a custom preview
2792
- Internal function, see <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>.</p>
2793
- <div class="refsect3">
2794
- <a name="id-1.4.12.6.12.45.5"></a><h4>Parameters</h4>
2795
- <div class="informaltable"><table width="100%" border="0">
2796
- <colgroup>
2797
- <col width="150px" class="parameters_name">
2798
- <col class="parameters_description">
2799
- <col width="200px" class="parameters_annotations">
2800
- </colgroup>
2801
- <tbody><tr>
2802
- <td class="parameter_name"><p>chooser</p></td>
2803
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2804
- <td class="parameter_annotations"> </td>
2805
- </tr></tbody>
2806
- </table></div>
2807
- </div>
2808
- <div class="refsect3">
2809
- <a name="id-1.4.12.6.12.45.6"></a><h4>Returns</h4>
2810
- <p> the <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> for the file to preview,
2811
- or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is selected. Free with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. </p>
2812
- <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
2813
- </div>
2814
- <p class="since">Since 2.14</p>
973
+ <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
2815
974
  </div>
2816
975
  <hr>
2817
976
  <div class="refsect2">
2818
- <a name="gtk-file-chooser-select-file"></a><h3>gtk_file_chooser_select_file ()</h3>
2819
- <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2820
- 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>,
2821
- <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
2822
- <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2823
- <p>Selects the file referred to by <em class="parameter"><code>file</code></em>
2824
- . An internal function. See
2825
- <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>.</p>
2826
- <div class="refsect3">
2827
- <a name="id-1.4.12.6.12.46.5"></a><h4>Parameters</h4>
2828
- <div class="informaltable"><table width="100%" border="0">
2829
- <colgroup>
2830
- <col width="150px" class="parameters_name">
2831
- <col class="parameters_description">
2832
- <col width="200px" class="parameters_annotations">
2833
- </colgroup>
2834
- <tbody>
2835
- <tr>
2836
- <td class="parameter_name"><p>chooser</p></td>
2837
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2838
- <td class="parameter_annotations"> </td>
2839
- </tr>
2840
- <tr>
2841
- <td class="parameter_name"><p>file</p></td>
2842
- <td class="parameter_description"><p>the file to select</p></td>
2843
- <td class="parameter_annotations"> </td>
2844
- </tr>
2845
- <tr>
2846
- <td class="parameter_name"><p>error</p></td>
2847
- <td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
2848
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
2849
- </tr>
2850
- </tbody>
2851
- </table></div>
2852
- </div>
2853
- <div class="refsect3">
2854
- <a name="id-1.4.12.6.12.46.6"></a><h4>Returns</h4>
2855
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the path was
2856
- selected successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
2857
- <p></p>
2858
- </div>
2859
- <p class="since">Since 2.14</p>
977
+ <a name="gtk-file-chooser-select-file"></a><h3>gtk_file_chooser_select_file ()</h3>
978
+ <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
979
+ 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>,
980
+ <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>,
981
+ <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
982
+ <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
2860
983
  </div>
2861
984
  <hr>
2862
985
  <div class="refsect2">
@@ -2864,174 +987,26 @@ selected successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/loc
2864
987
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2865
988
  gtk_file_chooser_set_current_folder_file
2866
989
  (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2867
- <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
990
+ <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>,
2868
991
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2869
- <p>Sets the current folder for <em class="parameter"><code>chooser</code></em>
2870
- from a <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a>.
2871
- Internal function, see <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>.</p>
2872
- <div class="refsect3">
2873
- <a name="id-1.4.12.6.12.47.5"></a><h4>Parameters</h4>
2874
- <div class="informaltable"><table width="100%" border="0">
2875
- <colgroup>
2876
- <col width="150px" class="parameters_name">
2877
- <col class="parameters_description">
2878
- <col width="200px" class="parameters_annotations">
2879
- </colgroup>
2880
- <tbody>
2881
- <tr>
2882
- <td class="parameter_name"><p>chooser</p></td>
2883
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2884
- <td class="parameter_annotations"> </td>
2885
- </tr>
2886
- <tr>
2887
- <td class="parameter_name"><p>file</p></td>
2888
- <td class="parameter_description"><p>the <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> for the new folder</p></td>
2889
- <td class="parameter_annotations"> </td>
2890
- </tr>
2891
- <tr>
2892
- <td class="parameter_name"><p>error</p></td>
2893
- <td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
2894
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
2895
- </tr>
2896
- </tbody>
2897
- </table></div>
2898
- </div>
2899
- <div class="refsect3">
2900
- <a name="id-1.4.12.6.12.47.6"></a><h4>Returns</h4>
2901
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2902
- otherwise.</p>
2903
- <p></p>
2904
- </div>
2905
- <p class="since">Since 2.14</p>
992
+ <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
2906
993
  </div>
2907
994
  <hr>
2908
995
  <div class="refsect2">
2909
996
  <a name="gtk-file-chooser-set-file"></a><h3>gtk_file_chooser_set_file ()</h3>
2910
997
  <pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
2911
998
  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>,
2912
- <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
999
+ <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>,
2913
1000
  <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2914
- <p>Sets <em class="parameter"><code>file</code></em>
2915
- as the current filename for the file chooser, by changing
2916
- to the file's parent folder and actually selecting the file in list. If
2917
- the <em class="parameter"><code>chooser</code></em>
2918
- is in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the file's base name
2919
- will also appear in the dialog's file name entry.</p>
2920
- <p>If the file name isn't in the current folder of <em class="parameter"><code>chooser</code></em>
2921
- , then the current
2922
- folder of <em class="parameter"><code>chooser</code></em>
2923
- will be changed to the folder containing <em class="parameter"><code>filename</code></em>
2924
- . This
2925
- 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
2926
- <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>.</p>
2927
- <p>Note that the file must exist, or nothing will be done except
2928
- for the directory change.</p>
2929
- <p>If you are implementing a <span class="guimenuitem">File/Save As...</span> dialog,
2930
- you should use this function if you already have a file name to which the
2931
- user may save; for example, when the user opens an existing file and then
2932
- does <span class="guimenuitem">File/Save As...</span> on it. If you don't have
2933
- a file name already — for example, if the user just created a new
2934
- file and is saving it for the first time, do not call this function.
2935
- Instead, use something similar to this:</p>
2936
- <div class="informalexample">
2937
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
2938
- <tbody>
2939
- <tr>
2940
- <td class="listing_lines" align="right"><pre>1
2941
- 2
2942
- 3
2943
- 4
2944
- 5
2945
- 6
2946
- 7
2947
- 8
2948
- 9
2949
- 10
2950
- 11</pre></td>
2951
- <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">document_is_new</span><span class="symbol">)</span>
2952
- <span class="normal"> </span><span class="cbracket">{</span>
2953
- <span class="normal"> </span><span class="comment">/* the user just created a new document */</span>
2954
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-file">gtk_file_chooser_set_current_folder_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> default_file_for_saving</span><span class="symbol">);</span>
2955
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-name">gtk_file_chooser_set_current_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Untitled document"</span><span class="symbol">);</span>
2956
- <span class="normal"> </span><span class="cbracket">}</span>
2957
- <span class="keyword">else</span>
2958
- <span class="normal"> </span><span class="cbracket">{</span>
2959
- <span class="normal"> </span><span class="comment">/* the user edited an existing document */</span>
2960
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-file">gtk_file_chooser_set_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> existing_file</span><span class="symbol">);</span>
2961
- <span class="normal"> </span><span class="cbracket">}</span></pre></td>
2962
- </tr>
2963
- </tbody>
2964
- </table>
2965
- </div>
2966
-
2967
- <p></p>
2968
- <div class="refsect3">
2969
- <a name="id-1.4.12.6.12.48.10"></a><h4>Parameters</h4>
2970
- <div class="informaltable"><table width="100%" border="0">
2971
- <colgroup>
2972
- <col width="150px" class="parameters_name">
2973
- <col class="parameters_description">
2974
- <col width="200px" class="parameters_annotations">
2975
- </colgroup>
2976
- <tbody>
2977
- <tr>
2978
- <td class="parameter_name"><p>chooser</p></td>
2979
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
2980
- <td class="parameter_annotations"> </td>
2981
- </tr>
2982
- <tr>
2983
- <td class="parameter_name"><p>file</p></td>
2984
- <td class="parameter_description"><p>the <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> to set as current</p></td>
2985
- <td class="parameter_annotations"> </td>
2986
- </tr>
2987
- <tr>
2988
- <td class="parameter_name"><p>error</p></td>
2989
- <td class="parameter_description"><p> location to store the error, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors. </p></td>
2990
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
2991
- </tr>
2992
- </tbody>
2993
- </table></div>
2994
- </div>
2995
- <div class="refsect3">
2996
- <a name="id-1.4.12.6.12.48.11"></a><h4>Returns</h4>
2997
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
2998
- selected successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
2999
- <p></p>
3000
- </div>
3001
- <p class="since">Since 2.14</p>
1001
+ <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
3002
1002
  </div>
3003
1003
  <hr>
3004
1004
  <div class="refsect2">
3005
1005
  <a name="gtk-file-chooser-unselect-file"></a><h3>gtk_file_chooser_unselect_file ()</h3>
3006
1006
  <pre class="programlisting"><span class="returnvalue">void</span>
3007
1007
  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>,
3008
- <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a> *file</code></em>);</pre>
3009
- <p>Unselects the file referred to by <em class="parameter"><code>file</code></em>
3010
- . If the file is not in the current
3011
- directory, does not exist, or is otherwise not currently selected, does nothing.</p>
3012
- <div class="refsect3">
3013
- <a name="id-1.4.12.6.12.49.5"></a><h4>Parameters</h4>
3014
- <div class="informaltable"><table width="100%" border="0">
3015
- <colgroup>
3016
- <col width="150px" class="parameters_name">
3017
- <col class="parameters_description">
3018
- <col width="200px" class="parameters_annotations">
3019
- </colgroup>
3020
- <tbody>
3021
- <tr>
3022
- <td class="parameter_name"><p>chooser</p></td>
3023
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3024
- <td class="parameter_annotations"> </td>
3025
- </tr>
3026
- <tr>
3027
- <td class="parameter_name"><p>file</p></td>
3028
- <td class="parameter_description"><p>a <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html"><span class="type">GFile</span></a></p></td>
3029
- <td class="parameter_annotations"> </td>
3030
- </tr>
3031
- </tbody>
3032
- </table></div>
3033
- </div>
3034
- <p class="since">Since 2.14</p>
1008
+ <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gio/GFile.html#GFile-struct"><span class="type">GFile</span></a> *file</code></em>);</pre>
1009
+ <p class="since">Since: <a class="link" href="api-index-2-14.html#api-index-2.14">2.14</a></p>
3035
1010
  </div>
3036
1011
  </div>
3037
1012
  <div class="refsect1">
@@ -3039,16 +1014,12 @@ directory, does not exist, or is otherwise not currently selected, does nothing.
3039
1014
  <div class="refsect2">
3040
1015
  <a name="GtkFileChooser-struct"></a><h3>GtkFileChooser</h3>
3041
1016
  <pre class="programlisting">typedef struct _GtkFileChooser GtkFileChooser;</pre>
3042
- <p>
3043
- </p>
3044
1017
  </div>
3045
1018
  <hr>
3046
1019
  <div class="refsect2">
3047
1020
  <a name="GtkFileChooserAction"></a><h3>enum GtkFileChooserAction</h3>
3048
- <p>Describes whether a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> is being used to open existing files
3049
- or to save to a possibly new file.</p>
3050
1021
  <div class="refsect3">
3051
- <a name="id-1.4.12.6.13.3.4"></a><h4>Members</h4>
1022
+ <a name="GtkFileChooserAction.members"></a><h4>Members</h4>
3052
1023
  <div class="informaltable"><table width="100%" border="0">
3053
1024
  <colgroup>
3054
1025
  <col width="300px" class="enum_members_name">
@@ -3058,38 +1029,23 @@ or to save to a possibly new file.</p>
3058
1029
  <tbody>
3059
1030
  <tr>
3060
1031
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"></a>GTK_FILE_CHOOSER_ACTION_OPEN</p></td>
3061
- <td class="enum_member_description">
3062
- <p>Indicates open mode. The file chooser
3063
- will only let the user pick an existing file.</p>
3064
- </td>
3065
- <td class="enum_member_annotations"> </td>
1032
+ <td> </td>
1033
+ <td> </td>
3066
1034
  </tr>
3067
1035
  <tr>
3068
1036
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"></a>GTK_FILE_CHOOSER_ACTION_SAVE</p></td>
3069
- <td class="enum_member_description">
3070
- <p>Indicates save mode. The file chooser
3071
- will let the user pick an existing file, or type in a new
3072
- filename.</p>
3073
- </td>
3074
- <td class="enum_member_annotations"> </td>
1037
+ <td> </td>
1038
+ <td> </td>
3075
1039
  </tr>
3076
1040
  <tr>
3077
1041
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"></a>GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</p></td>
3078
- <td class="enum_member_description">
3079
- <p>Indicates an Open mode for
3080
- selecting folders. The file chooser will let the user pick an
3081
- existing folder.</p>
3082
- </td>
3083
- <td class="enum_member_annotations"> </td>
1042
+ <td> </td>
1043
+ <td> </td>
3084
1044
  </tr>
3085
1045
  <tr>
3086
1046
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-CREATE-FOLDER:CAPS"></a>GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER</p></td>
3087
- <td class="enum_member_description">
3088
- <p>Indicates a mode for creating a
3089
- new folder. The file chooser will let the user name an existing or
3090
- new folder.</p>
3091
- </td>
3092
- <td class="enum_member_annotations"> </td>
1047
+ <td> </td>
1048
+ <td> </td>
3093
1049
  </tr>
3094
1050
  </tbody>
3095
1051
  </table></div>
@@ -3098,13 +1054,8 @@ or to save to a possibly new file.</p>
3098
1054
  <hr>
3099
1055
  <div class="refsect2">
3100
1056
  <a name="GtkFileChooserConfirmation"></a><h3>enum GtkFileChooserConfirmation</h3>
3101
- <p>Used as a return value of handlers for the
3102
- <a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a> signal of a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>. This
3103
- value determines whether the file chooser will present the stock
3104
- confirmation dialog, accept the user's choice of a filename, or
3105
- let the user choose another filename.</p>
3106
1057
  <div class="refsect3">
3107
- <a name="id-1.4.12.6.13.4.4"></a><h4>Members</h4>
1058
+ <a name="GtkFileChooserConfirmation.members"></a><h4>Members</h4>
3108
1059
  <div class="informaltable"><table width="100%" border="0">
3109
1060
  <colgroup>
3110
1061
  <col width="300px" class="enum_members_name">
@@ -3114,40 +1065,35 @@ let the user choose another filename.</p>
3114
1065
  <tbody>
3115
1066
  <tr>
3116
1067
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-CONFIRMATION-CONFIRM:CAPS"></a>GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM</p></td>
3117
- <td class="enum_member_description">
3118
- <p>The file chooser will present
3119
- its stock dialog to confirm about overwriting an existing file.</p>
3120
- </td>
3121
- <td class="enum_member_annotations"> </td>
1068
+ <td> </td>
1069
+ <td> </td>
3122
1070
  </tr>
3123
1071
  <tr>
3124
1072
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-CONFIRMATION-ACCEPT-FILENAME:CAPS"></a>GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME</p></td>
3125
- <td class="enum_member_description">
3126
- <p>The file chooser will
3127
- terminate and accept the user's choice of a file name.</p>
3128
- </td>
3129
- <td class="enum_member_annotations"> </td>
1073
+ <td> </td>
1074
+ <td> </td>
3130
1075
  </tr>
3131
1076
  <tr>
3132
1077
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-CONFIRMATION-SELECT-AGAIN:CAPS"></a>GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN</p></td>
3133
- <td class="enum_member_description">
3134
- <p>The file chooser will
3135
- continue running, so as to let the user select another file name.</p>
3136
- </td>
3137
- <td class="enum_member_annotations"> </td>
1078
+ <td> </td>
1079
+ <td> </td>
3138
1080
  </tr>
3139
1081
  </tbody>
3140
1082
  </table></div>
3141
1083
  </div>
3142
- <p class="since">Since 2.8</p>
1084
+ <p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
1085
+ </div>
1086
+ <hr>
1087
+ <div class="refsect2">
1088
+ <a name="GTK-FILE-CHOOSER-ERROR:CAPS"></a><h3>GTK_FILE_CHOOSER_ERROR</h3>
1089
+ <pre class="programlisting">#define GTK_FILE_CHOOSER_ERROR (gtk_file_chooser_error_quark ())
1090
+ </pre>
3143
1091
  </div>
3144
1092
  <hr>
3145
1093
  <div class="refsect2">
3146
1094
  <a name="GtkFileChooserError"></a><h3>enum GtkFileChooserError</h3>
3147
- <p>These identify the various errors that can occur while calling
3148
- <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> functions.</p>
3149
1095
  <div class="refsect3">
3150
- <a name="id-1.4.12.6.13.5.4"></a><h4>Members</h4>
1096
+ <a name="GtkFileChooserError.members"></a><h4>Members</h4>
3151
1097
  <div class="informaltable"><table width="100%" border="0">
3152
1098
  <colgroup>
3153
1099
  <col width="300px" class="enum_members_name">
@@ -3157,32 +1103,23 @@ let the user choose another filename.</p>
3157
1103
  <tbody>
3158
1104
  <tr>
3159
1105
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-NONEXISTENT:CAPS"></a>GTK_FILE_CHOOSER_ERROR_NONEXISTENT</p></td>
3160
- <td class="enum_member_description">
3161
- <p>Indicates that a file does not exist.</p>
3162
- </td>
3163
- <td class="enum_member_annotations"> </td>
1106
+ <td> </td>
1107
+ <td> </td>
3164
1108
  </tr>
3165
1109
  <tr>
3166
1110
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-BAD-FILENAME:CAPS"></a>GTK_FILE_CHOOSER_ERROR_BAD_FILENAME</p></td>
3167
- <td class="enum_member_description">
3168
- <p>Indicates a malformed filename.</p>
3169
- </td>
3170
- <td class="enum_member_annotations"> </td>
1111
+ <td> </td>
1112
+ <td> </td>
3171
1113
  </tr>
3172
1114
  <tr>
3173
1115
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-ALREADY-EXISTS:CAPS"></a>GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS</p></td>
3174
- <td class="enum_member_description">
3175
- <p>Indicates a duplicate path (e.g. when
3176
- adding a bookmark).</p>
3177
- </td>
3178
- <td class="enum_member_annotations"> </td>
1116
+ <td> </td>
1117
+ <td> </td>
3179
1118
  </tr>
3180
1119
  <tr>
3181
1120
  <td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-INCOMPLETE-HOSTNAME:CAPS"></a>GTK_FILE_CHOOSER_ERROR_INCOMPLETE_HOSTNAME</p></td>
3182
- <td class="enum_member_description">
3183
- <p>Indicates an incomplete hostname (e.g. "http://foo" without a slash after that).</p>
3184
- </td>
3185
- <td class="enum_member_annotations"> </td>
1121
+ <td> </td>
1122
+ <td> </td>
3186
1123
  </tr>
3187
1124
  </tbody>
3188
1125
  </table></div>
@@ -3193,463 +1130,77 @@ let the user choose another filename.</p>
3193
1130
  <a name="gtk-file-chooser-get-filename"></a><h3>gtk_file_chooser_get_filename</h3>
3194
1131
  <pre class="programlisting">#define gtk_file_chooser_get_filename gtk_file_chooser_get_filename_utf8
3195
1132
  </pre>
3196
- <p>Gets the filename for the currently selected file in
3197
- the file selector. If multiple files are selected,
3198
- one of the filenames will be returned at random.</p>
3199
- <p>If the file chooser is in folder mode, this function returns the selected
3200
- folder.</p>
3201
- <div class="refsect3">
3202
- <a name="id-1.4.12.6.13.6.6"></a><h4>Parameters</h4>
3203
- <div class="informaltable"><table width="100%" border="0">
3204
- <colgroup>
3205
- <col width="150px" class="parameters_name">
3206
- <col class="parameters_description">
3207
- <col width="200px" class="parameters_annotations">
3208
- </colgroup>
3209
- <tbody><tr>
3210
- <td class="parameter_name"><p>chooser</p></td>
3211
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3212
- <td class="parameter_annotations"> </td>
3213
- </tr></tbody>
3214
- </table></div>
3215
- </div>
3216
- <div class="refsect3">
3217
- <a name="id-1.4.12.6.13.6.7"></a><h4>Returns</h4>
3218
- <p> The currently selected filename, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
3219
- if no file is selected, or the selected file can't
3220
- be represented with a local filename. Free with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
3221
- <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p>
3222
- </div>
3223
- <p class="since">Since 2.4</p>
1133
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3224
1134
  </div>
3225
1135
  <hr>
3226
1136
  <div class="refsect2">
3227
1137
  <a name="gtk-file-chooser-set-filename"></a><h3>gtk_file_chooser_set_filename</h3>
3228
1138
  <pre class="programlisting">#define gtk_file_chooser_set_filename gtk_file_chooser_set_filename_utf8
3229
1139
  </pre>
3230
- <p>Sets <em class="parameter"><code>filename</code></em>
3231
- as the current filename for the file chooser, by changing
3232
- to the file's parent folder and actually selecting the file in list. If
3233
- the <em class="parameter"><code>chooser</code></em>
3234
- is in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the file's base name
3235
- will also appear in the dialog's file name entry.</p>
3236
- <p>If the file name isn't in the current folder of <em class="parameter"><code>chooser</code></em>
3237
- , then the current
3238
- folder of <em class="parameter"><code>chooser</code></em>
3239
- will be changed to the folder containing <em class="parameter"><code>filename</code></em>
3240
- . This
3241
- 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
3242
- <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>.</p>
3243
- <p>Note that the file must exist, or nothing will be done except
3244
- for the directory change.</p>
3245
- <p>If you are implementing a <span class="guimenuitem">File/Save As...</span> dialog,
3246
- you should use this function if you already have a file name to which the
3247
- user may save; for example, when the user opens an existing file and then
3248
- does <span class="guimenuitem">File/Save As...</span> on it. If you don't have
3249
- a file name already — for example, if the user just created a new
3250
- file and is saving it for the first time, do not call this function.
3251
- Instead, use something similar to this:</p>
3252
- <div class="informalexample">
3253
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
3254
- <tbody>
3255
- <tr>
3256
- <td class="listing_lines" align="right"><pre>1
3257
- 2
3258
- 3
3259
- 4
3260
- 5
3261
- 6
3262
- 7
3263
- 8
3264
- 9
3265
- 10
3266
- 11</pre></td>
3267
- <td class="listing_code"><pre class="programlisting"><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">document_is_new</span><span class="symbol">)</span>
3268
- <span class="normal"> </span><span class="cbracket">{</span>
3269
- <span class="normal"> </span><span class="comment">/* the user just created a new document */</span>
3270
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-folder">gtk_file_chooser_set_current_folder</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> default_folder_for_saving</span><span class="symbol">);</span>
3271
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-current-name">gtk_file_chooser_set_current_name</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Untitled document"</span><span class="symbol">);</span>
3272
- <span class="normal"> </span><span class="cbracket">}</span>
3273
- <span class="keyword">else</span>
3274
- <span class="normal"> </span><span class="cbracket">{</span>
3275
- <span class="normal"> </span><span class="comment">/* the user edited an existing document */</span><span class="normal"> </span>
3276
- <span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-filename">gtk_file_chooser_set_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> existing_filename</span><span class="symbol">);</span>
3277
- <span class="normal"> </span><span class="cbracket">}</span></pre></td>
3278
- </tr>
3279
- </tbody>
3280
- </table>
3281
- </div>
3282
-
3283
- <p></p>
3284
- <div class="refsect3">
3285
- <a name="id-1.4.12.6.13.7.10"></a><h4>Parameters</h4>
3286
- <div class="informaltable"><table width="100%" border="0">
3287
- <colgroup>
3288
- <col width="150px" class="parameters_name">
3289
- <col class="parameters_description">
3290
- <col width="200px" class="parameters_annotations">
3291
- </colgroup>
3292
- <tbody>
3293
- <tr>
3294
- <td class="parameter_name"><p>chooser</p></td>
3295
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3296
- <td class="parameter_annotations"> </td>
3297
- </tr>
3298
- <tr>
3299
- <td class="parameter_name"><p>filename</p></td>
3300
- <td class="parameter_description"><p> the filename to set as current. </p></td>
3301
- <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
3302
- </tr>
3303
- </tbody>
3304
- </table></div>
3305
- </div>
3306
- <div class="refsect3">
3307
- <a name="id-1.4.12.6.13.7.11"></a><h4>Returns</h4>
3308
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
3309
- selected successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
3310
- <p></p>
3311
- </div>
3312
- <p class="since">Since 2.4</p>
1140
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3313
1141
  </div>
3314
1142
  <hr>
3315
1143
  <div class="refsect2">
3316
1144
  <a name="gtk-file-chooser-select-filename"></a><h3>gtk_file_chooser_select_filename</h3>
3317
1145
  <pre class="programlisting">#define gtk_file_chooser_select_filename gtk_file_chooser_select_filename_utf8
3318
1146
  </pre>
3319
- <p>Selects a filename. If the file name isn't in the current
3320
- folder of <em class="parameter"><code>chooser</code></em>
3321
- , then the current folder of <em class="parameter"><code>chooser</code></em>
3322
- will
3323
- be changed to the folder containing <em class="parameter"><code>filename</code></em>
3324
- .</p>
3325
- <div class="refsect3">
3326
- <a name="id-1.4.12.6.13.8.5"></a><h4>Parameters</h4>
3327
- <div class="informaltable"><table width="100%" border="0">
3328
- <colgroup>
3329
- <col width="150px" class="parameters_name">
3330
- <col class="parameters_description">
3331
- <col width="200px" class="parameters_annotations">
3332
- </colgroup>
3333
- <tbody>
3334
- <tr>
3335
- <td class="parameter_name"><p>chooser</p></td>
3336
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3337
- <td class="parameter_annotations"> </td>
3338
- </tr>
3339
- <tr>
3340
- <td class="parameter_name"><p>filename</p></td>
3341
- <td class="parameter_description"><p> the filename to select. </p></td>
3342
- <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
3343
- </tr>
3344
- </tbody>
3345
- </table></div>
3346
- </div>
3347
- <div class="refsect3">
3348
- <a name="id-1.4.12.6.13.8.6"></a><h4>Returns</h4>
3349
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
3350
- selected successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
3351
- <p></p>
3352
- </div>
3353
- <p class="since">Since 2.4</p>
1147
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3354
1148
  </div>
3355
1149
  <hr>
3356
1150
  <div class="refsect2">
3357
1151
  <a name="gtk-file-chooser-unselect-filename"></a><h3>gtk_file_chooser_unselect_filename</h3>
3358
1152
  <pre class="programlisting">#define gtk_file_chooser_unselect_filename gtk_file_chooser_unselect_filename_utf8
3359
1153
  </pre>
3360
- <p>Unselects a currently selected filename. If the filename
3361
- is not in the current directory, does not exist, or
3362
- is otherwise not currently selected, does nothing.</p>
3363
- <div class="refsect3">
3364
- <a name="id-1.4.12.6.13.9.5"></a><h4>Parameters</h4>
3365
- <div class="informaltable"><table width="100%" border="0">
3366
- <colgroup>
3367
- <col width="150px" class="parameters_name">
3368
- <col class="parameters_description">
3369
- <col width="200px" class="parameters_annotations">
3370
- </colgroup>
3371
- <tbody>
3372
- <tr>
3373
- <td class="parameter_name"><p>chooser</p></td>
3374
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3375
- <td class="parameter_annotations"> </td>
3376
- </tr>
3377
- <tr>
3378
- <td class="parameter_name"><p>filename</p></td>
3379
- <td class="parameter_description"><p> the filename to unselect. </p></td>
3380
- <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
3381
- </tr>
3382
- </tbody>
3383
- </table></div>
3384
- </div>
3385
- <p class="since">Since 2.4</p>
1154
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3386
1155
  </div>
3387
1156
  <hr>
3388
1157
  <div class="refsect2">
3389
1158
  <a name="gtk-file-chooser-get-filenames"></a><h3>gtk_file_chooser_get_filenames</h3>
3390
1159
  <pre class="programlisting">#define gtk_file_chooser_get_filenames gtk_file_chooser_get_filenames_utf8
3391
1160
  </pre>
3392
- <p>Lists all the selected files and subfolders in the current folder of
3393
- <em class="parameter"><code>chooser</code></em>
3394
- . The returned names are full absolute paths. If files in the current
3395
- folder cannot be represented as local filenames they will be ignored. (See
3396
- <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>)</p>
3397
- <div class="refsect3">
3398
- <a name="id-1.4.12.6.13.10.5"></a><h4>Parameters</h4>
3399
- <div class="informaltable"><table width="100%" border="0">
3400
- <colgroup>
3401
- <col width="150px" class="parameters_name">
3402
- <col class="parameters_description">
3403
- <col width="200px" class="parameters_annotations">
3404
- </colgroup>
3405
- <tbody><tr>
3406
- <td class="parameter_name"><p>chooser</p></td>
3407
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3408
- <td class="parameter_annotations"> </td>
3409
- </tr></tbody>
3410
- </table></div>
3411
- </div>
3412
- <div class="refsect3">
3413
- <a name="id-1.4.12.6.13.10.6"></a><h4>Returns</h4>
3414
- <p> a <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
3415
- containing the filenames of all selected files and subfolders in
3416
- the current folder. Free the returned list with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>,
3417
- and the filenames with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
3418
- <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
3419
- </div>
3420
- <p class="since">Since 2.4</p>
1161
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3421
1162
  </div>
3422
1163
  <hr>
3423
1164
  <div class="refsect2">
3424
1165
  <a name="gtk-file-chooser-set-current-folder"></a><h3>gtk_file_chooser_set_current_folder</h3>
3425
1166
  <pre class="programlisting">#define gtk_file_chooser_set_current_folder gtk_file_chooser_set_current_folder_utf8
3426
1167
  </pre>
3427
- <p>Sets the current folder for <em class="parameter"><code>chooser</code></em>
3428
- from a local filename.
3429
- The user will be shown the full contents of the current folder,
3430
- plus user interface elements for navigating to other folders.</p>
3431
- <div class="refsect3">
3432
- <a name="id-1.4.12.6.13.11.5"></a><h4>Parameters</h4>
3433
- <div class="informaltable"><table width="100%" border="0">
3434
- <colgroup>
3435
- <col width="150px" class="parameters_name">
3436
- <col class="parameters_description">
3437
- <col width="200px" class="parameters_annotations">
3438
- </colgroup>
3439
- <tbody>
3440
- <tr>
3441
- <td class="parameter_name"><p>chooser</p></td>
3442
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3443
- <td class="parameter_annotations"> </td>
3444
- </tr>
3445
- <tr>
3446
- <td class="parameter_name"><p>filename</p></td>
3447
- <td class="parameter_description"><p> the full path of the new current folder. </p></td>
3448
- <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
3449
- </tr>
3450
- </tbody>
3451
- </table></div>
3452
- </div>
3453
- <div class="refsect3">
3454
- <a name="id-1.4.12.6.13.11.6"></a><h4>Returns</h4>
3455
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
3456
- otherwise.</p>
3457
- <p></p>
3458
- </div>
3459
- <p class="since">Since 2.4</p>
1168
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3460
1169
  </div>
3461
1170
  <hr>
3462
1171
  <div class="refsect2">
3463
1172
  <a name="gtk-file-chooser-get-current-folder"></a><h3>gtk_file_chooser_get_current_folder</h3>
3464
1173
  <pre class="programlisting">#define gtk_file_chooser_get_current_folder gtk_file_chooser_get_current_folder_utf8
3465
1174
  </pre>
3466
- <p>Gets the current folder of <em class="parameter"><code>chooser</code></em>
3467
- as a local filename.
3468
- 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>.</p>
3469
- <p>Note that this is the folder that the file chooser is currently displaying
3470
- (e.g. "/home/username/Documents"), which is <span class="emphasis"><em>not the same</em></span>
3471
- as the currently-selected folder if the chooser is in
3472
- <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a> mode
3473
- (e.g. "/home/username/Documents/selected-folder/". To get the
3474
- currently-selected folder in that mode, use <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> as the
3475
- usual way to get the selection.</p>
3476
- <div class="refsect3">
3477
- <a name="id-1.4.12.6.13.12.6"></a><h4>Parameters</h4>
3478
- <div class="informaltable"><table width="100%" border="0">
3479
- <colgroup>
3480
- <col width="150px" class="parameters_name">
3481
- <col class="parameters_description">
3482
- <col width="200px" class="parameters_annotations">
3483
- </colgroup>
3484
- <tbody><tr>
3485
- <td class="parameter_name"><p>chooser</p></td>
3486
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3487
- <td class="parameter_annotations"> </td>
3488
- </tr></tbody>
3489
- </table></div>
3490
- </div>
3491
- <div class="refsect3">
3492
- <a name="id-1.4.12.6.13.12.7"></a><h4>Returns</h4>
3493
- <p> the full path of the current folder,
3494
- or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the current path cannot be represented as a local
3495
- filename. Free with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. This function will also return
3496
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the last folder that
3497
- was requested from it; for example, as would be for calling
3498
- <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. </p>
3499
- <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p>
3500
- </div>
3501
- <p class="since">Since 2.4</p>
1175
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3502
1176
  </div>
3503
1177
  <hr>
3504
1178
  <div class="refsect2">
3505
1179
  <a name="gtk-file-chooser-get-preview-filename"></a><h3>gtk_file_chooser_get_preview_filename</h3>
3506
1180
  <pre class="programlisting">#define gtk_file_chooser_get_preview_filename gtk_file_chooser_get_preview_filename_utf8
3507
1181
  </pre>
3508
- <p>Gets the filename that should be previewed in a custom preview
3509
- 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>.</p>
3510
- <div class="refsect3">
3511
- <a name="id-1.4.12.6.13.13.5"></a><h4>Parameters</h4>
3512
- <div class="informaltable"><table width="100%" border="0">
3513
- <colgroup>
3514
- <col width="150px" class="parameters_name">
3515
- <col class="parameters_description">
3516
- <col width="200px" class="parameters_annotations">
3517
- </colgroup>
3518
- <tbody><tr>
3519
- <td class="parameter_name"><p>chooser</p></td>
3520
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3521
- <td class="parameter_annotations"> </td>
3522
- </tr></tbody>
3523
- </table></div>
3524
- </div>
3525
- <div class="refsect3">
3526
- <a name="id-1.4.12.6.13.13.6"></a><h4>Returns</h4>
3527
- <p> the filename to preview, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
3528
- no file is selected, or if the selected file cannot be represented
3529
- as a local filename. Free with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
3530
- <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p>
3531
- </div>
3532
- <p class="since">Since 2.4</p>
1182
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3533
1183
  </div>
3534
1184
  <hr>
3535
1185
  <div class="refsect2">
3536
1186
  <a name="gtk-file-chooser-add-shortcut-folder"></a><h3>gtk_file_chooser_add_shortcut_folder</h3>
3537
1187
  <pre class="programlisting">#define gtk_file_chooser_add_shortcut_folder gtk_file_chooser_add_shortcut_folder_utf8
3538
1188
  </pre>
3539
- <p>Adds a folder to be displayed with the shortcut folders in a file chooser.
3540
- Note that shortcut folders do not get saved, as they are provided by the
3541
- application. For example, you can use this to add a
3542
- "/usr/share/mydrawprogram/Clipart" folder to the volume list.</p>
3543
- <div class="refsect3">
3544
- <a name="id-1.4.12.6.13.14.5"></a><h4>Parameters</h4>
3545
- <div class="informaltable"><table width="100%" border="0">
3546
- <colgroup>
3547
- <col width="150px" class="parameters_name">
3548
- <col class="parameters_description">
3549
- <col width="200px" class="parameters_annotations">
3550
- </colgroup>
3551
- <tbody>
3552
- <tr>
3553
- <td class="parameter_name"><p>chooser</p></td>
3554
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3555
- <td class="parameter_annotations"> </td>
3556
- </tr>
3557
- <tr>
3558
- <td class="parameter_name"><p>folder</p></td>
3559
- <td class="parameter_description"><p> filename of the folder to add. </p></td>
3560
- <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
3561
- </tr>
3562
- <tr>
3563
- <td class="parameter_name"><p>error</p></td>
3564
- <td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
3565
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
3566
- </tr>
3567
- </tbody>
3568
- </table></div>
3569
- </div>
3570
- <div class="refsect3">
3571
- <a name="id-1.4.12.6.13.14.6"></a><h4>Returns</h4>
3572
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
3573
- otherwise. In the latter case, the <em class="parameter"><code>error</code></em>
3574
- will be set as appropriate.</p>
3575
- <p></p>
3576
- </div>
3577
- <p class="since">Since 2.4</p>
1189
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3578
1190
  </div>
3579
1191
  <hr>
3580
1192
  <div class="refsect2">
3581
1193
  <a name="gtk-file-chooser-remove-shortcut-folder"></a><h3>gtk_file_chooser_remove_shortcut_folder</h3>
3582
1194
  <pre class="programlisting">#define gtk_file_chooser_remove_shortcut_folder gtk_file_chooser_remove_shortcut_folder_utf8
3583
1195
  </pre>
3584
- <p>Removes a folder from a file chooser's list of shortcut folders.</p>
3585
- <div class="refsect3">
3586
- <a name="id-1.4.12.6.13.15.5"></a><h4>Parameters</h4>
3587
- <div class="informaltable"><table width="100%" border="0">
3588
- <colgroup>
3589
- <col width="150px" class="parameters_name">
3590
- <col class="parameters_description">
3591
- <col width="200px" class="parameters_annotations">
3592
- </colgroup>
3593
- <tbody>
3594
- <tr>
3595
- <td class="parameter_name"><p>chooser</p></td>
3596
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3597
- <td class="parameter_annotations"> </td>
3598
- </tr>
3599
- <tr>
3600
- <td class="parameter_name"><p>folder</p></td>
3601
- <td class="parameter_description"><p> filename of the folder to remove. </p></td>
3602
- <td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></td>
3603
- </tr>
3604
- <tr>
3605
- <td class="parameter_name"><p>error</p></td>
3606
- <td class="parameter_description"><p> location to store error, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
3607
- <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
3608
- </tr>
3609
- </tbody>
3610
- </table></div>
3611
- </div>
3612
- <div class="refsect3">
3613
- <a name="id-1.4.12.6.13.15.6"></a><h4>Returns</h4>
3614
- <p> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
3615
- In the latter case, the <em class="parameter"><code>error</code></em>
3616
- will be set as appropriate.</p>
3617
- <p>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></p>
3618
- <p></p>
3619
- </div>
3620
- <p class="since">Since 2.4</p>
1196
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3621
1197
  </div>
3622
1198
  <hr>
3623
1199
  <div class="refsect2">
3624
1200
  <a name="gtk-file-chooser-list-shortcut-folders"></a><h3>gtk_file_chooser_list_shortcut_folders</h3>
3625
1201
  <pre class="programlisting">#define gtk_file_chooser_list_shortcut_folders gtk_file_chooser_list_shortcut_folders_utf8
3626
1202
  </pre>
3627
- <p>Queries the list of shortcut folders in the file chooser, as set by
3628
- <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>.</p>
3629
- <div class="refsect3">
3630
- <a name="id-1.4.12.6.13.16.5"></a><h4>Parameters</h4>
3631
- <div class="informaltable"><table width="100%" border="0">
3632
- <colgroup>
3633
- <col width="150px" class="parameters_name">
3634
- <col class="parameters_description">
3635
- <col width="200px" class="parameters_annotations">
3636
- </colgroup>
3637
- <tbody><tr>
3638
- <td class="parameter_name"><p>chooser</p></td>
3639
- <td class="parameter_description"><p>a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a></p></td>
3640
- <td class="parameter_annotations"> </td>
3641
- </tr></tbody>
3642
- </table></div>
3643
- </div>
3644
- <div class="refsect3">
3645
- <a name="id-1.4.12.6.13.16.6"></a><h4>Returns</h4>
3646
- <p> A list of
3647
- folder filenames, or <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut folders. Free
3648
- the returned list with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with
3649
- <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
3650
- <p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
3651
- </div>
3652
- <p class="since">Since 2.4</p>
1203
+ <p class="since">Since: <a class="link" href="api-index-2-4.html#api-index-2.4">2.4</a></p>
3653
1204
  </div>
3654
1205
  </div>
3655
1206
  <div class="refsect1">
@@ -3665,22 +1216,19 @@ the returned list with <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/loc
3665
1216
  <div class="refsect2">
3666
1217
  <a name="GtkFileChooser--create-folders"></a><h3>The <code class="literal">“create-folders”</code> property</h3>
3667
1218
  <pre class="programlisting"> “create-folders” <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
3668
- <p>Whether a file chooser not in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a> mode
3669
- will offer the user to create new folders.</p>
1219
+ <p>Whether a file chooser not in open mode will offer the user to create new folders.</p>
3670
1220
  <p>Flags: Read / Write</p>
3671
1221
  <p>Default value: TRUE</p>
3672
- <p class="since">Since 2.18</p>
1222
+ <p class="since">Since: <a class="link" href="api-index-2-18.html#api-index-2.18">2.18</a></p>
3673
1223
  </div>
3674
1224
  <hr>
3675
1225
  <div class="refsect2">
3676
1226
  <a name="GtkFileChooser--do-overwrite-confirmation"></a><h3>The <code class="literal">“do-overwrite-confirmation”</code> property</h3>
3677
1227
  <pre class="programlisting"> “do-overwrite-confirmation” <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
3678
- <p>Whether a file chooser in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode
3679
- will present an overwrite confirmation dialog if the user
3680
- selects a file name that already exists.</p>
1228
+ <p>Whether a file chooser in save mode will present an overwrite confirmation dialog if necessary.</p>
3681
1229
  <p>Flags: Read / Write</p>
3682
1230
  <p>Default value: FALSE</p>
3683
- <p class="since">Since 2.8</p>
1231
+ <p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
3684
1232
  </div>
3685
1233
  <hr>
3686
1234
  <div class="refsect2">
@@ -3759,128 +1307,8 @@ selects a file name that already exists.</p>
3759
1307
  <pre class="programlisting"><a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="returnvalue">GtkFileChooserConfirmation</span></a>
3760
1308
  user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3761
1309
  <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3762
- <p>This signal gets emitted whenever it is appropriate to present a
3763
- confirmation dialog when the user has selected a file name that
3764
- already exists. The signal only gets emitted when the file
3765
- chooser is in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode.</p>
3766
- <p>Most applications just need to turn on the
3767
- <a class="link" href="GtkFileChooser.html#GtkFileChooser--do-overwrite-confirmation" title="The “do-overwrite-confirmation” property"><span class="type">“do-overwrite-confirmation”</span></a> property (or call the
3768
- <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-do-overwrite-confirmation" title="gtk_file_chooser_set_do_overwrite_confirmation ()"><code class="function">gtk_file_chooser_set_do_overwrite_confirmation()</code></a> function), and
3769
- they will automatically get a stock confirmation dialog.
3770
- Applications which need to customize this behavior should do
3771
- that, and also connect to the <a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a>
3772
- signal.</p>
3773
- <p>A signal handler for this signal must return a
3774
- <a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value, which indicates the action to
3775
- take. If the handler determines that the user wants to select a
3776
- different filename, it should return
3777
- <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-SELECT-AGAIN:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN</code></a>. If it determines
3778
- that the user is satisfied with his choice of file name, it
3779
- should return <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-ACCEPT-FILENAME:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME</code></a>.
3780
- On the other hand, if it determines that the stock confirmation
3781
- dialog should be used, it should return
3782
- <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-CONFIRM:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM</code></a>. The following example
3783
- illustrates this.</p>
3784
- <div class="example">
3785
- <a name="gtkfilechooser-confirmation"></a><p class="title"><b>Example 43. Custom confirmation</b></p>
3786
- <div class="example-contents">
3787
- <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
3788
- <tbody>
3789
- <tr>
3790
- <td class="listing_lines" align="right"><pre>1
3791
- 2
3792
- 3
3793
- 4
3794
- 5
3795
- 6
3796
- 7
3797
- 8
3798
- 9
3799
- 10
3800
- 11
3801
- 12
3802
- 13
3803
- 14
3804
- 15
3805
- 16
3806
- 17
3807
- 18
3808
- 19
3809
- 20
3810
- 21
3811
- 22
3812
- 23
3813
- 24
3814
- 25
3815
- 26
3816
- 27
3817
- 28
3818
- 29</pre></td>
3819
- <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="GtkFileChooser.html#GtkFileChooserConfirmation">GtkFileChooserConfirmation</a></span>
3820
- <span class="function">confirm_overwrite_callback</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkFileChooser</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
3821
- <span class="cbracket">{</span>
3822
- <span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">uri</span><span class="symbol">;</span>
3823
-
3824
- <span class="normal"> uri </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-get-uri">gtk_file_chooser_get_uri</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">);</span>
3825
-
3826
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function">is_uri_read_only</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">uri</span><span class="symbol">))</span>
3827
- <span class="normal"> </span><span class="cbracket">{</span>
3828
- <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function">user_wants_to_replace_read_only_file</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">uri</span><span class="symbol">))</span>
3829
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-ACCEPT-FILENAME:CAPS">GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME</a></span><span class="symbol">;</span>
3830
- <span class="normal"> </span><span class="keyword">else</span>
3831
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-SELECT-AGAIN:CAPS">GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN</a></span><span class="symbol">;</span>
3832
- <span class="normal"> </span><span class="cbracket">}</span><span class="normal"> </span><span class="keyword">else</span>
3833
- <span class="normal"> </span><span class="keyword">return</span><span class="normal"> <a href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-CONFIRM:CAPS">GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM</a></span><span class="symbol">;</span><span class="normal"> </span><span class="comment">// fall back to the default dialog</span>
3834
- <span class="cbracket">}</span>
3835
-
3836
- <span class="symbol">...</span>
3837
-
3838
- <span class="normal">chooser </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileChooserDialog.html#gtk-file-chooser-dialog-new">gtk_file_chooser_dialog_new</a></span><span class="normal"> </span><span class="symbol">(...);</span>
3839
-
3840
- <span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-do-overwrite-confirmation">gtk_file_chooser_set_do_overwrite_confirmation</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_CHOOSER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">),</span><span class="normal"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
3841
- <span class="function"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"confirm-overwrite"</span><span class="symbol">,</span>
3842
- <span class="normal"> </span><span class="function"><a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">confirm_overwrite_callback</span><span class="symbol">),</span><span class="normal"> <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
3843
-
3844
- <span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkDialog.html#gtk-dialog-run">gtk_dialog_run</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">==</span><span class="normal"> <a href="GtkDialog.html#GTK-RESPONSE-ACCEPT:CAPS">GTK_RESPONSE_ACCEPT</a></span><span class="symbol">)</span>
3845
- <span class="normal"> </span><span class="function">save_to_file</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-get-filename">gtk_file_chooser_get_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_CHOOSER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">));</span>
3846
-
3847
- <span class="function"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">);</span></pre></td>
3848
- </tr>
3849
- </tbody>
3850
- </table>
3851
- </div>
3852
-
3853
- </div>
3854
- <br class="example-break"><div class="refsect3">
3855
- <a name="id-1.4.12.6.15.2.8"></a><h4>Parameters</h4>
3856
- <div class="informaltable"><table width="100%" border="0">
3857
- <colgroup>
3858
- <col width="150px" class="parameters_name">
3859
- <col class="parameters_description">
3860
- <col width="200px" class="parameters_annotations">
3861
- </colgroup>
3862
- <tbody>
3863
- <tr>
3864
- <td class="parameter_name"><p>chooser</p></td>
3865
- <td class="parameter_description"><p>the object which received the signal.</p></td>
3866
- <td class="parameter_annotations"> </td>
3867
- </tr>
3868
- <tr>
3869
- <td class="parameter_name"><p>user_data</p></td>
3870
- <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3871
- <td class="parameter_annotations"> </td>
3872
- </tr>
3873
- </tbody>
3874
- </table></div>
3875
- </div>
3876
- <div class="refsect3">
3877
- <a name="id-1.4.12.6.15.2.9"></a><h4>Returns</h4>
3878
- <p> a <a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value that indicates which
3879
- action to take after emitting the signal.</p>
3880
- <p></p>
3881
- </div>
3882
1310
  <p>Flags: <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3883
- <p class="since">Since 2.8</p>
1311
+ <p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
3884
1312
  </div>
3885
1313
  <hr>
3886
1314
  <div class="refsect2">
@@ -3888,39 +1316,6 @@ action to take after emitting the signal.</p>
3888
1316
  <pre class="programlisting"><span class="returnvalue">void</span>
3889
1317
  user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3890
1318
  <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3891
- <p>This signal is emitted when the current folder in a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>
3892
- changes. This can happen due to the user performing some action that
3893
- changes folders, such as selecting a bookmark or visiting a folder on the
3894
- file list. It can also happen as a result of calling a function to
3895
- explicitly change the current folder in a file chooser.</p>
3896
- <p>Normally you do not need to connect to this signal, unless you need to keep
3897
- track of which folder a file chooser is showing.</p>
3898
- <p>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>,
3899
- <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>,
3900
- <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>,
3901
- <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>.</p>
3902
- <div class="refsect3">
3903
- <a name="id-1.4.12.6.15.3.7"></a><h4>Parameters</h4>
3904
- <div class="informaltable"><table width="100%" border="0">
3905
- <colgroup>
3906
- <col width="150px" class="parameters_name">
3907
- <col class="parameters_description">
3908
- <col width="200px" class="parameters_annotations">
3909
- </colgroup>
3910
- <tbody>
3911
- <tr>
3912
- <td class="parameter_name"><p>chooser</p></td>
3913
- <td class="parameter_description"><p>the object which received the signal.</p></td>
3914
- <td class="parameter_annotations"> </td>
3915
- </tr>
3916
- <tr>
3917
- <td class="parameter_name"><p>user_data</p></td>
3918
- <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3919
- <td class="parameter_annotations"> </td>
3920
- </tr>
3921
- </tbody>
3922
- </table></div>
3923
- </div>
3924
1319
  <p>Flags: <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3925
1320
  </div>
3926
1321
  <hr>
@@ -3929,37 +1324,6 @@ track of which folder a file chooser is showing.</p>
3929
1324
  <pre class="programlisting"><span class="returnvalue">void</span>
3930
1325
  user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3931
1326
  <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3932
- <p>This signal is emitted when the user "activates" a file in the file
3933
- chooser. This can happen by double-clicking on a file in the file list, or
3934
- by pressing <span class="keycap"><strong>Enter</strong></span>.</p>
3935
- <p>Normally you do not need to connect to this signal. It is used internally
3936
- by <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog"><span class="type">GtkFileChooserDialog</span></a> to know when to activate the default button in the
3937
- dialog.</p>
3938
- <p>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>,
3939
- <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>,
3940
- <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>.</p>
3941
- <div class="refsect3">
3942
- <a name="id-1.4.12.6.15.4.7"></a><h4>Parameters</h4>
3943
- <div class="informaltable"><table width="100%" border="0">
3944
- <colgroup>
3945
- <col width="150px" class="parameters_name">
3946
- <col class="parameters_description">
3947
- <col width="200px" class="parameters_annotations">
3948
- </colgroup>
3949
- <tbody>
3950
- <tr>
3951
- <td class="parameter_name"><p>chooser</p></td>
3952
- <td class="parameter_description"><p>the object which received the signal.</p></td>
3953
- <td class="parameter_annotations"> </td>
3954
- </tr>
3955
- <tr>
3956
- <td class="parameter_name"><p>user_data</p></td>
3957
- <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
3958
- <td class="parameter_annotations"> </td>
3959
- </tr>
3960
- </tbody>
3961
- </table></div>
3962
- </div>
3963
1327
  <p>Flags: <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
3964
1328
  </div>
3965
1329
  <hr>
@@ -3968,40 +1332,6 @@ dialog.</p>
3968
1332
  <pre class="programlisting"><span class="returnvalue">void</span>
3969
1333
  user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3970
1334
  <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
3971
- <p>This signal is emitted when there is a change in the set of selected files
3972
- 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
3973
- with the mouse or the keyboard, or when explicitly calling functions to
3974
- change the selection.</p>
3975
- <p>Normally you do not need to connect to this signal, as it is easier to wait
3976
- for the file chooser to finish running, and then to get the list of
3977
- selected files using the functions mentioned below.</p>
3978
- <p>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>,
3979
- <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>,
3980
- <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>,
3981
- <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>,
3982
- <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>.</p>
3983
- <div class="refsect3">
3984
- <a name="id-1.4.12.6.15.5.7"></a><h4>Parameters</h4>
3985
- <div class="informaltable"><table width="100%" border="0">
3986
- <colgroup>
3987
- <col width="150px" class="parameters_name">
3988
- <col class="parameters_description">
3989
- <col width="200px" class="parameters_annotations">
3990
- </colgroup>
3991
- <tbody>
3992
- <tr>
3993
- <td class="parameter_name"><p>chooser</p></td>
3994
- <td class="parameter_description"><p>the object which received the signal.</p></td>
3995
- <td class="parameter_annotations"> </td>
3996
- </tr>
3997
- <tr>
3998
- <td class="parameter_name"><p>user_data</p></td>
3999
- <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
4000
- <td class="parameter_annotations"> </td>
4001
- </tr>
4002
- </tbody>
4003
- </table></div>
4004
- </div>
4005
1335
  <p>Flags: <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
4006
1336
  </div>
4007
1337
  <hr>
@@ -4010,56 +1340,11 @@ selected files using the functions mentioned below.</p>
4010
1340
  <pre class="programlisting"><span class="returnvalue">void</span>
4011
1341
  user_function (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
4012
1342
  <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
4013
- <p>This signal is emitted when the preview in a file chooser should be
4014
- regenerated. For example, this can happen when the currently selected file
4015
- changes. You should use this signal if you want your file chooser to have
4016
- a preview widget.</p>
4017
- <p>Once you have installed a preview widget with
4018
- <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
4019
- signal is emitted. You can use the functions
4020
- <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
4021
- <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.
4022
- Your widget may not be able to preview all kinds of files; your callback
4023
- 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
4024
- chooser about whether the preview was generated successfully or not.</p>
4025
- <p>Please see the example code in <a class="xref" href="GtkFileChooser.html#gtkfilechooser-preview" title="Adding a Preview Widget">the section called “Adding a Preview Widget”</a>.</p>
4026
- <p>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>,
4027
- <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>,
4028
- <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>,
4029
- <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>,
4030
- <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>.</p>
4031
- <div class="refsect3">
4032
- <a name="id-1.4.12.6.15.6.8"></a><h4>Parameters</h4>
4033
- <div class="informaltable"><table width="100%" border="0">
4034
- <colgroup>
4035
- <col width="150px" class="parameters_name">
4036
- <col class="parameters_description">
4037
- <col width="200px" class="parameters_annotations">
4038
- </colgroup>
4039
- <tbody>
4040
- <tr>
4041
- <td class="parameter_name"><p>chooser</p></td>
4042
- <td class="parameter_description"><p>the object which received the signal.</p></td>
4043
- <td class="parameter_annotations"> </td>
4044
- </tr>
4045
- <tr>
4046
- <td class="parameter_name"><p>user_data</p></td>
4047
- <td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
4048
- <td class="parameter_annotations"> </td>
4049
- </tr>
4050
- </tbody>
4051
- </table></div>
4052
- </div>
4053
1343
  <p>Flags: <a href="/home/vagrant/ruby-gnome2.win64/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
4054
1344
  </div>
4055
1345
  </div>
4056
- <div class="refsect1">
4057
- <a name="GtkFileChooser.see-also"></a><h2>See Also</h2>
4058
- <p><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></p>
4059
- </div>
4060
1346
  </div>
4061
1347
  <div class="footer">
4062
- <hr>
4063
- Generated by GTK-Doc V1.21.1</div>
1348
+ <hr>Generated by GTK-Doc V1.24.1</div>
4064
1349
  </body>
4065
1350
  </html>