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

Sign up to get free protection for your applications and to get access to all the features.
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
data/vendor/local/share/gtk-doc/html/gtk2/GtkFileChooser.html CHANGED
@@ -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>