gdk3 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (939) hide show
  1. checksums.yaml +7 -0
  2. data/Rakefile +6 -2
  3. data/ext/gdk3/extconf.rb +4 -1
  4. data/ext/gdk3/gdk3.def +2 -2
  5. data/ext/gdk3/rbgdk.c +5 -51
  6. data/ext/gdk3/rbgdk3.h +6 -4
  7. data/ext/gdk3/rbgdk3conversions.h +5 -2
  8. data/ext/gdk3/rbgdk3private.h +1 -6
  9. data/ext/gdk3/rbgdkcairo.c +0 -4
  10. data/ext/gdk3/rbgdkdevice.c +60 -4
  11. data/ext/gdk3/rbgdkdevicemanager.c +39 -0
  12. data/ext/gdk3/rbgdkdisplay.c +8 -63
  13. data/ext/gdk3/rbgdkevent.c +644 -396
  14. data/ext/gdk3/rbgdkwindow.c +29 -32
  15. data/lib/1.9/gdk3.so +0 -0
  16. data/lib/2.0/gdk3.so +0 -0
  17. data/lib/gdk3/deprecated.rb +13 -1
  18. data/test/test-gdk-event.rb +598 -0
  19. data/test/test-gdk-rgba.rb +2 -2
  20. data/vendor/local/bin/gtk-launch.exe +0 -0
  21. data/vendor/local/bin/gtk-query-immodules-3.0.exe +0 -0
  22. data/vendor/local/bin/gtk-update-icon-cache.exe +0 -0
  23. data/vendor/local/bin/gtk3-demo-application.exe +0 -0
  24. data/vendor/local/bin/gtk3-demo.exe +0 -0
  25. data/vendor/local/bin/gtk3-widget-factory.exe +0 -0
  26. data/vendor/local/bin/libgailutil-3-0.dll +0 -0
  27. data/vendor/local/bin/libgdk-3-0.dll +0 -0
  28. data/vendor/local/bin/libgtk-3-0.dll +0 -0
  29. data/vendor/local/include/gtk-3.0/gdk/gdkapplaunchcontext.h +6 -0
  30. data/vendor/local/include/gtk-3.0/gdk/gdkcairo.h +13 -0
  31. data/vendor/local/include/gtk-3.0/gdk/gdkcolor.h +8 -0
  32. data/vendor/local/include/gtk-3.0/gdk/gdkcursor.h +17 -0
  33. data/vendor/local/include/gtk-3.0/gdk/gdkdevice.h +40 -0
  34. data/vendor/local/include/gtk-3.0/gdk/gdkdevicemanager.h +4 -0
  35. data/vendor/local/include/gtk-3.0/gdk/gdkdisplay.h +35 -0
  36. data/vendor/local/include/gtk-3.0/gdk/gdkdisplaymanager.h +6 -0
  37. data/vendor/local/include/gtk-3.0/gdk/gdkdnd.h +22 -1
  38. data/vendor/local/include/gtk-3.0/gdk/gdkenumtypes.h +38 -37
  39. data/vendor/local/include/gtk-3.0/gdk/gdkevents.h +50 -9
  40. data/vendor/local/include/gtk-3.0/gdk/gdkframeclock.h +1 -0
  41. data/vendor/local/include/gtk-3.0/gdk/gdkkeys.h +22 -1
  42. data/vendor/local/include/gtk-3.0/gdk/gdkkeysyms-compat.h +1 -0
  43. data/vendor/local/include/gtk-3.0/gdk/gdkkeysyms.h +1 -0
  44. data/vendor/local/include/gtk-3.0/gdk/gdkmain.h +25 -9
  45. data/vendor/local/include/gtk-3.0/gdk/gdkpango.h +5 -0
  46. data/vendor/local/include/gtk-3.0/gdk/gdkpixbuf.h +4 -1
  47. data/vendor/local/include/gtk-3.0/gdk/gdkprivate.h +4 -0
  48. data/vendor/local/include/gtk-3.0/gdk/gdkproperty.h +9 -0
  49. data/vendor/local/include/gtk-3.0/gdk/gdkrectangle.h +4 -0
  50. data/vendor/local/include/gtk-3.0/gdk/gdkrgba.h +8 -0
  51. data/vendor/local/include/gtk-3.0/gdk/gdkscreen.h +33 -0
  52. data/vendor/local/include/gtk-3.0/gdk/gdkselection.h +9 -0
  53. data/vendor/local/include/gtk-3.0/gdk/gdktestutils.h +3 -0
  54. data/vendor/local/include/gtk-3.0/gdk/gdkthreads.h +8 -1
  55. data/vendor/local/include/gtk-3.0/gdk/gdktypes.h +2 -2
  56. data/vendor/local/include/gtk-3.0/gdk/gdkversionmacros.h +53 -23
  57. data/vendor/local/include/gtk-3.0/gdk/gdkvisual.h +21 -0
  58. data/vendor/local/include/gtk-3.0/gdk/gdkwin32.h +1 -65
  59. data/vendor/local/include/gtk-3.0/gdk/gdkwindow.h +182 -0
  60. data/vendor/local/include/gtk-3.0/gdk/win32/gdkwin32cursor.h +1 -0
  61. data/vendor/local/include/gtk-3.0/gdk/win32/gdkwin32display.h +1 -0
  62. data/vendor/local/include/gtk-3.0/gdk/win32/gdkwin32displaymanager.h +1 -0
  63. data/vendor/local/include/gtk-3.0/gdk/win32/gdkwin32dnd.h +1 -0
  64. data/vendor/local/include/gtk-3.0/gdk/win32/gdkwin32keys.h +1 -0
  65. data/vendor/local/include/gtk-3.0/gdk/win32/gdkwin32misc.h +113 -0
  66. data/vendor/local/include/gtk-3.0/gdk/win32/gdkwin32screen.h +1 -0
  67. data/vendor/local/include/gtk-3.0/gdk/win32/gdkwin32window.h +1 -0
  68. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkarrowaccessible.h +1 -0
  69. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkbooleancellaccessible.h +1 -0
  70. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkbuttonaccessible.h +1 -0
  71. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkcellaccessible.h +1 -0
  72. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkcellaccessibleparent.h +9 -0
  73. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkcheckmenuitemaccessible.h +1 -0
  74. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkcomboboxaccessible.h +1 -0
  75. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkcontaineraccessible.h +1 -0
  76. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkcontainercellaccessible.h +5 -0
  77. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkentryaccessible.h +4 -0
  78. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkexpanderaccessible.h +1 -0
  79. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkframeaccessible.h +1 -0
  80. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkiconviewaccessible.h +1 -0
  81. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkimageaccessible.h +1 -0
  82. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkimagecellaccessible.h +1 -0
  83. data/vendor/local/include/gtk-3.0/gtk/a11y/gtklabelaccessible.h +1 -0
  84. data/vendor/local/include/gtk-3.0/gtk/a11y/gtklevelbaraccessible.h +1 -0
  85. data/vendor/local/include/gtk-3.0/gtk/a11y/gtklinkbuttonaccessible.h +1 -0
  86. data/vendor/local/include/gtk-3.0/gtk/a11y/gtklistboxaccessible.h +58 -0
  87. data/vendor/local/include/gtk-3.0/gtk/a11y/gtklistboxrowaccessible.h +55 -0
  88. data/vendor/local/include/gtk-3.0/gtk/a11y/gtklockbuttonaccessible.h +1 -0
  89. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkmenuaccessible.h +1 -0
  90. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkmenuitemaccessible.h +1 -0
  91. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkmenushellaccessible.h +1 -0
  92. data/vendor/local/include/gtk-3.0/gtk/a11y/gtknotebookaccessible.h +1 -0
  93. data/vendor/local/include/gtk-3.0/gtk/a11y/gtknotebookpageaccessible.h +3 -0
  94. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkpanedaccessible.h +1 -0
  95. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkprogressbaraccessible.h +1 -0
  96. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkradiobuttonaccessible.h +1 -0
  97. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkradiomenuitemaccessible.h +1 -0
  98. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkrangeaccessible.h +1 -0
  99. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkrenderercellaccessible.h +2 -0
  100. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkscaleaccessible.h +1 -0
  101. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkscalebuttonaccessible.h +1 -0
  102. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkscrolledwindowaccessible.h +1 -0
  103. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkspinbuttonaccessible.h +1 -0
  104. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkspinneraccessible.h +1 -0
  105. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkstatusbaraccessible.h +1 -0
  106. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkswitchaccessible.h +1 -0
  107. data/vendor/local/include/gtk-3.0/gtk/a11y/gtktextcellaccessible.h +1 -0
  108. data/vendor/local/include/gtk-3.0/gtk/a11y/gtktextviewaccessible.h +1 -0
  109. data/vendor/local/include/gtk-3.0/gtk/a11y/gtktogglebuttonaccessible.h +1 -0
  110. data/vendor/local/include/gtk-3.0/gtk/a11y/gtktoplevelaccessible.h +2 -0
  111. data/vendor/local/include/gtk-3.0/gtk/a11y/gtktreeviewaccessible.h +1 -0
  112. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkwidgetaccessible.h +1 -0
  113. data/vendor/local/include/gtk-3.0/gtk/a11y/gtkwindowaccessible.h +1 -0
  114. data/vendor/local/include/gtk-3.0/gtk/{gtkaction.h → deprecated/gtkaction.h} +43 -1
  115. data/vendor/local/include/gtk-3.0/gtk/{gtkactiongroup.h → deprecated/gtkactiongroup.h} +31 -4
  116. data/vendor/local/include/gtk-3.0/gtk/{gtkactivatable.h → deprecated/gtkactivatable.h} +10 -1
  117. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkcolorsel.h +2 -0
  118. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkcolorseldialog.h +1 -0
  119. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkfontsel.h +2 -1
  120. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkgradient.h +1 -0
  121. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkhandlebox.h +1 -0
  122. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkhbbox.h +1 -0
  123. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkhbox.h +1 -0
  124. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkhpaned.h +1 -0
  125. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkhscale.h +1 -0
  126. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkhscrollbar.h +1 -0
  127. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkhseparator.h +1 -0
  128. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkhsv.h +1 -0
  129. data/vendor/local/include/gtk-3.0/gtk/{gtkiconfactory.h → deprecated/gtkiconfactory.h} +43 -0
  130. data/vendor/local/include/gtk-3.0/gtk/{gtkimagemenuitem.h → deprecated/gtkimagemenuitem.h} +12 -1
  131. data/vendor/local/include/gtk-3.0/gtk/{gtkradioaction.h → deprecated/gtkradioaction.h} +8 -1
  132. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkrc.h +1 -0
  133. data/vendor/local/include/gtk-3.0/gtk/{gtkrecentaction.h → deprecated/gtkrecentaction.h} +6 -1
  134. data/vendor/local/include/gtk-3.0/gtk/{gtkstock.h → deprecated/gtkstock.h} +333 -106
  135. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkstyle.h +20 -0
  136. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtksymboliccolor.h +1 -0
  137. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtktable.h +1 -0
  138. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtktearoffmenuitem.h +1 -0
  139. data/vendor/local/include/gtk-3.0/gtk/{gtktoggleaction.h → deprecated/gtktoggleaction.h} +8 -1
  140. data/vendor/local/include/gtk-3.0/gtk/{gtkuimanager.h → deprecated/gtkuimanager.h} +21 -2
  141. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkvbbox.h +1 -0
  142. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkvbox.h +1 -0
  143. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkvpaned.h +1 -0
  144. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkvscale.h +1 -0
  145. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkvscrollbar.h +1 -0
  146. data/vendor/local/include/gtk-3.0/gtk/deprecated/gtkvseparator.h +1 -0
  147. data/vendor/local/include/gtk-3.0/gtk/gtk-a11y.h +2 -0
  148. data/vendor/local/include/gtk-3.0/gtk/gtk.h +17 -10
  149. data/vendor/local/include/gtk-3.0/gtk/gtkaboutdialog.h +33 -0
  150. data/vendor/local/include/gtk-3.0/gtk/gtkaccelgroup.h +22 -0
  151. data/vendor/local/include/gtk-3.0/gtk/gtkaccellabel.h +7 -0
  152. data/vendor/local/include/gtk-3.0/gtk/gtkaccelmap.h +15 -0
  153. data/vendor/local/include/gtk-3.0/gtk/gtkaccessible.h +3 -0
  154. data/vendor/local/include/gtk-3.0/gtk/gtkadjustment.h +18 -0
  155. data/vendor/local/include/gtk-3.0/gtk/gtkalignment.h +5 -0
  156. data/vendor/local/include/gtk-3.0/gtk/gtkappchooser.h +5 -0
  157. data/vendor/local/include/gtk-3.0/gtk/gtkappchooserbutton.h +9 -0
  158. data/vendor/local/include/gtk-3.0/gtk/gtkappchooserdialog.h +6 -0
  159. data/vendor/local/include/gtk-3.0/gtk/gtkappchooserwidget.h +14 -0
  160. data/vendor/local/include/gtk-3.0/gtk/gtkapplication.h +5 -0
  161. data/vendor/local/include/gtk-3.0/gtk/gtkarrow.h +3 -0
  162. data/vendor/local/include/gtk-3.0/gtk/gtkaspectframe.h +3 -0
  163. data/vendor/local/include/gtk-3.0/gtk/gtkassistant.h +22 -0
  164. data/vendor/local/include/gtk-3.0/gtk/gtkbbox.h +6 -0
  165. data/vendor/local/include/gtk-3.0/gtk/gtkbin.h +2 -0
  166. data/vendor/local/include/gtk-3.0/gtk/gtkbindings.h +11 -0
  167. data/vendor/local/include/gtk-3.0/gtk/gtkborder.h +5 -0
  168. data/vendor/local/include/gtk-3.0/gtk/gtkbox.h +16 -0
  169. data/vendor/local/include/gtk-3.0/gtk/gtkbuildable.h +11 -0
  170. data/vendor/local/include/gtk-3.0/gtk/gtkbuilder.h +43 -10
  171. data/vendor/local/include/gtk-3.0/gtk/gtkbutton.h +26 -0
  172. data/vendor/local/include/gtk-3.0/gtk/gtkcalendar.h +16 -0
  173. data/vendor/local/include/gtk-3.0/gtk/gtkcellarea.h +47 -0
  174. data/vendor/local/include/gtk-3.0/gtk/gtkcellareabox.h +6 -0
  175. data/vendor/local/include/gtk-3.0/gtk/gtkcellareacontext.h +11 -0
  176. data/vendor/local/include/gtk-3.0/gtk/gtkcelleditable.h +4 -0
  177. data/vendor/local/include/gtk-3.0/gtk/gtkcelllayout.h +11 -0
  178. data/vendor/local/include/gtk-3.0/gtk/gtkcellrenderer.h +25 -0
  179. data/vendor/local/include/gtk-3.0/gtk/gtkcellrendereraccel.h +2 -0
  180. data/vendor/local/include/gtk-3.0/gtk/gtkcellrenderercombo.h +2 -0
  181. data/vendor/local/include/gtk-3.0/gtk/gtkcellrendererpixbuf.h +2 -0
  182. data/vendor/local/include/gtk-3.0/gtk/gtkcellrendererprogress.h +2 -0
  183. data/vendor/local/include/gtk-3.0/gtk/gtkcellrendererspin.h +2 -0
  184. data/vendor/local/include/gtk-3.0/gtk/gtkcellrendererspinner.h +2 -0
  185. data/vendor/local/include/gtk-3.0/gtk/gtkcellrenderertext.h +3 -0
  186. data/vendor/local/include/gtk-3.0/gtk/gtkcellrenderertoggle.h +8 -0
  187. data/vendor/local/include/gtk-3.0/gtk/gtkcellview.h +15 -0
  188. data/vendor/local/include/gtk-3.0/gtk/gtkcheckbutton.h +4 -0
  189. data/vendor/local/include/gtk-3.0/gtk/gtkcheckmenuitem.h +11 -0
  190. data/vendor/local/include/gtk-3.0/gtk/gtkclipboard.h +29 -0
  191. data/vendor/local/include/gtk-3.0/gtk/gtkcolorbutton.h +5 -0
  192. data/vendor/local/include/gtk-3.0/gtk/gtkcolorutils.h +3 -0
  193. data/vendor/local/include/gtk-3.0/gtk/gtkcombobox.h +42 -0
  194. data/vendor/local/include/gtk-3.0/gtk/gtkcomboboxtext.h +12 -0
  195. data/vendor/local/include/gtk-3.0/gtk/gtkcontainer.h +36 -0
  196. data/vendor/local/include/gtk-3.0/gtk/gtkcssprovider.h +8 -0
  197. data/vendor/local/include/gtk-3.0/gtk/gtkdebug.h +7 -1
  198. data/vendor/local/include/gtk-3.0/gtk/gtkdialog.h +17 -0
  199. data/vendor/local/include/gtk-3.0/gtk/gtkdnd.h +43 -0
  200. data/vendor/local/include/gtk-3.0/gtk/gtkdrawingarea.h +2 -0
  201. data/vendor/local/include/gtk-3.0/gtk/gtkeditable.h +14 -0
  202. data/vendor/local/include/gtk-3.0/gtk/gtkentry.h +69 -0
  203. data/vendor/local/include/gtk-3.0/gtk/gtkentrybuffer.h +13 -0
  204. data/vendor/local/include/gtk-3.0/gtk/gtkentrycompletion.h +28 -0
  205. data/vendor/local/include/gtk-3.0/gtk/gtkenums.h +29 -1
  206. data/vendor/local/include/gtk-3.0/gtk/gtkeventbox.h +6 -0
  207. data/vendor/local/include/gtk-3.0/gtk/gtkexpander.h +17 -0
  208. data/vendor/local/include/gtk-3.0/gtk/gtkfilechooser.h +64 -2
  209. data/vendor/local/include/gtk-3.0/gtk/gtkfilechooserbutton.h +9 -0
  210. data/vendor/local/include/gtk-3.0/gtk/gtkfilechooserdialog.h +2 -0
  211. data/vendor/local/include/gtk-3.0/gtk/gtkfilechooserwidget.h +2 -0
  212. data/vendor/local/include/gtk-3.0/gtk/gtkfilefilter.h +11 -0
  213. data/vendor/local/include/gtk-3.0/gtk/gtkfixed.h +4 -0
  214. data/vendor/local/include/gtk-3.0/gtk/gtkfontbutton.h +15 -0
  215. data/vendor/local/include/gtk-3.0/gtk/gtkframe.h +10 -0
  216. data/vendor/local/include/gtk-3.0/gtk/gtkgrid.h +30 -0
  217. data/vendor/local/include/gtk-3.0/gtk/gtkheaderbar.h +95 -0
  218. data/vendor/local/include/gtk-3.0/gtk/gtkicontheme.h +76 -2
  219. data/vendor/local/include/gtk-3.0/gtk/gtkiconview.h +62 -0
  220. data/vendor/local/include/gtk-3.0/gtk/gtkimage.h +37 -1
  221. data/vendor/local/include/gtk-3.0/gtk/gtkimcontext.h +12 -0
  222. data/vendor/local/include/gtk-3.0/gtk/gtkimcontextsimple.h +3 -0
  223. data/vendor/local/include/gtk-3.0/gtk/gtkimmulticontext.h +5 -0
  224. data/vendor/local/include/gtk-3.0/gtk/gtkinfobar.h +19 -0
  225. data/vendor/local/include/gtk-3.0/gtk/gtkinvisible.h +5 -0
  226. data/vendor/local/include/gtk-3.0/gtk/gtklabel.h +50 -0
  227. data/vendor/local/include/gtk-3.0/gtk/gtklayout.h +7 -0
  228. data/vendor/local/include/gtk-3.0/gtk/gtklinkbutton.h +7 -0
  229. data/vendor/local/include/gtk-3.0/gtk/gtklistbox.h +232 -0
  230. data/vendor/local/include/gtk-3.0/gtk/gtkliststore.h +23 -0
  231. data/vendor/local/include/gtk-3.0/gtk/gtkmain.h +35 -0
  232. data/vendor/local/include/gtk-3.0/gtk/gtkmenu.h +28 -1
  233. data/vendor/local/include/gtk-3.0/gtk/gtkmenubar.h +6 -0
  234. data/vendor/local/include/gtk-3.0/gtk/gtkmenuitem.h +19 -0
  235. data/vendor/local/include/gtk-3.0/gtk/gtkmenushell.h +14 -0
  236. data/vendor/local/include/gtk-3.0/gtk/gtkmenutoolbutton.h +7 -0
  237. data/vendor/local/include/gtk-3.0/gtk/gtkmessagedialog.h +9 -0
  238. data/vendor/local/include/gtk-3.0/gtk/gtkmisc.h +5 -1
  239. data/vendor/local/include/gtk-3.0/gtk/gtkmountoperation.h +7 -0
  240. data/vendor/local/include/gtk-3.0/gtk/gtknotebook.h +45 -0
  241. data/vendor/local/include/gtk-3.0/gtk/gtknumerableicon.h +13 -0
  242. data/vendor/local/include/gtk-3.0/gtk/gtkoffscreenwindow.h +4 -0
  243. data/vendor/local/include/gtk-3.0/gtk/gtkorientable.h +3 -0
  244. data/vendor/local/include/gtk-3.0/gtk/gtkpagesetup.h +26 -0
  245. data/vendor/local/include/gtk-3.0/gtk/gtkpaned.h +11 -0
  246. data/vendor/local/include/gtk-3.0/gtk/gtkpapersize.h +24 -1
  247. data/vendor/local/include/gtk-3.0/gtk/gtkplacessidebar.h +125 -0
  248. data/vendor/local/include/gtk-3.0/gtk/gtkplug.h +8 -0
  249. data/vendor/local/include/gtk-3.0/gtk/gtkprintcontext.h +12 -0
  250. data/vendor/local/include/gtk-3.0/gtk/gtkprintoperation.h +34 -0
  251. data/vendor/local/include/gtk-3.0/gtk/gtkprintoperationpreview.h +4 -0
  252. data/vendor/local/include/gtk-3.0/gtk/gtkprintsettings.h +94 -0
  253. data/vendor/local/include/gtk-3.0/gtk/gtkprogressbar.h +15 -0
  254. data/vendor/local/include/gtk-3.0/gtk/gtkradiobutton.h +10 -0
  255. data/vendor/local/include/gtk-3.0/gtk/gtkradiomenuitem.h +9 -0
  256. data/vendor/local/include/gtk-3.0/gtk/gtkradiotoolbutton.h +7 -0
  257. data/vendor/local/include/gtk-3.0/gtk/gtkrange.h +29 -0
  258. data/vendor/local/include/gtk-3.0/gtk/gtkrecentchooser.h +33 -0
  259. data/vendor/local/include/gtk-3.0/gtk/gtkrecentchooserdialog.h +3 -0
  260. data/vendor/local/include/gtk-3.0/gtk/gtkrecentchoosermenu.h +5 -0
  261. data/vendor/local/include/gtk-3.0/gtk/gtkrecentchooserwidget.h +3 -0
  262. data/vendor/local/include/gtk-3.0/gtk/gtkrecentfilter.h +14 -0
  263. data/vendor/local/include/gtk-3.0/gtk/gtkrecentmanager.h +38 -0
  264. data/vendor/local/include/gtk-3.0/gtk/gtkrevealer.h +82 -0
  265. data/vendor/local/include/gtk-3.0/gtk/gtkscale.h +13 -0
  266. data/vendor/local/include/gtk-3.0/gtk/gtkscalebutton.h +10 -0
  267. data/vendor/local/include/gtk-3.0/gtk/gtkscrollable.h +10 -0
  268. data/vendor/local/include/gtk-3.0/gtk/gtkscrollbar.h +2 -0
  269. data/vendor/local/include/gtk-3.0/gtk/gtkscrolledwindow.h +19 -0
  270. data/vendor/local/include/gtk-3.0/gtk/gtksearchbar.h +95 -0
  271. data/vendor/local/include/gtk-3.0/gtk/gtksearchentry.h +2 -1
  272. data/vendor/local/include/gtk-3.0/gtk/gtkselection.h +52 -0
  273. data/vendor/local/include/gtk-3.0/gtk/gtkseparator.h +2 -0
  274. data/vendor/local/include/gtk-3.0/gtk/gtkseparatormenuitem.h +2 -0
  275. data/vendor/local/include/gtk-3.0/gtk/gtkseparatortoolitem.h +4 -0
  276. data/vendor/local/include/gtk-3.0/gtk/gtksettings.h +14 -0
  277. data/vendor/local/include/gtk-3.0/gtk/gtkshow.h +1 -0
  278. data/vendor/local/include/gtk-3.0/gtk/gtksizegroup.h +9 -0
  279. data/vendor/local/include/gtk-3.0/gtk/gtksizerequest.h +1 -0
  280. data/vendor/local/include/gtk-3.0/gtk/gtksocket.h +5 -0
  281. data/vendor/local/include/gtk-3.0/gtk/gtkspinbutton.h +25 -0
  282. data/vendor/local/include/gtk-3.0/gtk/gtkspinner.h +4 -0
  283. data/vendor/local/include/gtk-3.0/gtk/gtkstack.h +105 -0
  284. data/vendor/local/include/gtk-3.0/gtk/gtkstackswitcher.h +65 -0
  285. data/vendor/local/include/gtk-3.0/gtk/gtkstatusbar.h +8 -0
  286. data/vendor/local/include/gtk-3.0/gtk/gtkstatusicon.h +35 -0
  287. data/vendor/local/include/gtk-3.0/gtk/gtkstylecontext.h +122 -2
  288. data/vendor/local/include/gtk-3.0/gtk/gtkstyleproperties.h +11 -0
  289. data/vendor/local/include/gtk-3.0/gtk/gtkstyleprovider.h +3 -1
  290. data/vendor/local/include/gtk-3.0/gtk/gtkswitch.h +4 -0
  291. data/vendor/local/include/gtk-3.0/gtk/gtktestutils.h +18 -0
  292. data/vendor/local/include/gtk-3.0/gtk/gtktextattributes.h +16 -8
  293. data/vendor/local/include/gtk-3.0/gtk/gtktextbuffer.h +62 -0
  294. data/vendor/local/include/gtk-3.0/gtk/gtktextbufferrichtext.h +12 -0
  295. data/vendor/local/include/gtk-3.0/gtk/gtktextchild.h +4 -0
  296. data/vendor/local/include/gtk-3.0/gtk/gtktextdisplay.h +1 -0
  297. data/vendor/local/include/gtk-3.0/gtk/gtktextiter.h +106 -0
  298. data/vendor/local/include/gtk-3.0/gtk/gtktextlayout.h +48 -4
  299. data/vendor/local/include/gtk-3.0/gtk/gtktextmark.h +8 -0
  300. data/vendor/local/include/gtk-3.0/gtk/gtktexttag.h +5 -0
  301. data/vendor/local/include/gtk-3.0/gtk/gtktexttagtable.h +7 -0
  302. data/vendor/local/include/gtk-3.0/gtk/gtktextview.h +61 -0
  303. data/vendor/local/include/gtk-3.0/gtk/gtkthemingengine.h +28 -1
  304. data/vendor/local/include/gtk-3.0/gtk/gtktogglebutton.h +11 -0
  305. data/vendor/local/include/gtk-3.0/gtk/gtktoggletoolbutton.h +5 -0
  306. data/vendor/local/include/gtk-3.0/gtk/gtktoolbar.h +17 -0
  307. data/vendor/local/include/gtk-3.0/gtk/gtktoolbutton.h +15 -0
  308. data/vendor/local/include/gtk-3.0/gtk/gtktoolitem.h +30 -0
  309. data/vendor/local/include/gtk-3.0/gtk/gtktoolitemgroup.h +18 -0
  310. data/vendor/local/include/gtk-3.0/gtk/gtktoolpalette.h +21 -0
  311. data/vendor/local/include/gtk-3.0/gtk/gtktoolshell.h +10 -0
  312. data/vendor/local/include/gtk-3.0/gtk/gtktooltip.h +10 -0
  313. data/vendor/local/include/gtk-3.0/gtk/gtktreednd.h +9 -0
  314. data/vendor/local/include/gtk-3.0/gtk/gtktreemodel.h +68 -0
  315. data/vendor/local/include/gtk-3.0/gtk/gtktreemodelfilter.h +12 -0
  316. data/vendor/local/include/gtk-3.0/gtk/gtktreemodelsort.h +10 -0
  317. data/vendor/local/include/gtk-3.0/gtk/gtktreeselection.h +21 -0
  318. data/vendor/local/include/gtk-3.0/gtk/gtktreesortable.h +7 -0
  319. data/vendor/local/include/gtk-3.0/gtk/gtktreestore.h +24 -0
  320. data/vendor/local/include/gtk-3.0/gtk/gtktreeview.h +94 -0
  321. data/vendor/local/include/gtk-3.0/gtk/gtktreeviewcolumn.h +53 -0
  322. data/vendor/local/include/gtk-3.0/gtk/gtktypebuiltins.h +123 -108
  323. data/vendor/local/include/gtk-3.0/gtk/gtktypes.h +9 -0
  324. data/vendor/local/include/gtk-3.0/gtk/gtkversion.h +4 -4
  325. data/vendor/local/include/gtk-3.0/gtk/gtkviewport.h +6 -0
  326. data/vendor/local/include/gtk-3.0/gtk/gtkvolumebutton.h +2 -0
  327. data/vendor/local/include/gtk-3.0/gtk/gtkwidget.h +365 -4
  328. data/vendor/local/include/gtk-3.0/gtk/gtkwidgetpath.h +30 -0
  329. data/vendor/local/include/gtk-3.0/gtk/gtkwindow.h +119 -0
  330. data/vendor/local/lib/girepository-1.0/Gdk-3.0.typelib +0 -0
  331. data/vendor/local/lib/girepository-1.0/Gtk-3.0.typelib +0 -0
  332. data/vendor/local/lib/gtk-3.0/3.0.0/immodules.cache +1 -1
  333. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-am-et.dll +0 -0
  334. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-am-et.dll.a +0 -0
  335. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-am-et.la +2 -2
  336. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-cedilla.dll +0 -0
  337. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-cedilla.dll.a +0 -0
  338. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-cedilla.la +2 -2
  339. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-cyrillic-translit.dll +0 -0
  340. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-cyrillic-translit.dll.a +0 -0
  341. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-cyrillic-translit.la +2 -2
  342. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ime.dll +0 -0
  343. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ime.dll.a +0 -0
  344. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ime.la +2 -2
  345. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-inuktitut.dll +0 -0
  346. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-inuktitut.dll.a +0 -0
  347. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-inuktitut.la +2 -2
  348. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ipa.dll +0 -0
  349. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ipa.dll.a +0 -0
  350. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ipa.la +2 -2
  351. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-multipress.dll +0 -0
  352. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-multipress.dll.a +0 -0
  353. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-multipress.la +2 -2
  354. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-thai.dll +0 -0
  355. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-thai.dll.a +0 -0
  356. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-thai.la +2 -2
  357. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ti-er.dll +0 -0
  358. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ti-er.dll.a +0 -0
  359. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ti-er.la +2 -2
  360. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ti-et.dll +0 -0
  361. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ti-et.dll.a +0 -0
  362. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-ti-et.la +2 -2
  363. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-viqr.dll +0 -0
  364. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-viqr.dll.a +0 -0
  365. data/vendor/local/lib/gtk-3.0/3.0.0/immodules/im-viqr.la +2 -2
  366. data/vendor/local/lib/libgailutil-3.dll.a +0 -0
  367. data/vendor/local/lib/libgailutil-3.la +2 -2
  368. data/vendor/local/lib/libgdk-3.dll.a +0 -0
  369. data/vendor/local/lib/libgdk-3.la +5 -5
  370. data/vendor/local/lib/libgtk-3.dll.a +0 -0
  371. data/vendor/local/lib/libgtk-3.la +5 -5
  372. data/vendor/local/lib/pkgconfig/gail-3.0.pc +1 -1
  373. data/vendor/local/lib/pkgconfig/gdk-3.0.pc +1 -1
  374. data/vendor/local/lib/pkgconfig/gdk-win32-3.0.pc +1 -1
  375. data/vendor/local/lib/pkgconfig/gtk+-3.0.pc +1 -1
  376. data/vendor/local/lib/pkgconfig/gtk+-win32-3.0.pc +1 -1
  377. data/vendor/local/share/gir-1.0/Gdk-3.0.gir +2639 -2145
  378. data/vendor/local/share/gir-1.0/Gtk-3.0.gir +21620 -16038
  379. data/vendor/local/share/glib-2.0/schemas/gschemas.compiled +0 -0
  380. data/vendor/local/share/glib-2.0/schemas/org.gtk.Settings.FileChooser.gschema.xml +8 -0
  381. data/vendor/local/share/glib-2.0/schemas/org.gtk.exampleapp.gschema.xml +25 -0
  382. data/vendor/local/share/gtk-3.0/gtkbuilder.rng +19 -0
  383. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/gail-libgail-util3-GailMisc.html +43 -46
  384. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/gail-libgail-util3-GailTextUtil.html +17 -20
  385. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/home.png +0 -0
  386. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/index.html +4 -4
  387. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/left-insensitive.png +0 -0
  388. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/left.png +0 -0
  389. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/libgail-util-main.html +9 -9
  390. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/right-insensitive.png +0 -0
  391. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/right.png +0 -0
  392. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/style.css +71 -16
  393. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/up-insensitive.png +0 -0
  394. data/vendor/local/share/gtk-doc/html/gail-libgail-util3/up.png +0 -0
  395. data/vendor/local/share/gtk-doc/html/gdk3/GdkDevice.html +114 -18
  396. data/vendor/local/share/gtk-doc/html/gdk3/GdkDeviceManager.html +14 -17
  397. data/vendor/local/share/gtk-doc/html/gdk3/GdkDisplay.html +26 -25
  398. data/vendor/local/share/gtk-doc/html/gdk3/GdkDisplayManager.html +14 -16
  399. data/vendor/local/share/gtk-doc/html/gdk3/GdkScreen.html +58 -22
  400. data/vendor/local/share/gtk-doc/html/gdk3/annotation-glossary.html +39 -51
  401. data/vendor/local/share/gtk-doc/html/gdk3/api-index-3-0.html +27 -26
  402. data/vendor/local/share/gtk-doc/html/gdk3/api-index-3-10.html +148 -0
  403. data/vendor/local/share/gtk-doc/html/gdk3/api-index-3-2.html +13 -16
  404. data/vendor/local/share/gtk-doc/html/gdk3/api-index-3-4.html +23 -26
  405. data/vendor/local/share/gtk-doc/html/gdk3/api-index-3-6.html +10 -13
  406. data/vendor/local/share/gtk-doc/html/gdk3/api-index-3-8.html +41 -17
  407. data/vendor/local/share/gtk-doc/html/gdk3/api-index-deprecated.html +36 -28
  408. data/vendor/local/share/gtk-doc/html/gdk3/api-index-full.html +187 -58
  409. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Application-launching.html +16 -19
  410. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Cairo-Interaction.html +159 -54
  411. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Colors.html +12 -15
  412. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Cursors.html +119 -17
  413. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Drag-and-Drop.html +13 -16
  414. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Event-Structures.html +33 -26
  415. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Events.html +70 -17
  416. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-GdkFrameClock.html +12 -15
  417. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-GdkFrameTimings.html +12 -15
  418. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-General.html +93 -30
  419. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Keyboard-Handling.html +18 -21
  420. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Pango-Interaction.html +59 -62
  421. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Pixbufs.html +15 -18
  422. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Points-Rectangles-and-Regions.html +15 -18
  423. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Properties-and-Atoms.html +13 -16
  424. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-RGBA-Colors.html +13 -16
  425. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Selections.html +13 -16
  426. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Testing.html +14 -17
  427. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Threads.html +40 -43
  428. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Visuals.html +12 -15
  429. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Wayland-Interaction.html +425 -0
  430. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-Windows.html +363 -106
  431. data/vendor/local/share/gtk-doc/html/gdk3/gdk3-X-Window-System-Interaction.html +264 -17
  432. data/vendor/local/share/gtk-doc/html/gdk3/gdk3.devhelp2 +38 -2
  433. data/vendor/local/share/gtk-doc/html/gdk3/home.png +0 -0
  434. data/vendor/local/share/gtk-doc/html/gdk3/index.html +8 -4
  435. data/vendor/local/share/gtk-doc/html/gdk3/index.sgml +44 -6
  436. data/vendor/local/share/gtk-doc/html/gdk3/left-insensitive.png +0 -0
  437. data/vendor/local/share/gtk-doc/html/gdk3/left.png +0 -0
  438. data/vendor/local/share/gtk-doc/html/gdk3/reference.html +12 -9
  439. data/vendor/local/share/gtk-doc/html/gdk3/right-insensitive.png +0 -0
  440. data/vendor/local/share/gtk-doc/html/gdk3/right.png +0 -0
  441. data/vendor/local/share/gtk-doc/html/gdk3/style.css +71 -16
  442. data/vendor/local/share/gtk-doc/html/gdk3/up-insensitive.png +0 -0
  443. data/vendor/local/share/gtk-doc/html/gdk3/up.png +0 -0
  444. data/vendor/local/share/gtk-doc/html/gtk3/AbstractObjects.html +10 -10
  445. data/vendor/local/share/gtk-doc/html/gtk3/Application.html +11 -11
  446. data/vendor/local/share/gtk-doc/html/gtk3/ApplicationChoosing.html +10 -10
  447. data/vendor/local/share/gtk-doc/html/gtk3/Builder.html +14 -14
  448. data/vendor/local/share/gtk-doc/html/gtk3/ButtonWidgets.html +16 -16
  449. data/vendor/local/share/gtk-doc/html/gtk3/DeprecatedObjects.html +38 -11
  450. data/vendor/local/share/gtk-doc/html/gtk3/DisplayWidgets.html +19 -19
  451. data/vendor/local/share/gtk-doc/html/gtk3/GtkAboutDialog.html +15 -22
  452. data/vendor/local/share/gtk-doc/html/gtk3/GtkAccelLabel.html +15 -18
  453. data/vendor/local/share/gtk-doc/html/gtk3/GtkAccessible.html +14 -17
  454. data/vendor/local/share/gtk-doc/html/gtk3/GtkAction.html +347 -29
  455. data/vendor/local/share/gtk-doc/html/gtk3/GtkActionGroup.html +158 -21
  456. data/vendor/local/share/gtk-doc/html/gtk3/GtkActionable.html +13 -16
  457. data/vendor/local/share/gtk-doc/html/gtk3/GtkActivatable.html +58 -25
  458. data/vendor/local/share/gtk-doc/html/gtk3/GtkAdjustment.html +12 -15
  459. data/vendor/local/share/gtk-doc/html/gtk3/GtkAlignment.html +15 -18
  460. data/vendor/local/share/gtk-doc/html/gtk3/GtkAppChooser.html +12 -15
  461. data/vendor/local/share/gtk-doc/html/gtk3/GtkAppChooserButton.html +12 -15
  462. data/vendor/local/share/gtk-doc/html/gtk3/GtkAppChooserDialog.html +12 -15
  463. data/vendor/local/share/gtk-doc/html/gtk3/GtkAppChooserWidget.html +13 -16
  464. data/vendor/local/share/gtk-doc/html/gtk3/GtkApplication.html +82 -23
  465. data/vendor/local/share/gtk-doc/html/gtk3/GtkApplicationWindow.html +14 -17
  466. data/vendor/local/share/gtk-doc/html/gtk3/GtkArrow.html +13 -16
  467. data/vendor/local/share/gtk-doc/html/gtk3/GtkAspectFrame.html +16 -18
  468. data/vendor/local/share/gtk-doc/html/gtk3/GtkAssistant.html +19 -22
  469. data/vendor/local/share/gtk-doc/html/gtk3/GtkBin.html +15 -15
  470. data/vendor/local/share/gtk-doc/html/gtk3/GtkBox.html +91 -19
  471. data/vendor/local/share/gtk-doc/html/gtk3/GtkBuildable.html +16 -19
  472. data/vendor/local/share/gtk-doc/html/gtk3/GtkBuilder.html +341 -39
  473. data/vendor/local/share/gtk-doc/html/gtk3/GtkButton.html +82 -27
  474. data/vendor/local/share/gtk-doc/html/gtk3/GtkButtonBox.html +14 -17
  475. data/vendor/local/share/gtk-doc/html/gtk3/GtkCalendar.html +12 -15
  476. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellArea.html +22 -24
  477. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellAreaBox.html +12 -15
  478. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellAreaContext.html +16 -19
  479. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellEditable.html +12 -15
  480. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellLayout.html +15 -18
  481. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellRenderer.html +20 -23
  482. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellRendererAccel.html +12 -15
  483. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellRendererCombo.html +13 -16
  484. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellRendererPixbuf.html +25 -17
  485. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellRendererProgress.html +13 -16
  486. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellRendererSpin.html +12 -15
  487. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellRendererSpinner.html +12 -15
  488. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellRendererText.html +36 -39
  489. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellRendererToggle.html +12 -15
  490. data/vendor/local/share/gtk-doc/html/gtk3/GtkCellView.html +15 -18
  491. data/vendor/local/share/gtk-doc/html/gtk3/GtkCheckButton.html +12 -15
  492. data/vendor/local/share/gtk-doc/html/gtk3/GtkCheckMenuItem.html +12 -15
  493. data/vendor/local/share/gtk-doc/html/gtk3/GtkColorButton.html +22 -25
  494. data/vendor/local/share/gtk-doc/html/gtk3/GtkColorChooser.html +12 -15
  495. data/vendor/local/share/gtk-doc/html/gtk3/GtkColorChooserDialog.html +12 -15
  496. data/vendor/local/share/gtk-doc/html/gtk3/GtkColorChooserWidget.html +12 -15
  497. data/vendor/local/share/gtk-doc/html/gtk3/GtkColorSelection.html +17 -20
  498. data/vendor/local/share/gtk-doc/html/gtk3/GtkColorSelectionDialog.html +13 -16
  499. data/vendor/local/share/gtk-doc/html/gtk3/GtkComboBox.html +43 -20
  500. data/vendor/local/share/gtk-doc/html/gtk3/GtkComboBoxText.html +14 -17
  501. data/vendor/local/share/gtk-doc/html/gtk3/GtkContainer.html +40 -21
  502. data/vendor/local/share/gtk-doc/html/gtk3/GtkCssProvider.html +42 -46
  503. data/vendor/local/share/gtk-doc/html/gtk3/GtkDialog.html +30 -34
  504. data/vendor/local/share/gtk-doc/html/gtk3/GtkDrawingArea.html +15 -18
  505. data/vendor/local/share/gtk-doc/html/gtk3/GtkEditable.html +14 -17
  506. data/vendor/local/share/gtk-doc/html/gtk3/GtkEntry.html +121 -41
  507. data/vendor/local/share/gtk-doc/html/gtk3/GtkEntryBuffer.html +12 -15
  508. data/vendor/local/share/gtk-doc/html/gtk3/GtkEntryCompletion.html +13 -16
  509. data/vendor/local/share/gtk-doc/html/gtk3/GtkEventBox.html +13 -16
  510. data/vendor/local/share/gtk-doc/html/gtk3/GtkExpander.html +14 -17
  511. data/vendor/local/share/gtk-doc/html/gtk3/GtkFileChooser.html +67 -34
  512. data/vendor/local/share/gtk-doc/html/gtk3/GtkFileChooserButton.html +16 -19
  513. data/vendor/local/share/gtk-doc/html/gtk3/GtkFileChooserDialog.html +21 -24
  514. data/vendor/local/share/gtk-doc/html/gtk3/GtkFileChooserWidget.html +12 -15
  515. data/vendor/local/share/gtk-doc/html/gtk3/GtkFileFilter.html +13 -16
  516. data/vendor/local/share/gtk-doc/html/gtk3/GtkFixed.html +14 -17
  517. data/vendor/local/share/gtk-doc/html/gtk3/GtkFontButton.html +14 -17
  518. data/vendor/local/share/gtk-doc/html/gtk3/GtkFontChooser.html +37 -40
  519. data/vendor/local/share/gtk-doc/html/gtk3/GtkFontChooserDialog.html +13 -16
  520. data/vendor/local/share/gtk-doc/html/gtk3/GtkFontChooserWidget.html +12 -15
  521. data/vendor/local/share/gtk-doc/html/gtk3/GtkFontSelection.html +34 -37
  522. data/vendor/local/share/gtk-doc/html/gtk3/GtkFontSelectionDialog.html +22 -25
  523. data/vendor/local/share/gtk-doc/html/gtk3/GtkFrame.html +15 -17
  524. data/vendor/local/share/gtk-doc/html/gtk3/GtkGrid.html +229 -17
  525. data/vendor/local/share/gtk-doc/html/gtk3/GtkHBox.html +17 -20
  526. data/vendor/local/share/gtk-doc/html/gtk3/GtkHButtonBox.html +13 -16
  527. data/vendor/local/share/gtk-doc/html/gtk3/GtkHPaned.html +13 -16
  528. data/vendor/local/share/gtk-doc/html/gtk3/GtkHSV.html +12 -15
  529. data/vendor/local/share/gtk-doc/html/gtk3/GtkHScale.html +14 -17
  530. data/vendor/local/share/gtk-doc/html/gtk3/GtkHScrollbar.html +13 -16
  531. data/vendor/local/share/gtk-doc/html/gtk3/GtkHSeparator.html +14 -17
  532. data/vendor/local/share/gtk-doc/html/gtk3/GtkHandleBox.html +23 -26
  533. data/vendor/local/share/gtk-doc/html/gtk3/GtkHeaderBar.html +503 -0
  534. data/vendor/local/share/gtk-doc/html/gtk3/GtkIMContext.html +15 -20
  535. data/vendor/local/share/gtk-doc/html/gtk3/GtkIMContextSimple.html +12 -15
  536. data/vendor/local/share/gtk-doc/html/gtk3/GtkIMMulticontext.html +19 -15
  537. data/vendor/local/share/gtk-doc/html/gtk3/GtkIconTheme.html +451 -20
  538. data/vendor/local/share/gtk-doc/html/gtk3/GtkIconView.html +25 -27
  539. data/vendor/local/share/gtk-doc/html/gtk3/GtkImage.html +64 -21
  540. data/vendor/local/share/gtk-doc/html/gtk3/GtkImageMenuItem.html +80 -22
  541. data/vendor/local/share/gtk-doc/html/gtk3/GtkInfoBar.html +102 -46
  542. data/vendor/local/share/gtk-doc/html/gtk3/GtkInvisible.html +14 -17
  543. data/vendor/local/share/gtk-doc/html/gtk3/GtkLabel.html +146 -72
  544. data/vendor/local/share/gtk-doc/html/gtk3/GtkLayout.html +16 -19
  545. data/vendor/local/share/gtk-doc/html/gtk3/GtkLevelBar.html +15 -18
  546. data/vendor/local/share/gtk-doc/html/gtk3/GtkLinkButton.html +13 -16
  547. data/vendor/local/share/gtk-doc/html/gtk3/GtkListBox.html +1251 -0
  548. data/vendor/local/share/gtk-doc/html/gtk3/GtkListStore.html +17 -20
  549. data/vendor/local/share/gtk-doc/html/gtk3/GtkLockButton.html +15 -18
  550. data/vendor/local/share/gtk-doc/html/gtk3/GtkMenu.html +60 -26
  551. data/vendor/local/share/gtk-doc/html/gtk3/GtkMenuBar.html +13 -16
  552. data/vendor/local/share/gtk-doc/html/gtk3/GtkMenuButton.html +14 -17
  553. data/vendor/local/share/gtk-doc/html/gtk3/GtkMenuItem.html +50 -25
  554. data/vendor/local/share/gtk-doc/html/gtk3/GtkMenuShell.html +51 -15
  555. data/vendor/local/share/gtk-doc/html/gtk3/GtkMenuToolButton.html +20 -22
  556. data/vendor/local/share/gtk-doc/html/gtk3/GtkMessageDialog.html +23 -26
  557. data/vendor/local/share/gtk-doc/html/gtk3/GtkMisc.html +13 -16
  558. data/vendor/local/share/gtk-doc/html/gtk3/GtkNotebook.html +17 -20
  559. data/vendor/local/share/gtk-doc/html/gtk3/GtkNumerableIcon.html +15 -18
  560. data/vendor/local/share/gtk-doc/html/gtk3/GtkOffscreenWindow.html +19 -22
  561. data/vendor/local/share/gtk-doc/html/gtk3/GtkOverlay.html +14 -17
  562. data/vendor/local/share/gtk-doc/html/gtk3/GtkPageSetup.html +13 -16
  563. data/vendor/local/share/gtk-doc/html/gtk3/GtkPageSetupUnixDialog.html +12 -15
  564. data/vendor/local/share/gtk-doc/html/gtk3/GtkPaned.html +14 -17
  565. data/vendor/local/share/gtk-doc/html/gtk3/GtkPaperSize.html +13 -16
  566. data/vendor/local/share/gtk-doc/html/gtk3/GtkPlacesSidebar.html +983 -0
  567. data/vendor/local/share/gtk-doc/html/gtk3/GtkPrintContext.html +50 -53
  568. data/vendor/local/share/gtk-doc/html/gtk3/GtkPrintJob.html +14 -17
  569. data/vendor/local/share/gtk-doc/html/gtk3/GtkPrintSettings.html +12 -15
  570. data/vendor/local/share/gtk-doc/html/gtk3/GtkPrintUnixDialog.html +14 -17
  571. data/vendor/local/share/gtk-doc/html/gtk3/GtkPrinter.html +12 -15
  572. data/vendor/local/share/gtk-doc/html/gtk3/GtkProgressBar.html +24 -27
  573. data/vendor/local/share/gtk-doc/html/gtk3/GtkRadioAction.html +53 -16
  574. data/vendor/local/share/gtk-doc/html/gtk3/GtkRadioButton.html +13 -16
  575. data/vendor/local/share/gtk-doc/html/gtk3/GtkRadioMenuItem.html +14 -17
  576. data/vendor/local/share/gtk-doc/html/gtk3/GtkRadioToolButton.html +22 -20
  577. data/vendor/local/share/gtk-doc/html/gtk3/GtkRange.html +13 -16
  578. data/vendor/local/share/gtk-doc/html/gtk3/GtkRecentAction.html +36 -17
  579. data/vendor/local/share/gtk-doc/html/gtk3/GtkRecentChooser.html +18 -23
  580. data/vendor/local/share/gtk-doc/html/gtk3/GtkRecentChooserDialog.html +15 -18
  581. data/vendor/local/share/gtk-doc/html/gtk3/GtkRecentChooserMenu.html +12 -15
  582. data/vendor/local/share/gtk-doc/html/gtk3/GtkRecentChooserWidget.html +12 -15
  583. data/vendor/local/share/gtk-doc/html/gtk3/GtkRecentFilter.html +13 -16
  584. data/vendor/local/share/gtk-doc/html/gtk3/GtkRecentManager.html +19 -22
  585. data/vendor/local/share/gtk-doc/html/gtk3/GtkRevealer.html +437 -0
  586. data/vendor/local/share/gtk-doc/html/gtk3/GtkScale.html +21 -24
  587. data/vendor/local/share/gtk-doc/html/gtk3/GtkScaleButton.html +13 -16
  588. data/vendor/local/share/gtk-doc/html/gtk3/GtkScrollable.html +13 -16
  589. data/vendor/local/share/gtk-doc/html/gtk3/GtkScrollbar.html +13 -16
  590. data/vendor/local/share/gtk-doc/html/gtk3/GtkScrolledWindow.html +25 -24
  591. data/vendor/local/share/gtk-doc/html/gtk3/GtkSearchBar.html +514 -0
  592. data/vendor/local/share/gtk-doc/html/gtk3/GtkSearchEntry.html +57 -16
  593. data/vendor/local/share/gtk-doc/html/gtk3/GtkSeparator.html +12 -15
  594. data/vendor/local/share/gtk-doc/html/gtk3/GtkSeparatorMenuItem.html +12 -15
  595. data/vendor/local/share/gtk-doc/html/gtk3/GtkSeparatorToolItem.html +12 -15
  596. data/vendor/local/share/gtk-doc/html/gtk3/GtkSettings.html +191 -47
  597. data/vendor/local/share/gtk-doc/html/gtk3/GtkSizeGroup.html +13 -16
  598. data/vendor/local/share/gtk-doc/html/gtk3/GtkSpinButton.html +14 -17
  599. data/vendor/local/share/gtk-doc/html/gtk3/GtkSpinner.html +14 -17
  600. data/vendor/local/share/gtk-doc/html/gtk3/GtkStack.html +708 -0
  601. data/vendor/local/share/gtk-doc/html/gtk3/GtkStackSwitcher.html +195 -0
  602. data/vendor/local/share/gtk-doc/html/gtk3/GtkStatusIcon.html +32 -19
  603. data/vendor/local/share/gtk-doc/html/gtk3/GtkStatusbar.html +14 -17
  604. data/vendor/local/share/gtk-doc/html/gtk3/GtkStyle.html +108 -111
  605. data/vendor/local/share/gtk-doc/html/gtk3/GtkStyleContext.html +230 -108
  606. data/vendor/local/share/gtk-doc/html/gtk3/GtkStyleProvider.html +15 -18
  607. data/vendor/local/share/gtk-doc/html/gtk3/GtkSwitch.html +14 -17
  608. data/vendor/local/share/gtk-doc/html/gtk3/GtkTable.html +28 -31
  609. data/vendor/local/share/gtk-doc/html/gtk3/GtkTearoffMenuItem.html +14 -17
  610. data/vendor/local/share/gtk-doc/html/gtk3/GtkTextBuffer.html +42 -34
  611. data/vendor/local/share/gtk-doc/html/gtk3/GtkTextIter.html +67 -45
  612. data/vendor/local/share/gtk-doc/html/gtk3/GtkTextMark.html +14 -17
  613. data/vendor/local/share/gtk-doc/html/gtk3/GtkTextTag.html +84 -133
  614. data/vendor/local/share/gtk-doc/html/gtk3/GtkTextTagTable.html +17 -19
  615. data/vendor/local/share/gtk-doc/html/gtk3/GtkTextView.html +76 -33
  616. data/vendor/local/share/gtk-doc/html/gtk3/GtkThemingEngine.html +32 -26
  617. data/vendor/local/share/gtk-doc/html/gtk3/GtkToggleAction.html +49 -16
  618. data/vendor/local/share/gtk-doc/html/gtk3/GtkToggleButton.html +13 -16
  619. data/vendor/local/share/gtk-doc/html/gtk3/GtkToggleToolButton.html +17 -17
  620. data/vendor/local/share/gtk-doc/html/gtk3/GtkToolButton.html +29 -18
  621. data/vendor/local/share/gtk-doc/html/gtk3/GtkToolItem.html +15 -18
  622. data/vendor/local/share/gtk-doc/html/gtk3/GtkToolItemGroup.html +20 -23
  623. data/vendor/local/share/gtk-doc/html/gtk3/GtkToolPalette.html +20 -22
  624. data/vendor/local/share/gtk-doc/html/gtk3/GtkToolShell.html +14 -17
  625. data/vendor/local/share/gtk-doc/html/gtk3/GtkToolbar.html +15 -18
  626. data/vendor/local/share/gtk-doc/html/gtk3/GtkTooltip.html +19 -18
  627. data/vendor/local/share/gtk-doc/html/gtk3/GtkTreeModel.html +17 -20
  628. data/vendor/local/share/gtk-doc/html/gtk3/GtkTreeModelFilter.html +12 -15
  629. data/vendor/local/share/gtk-doc/html/gtk3/GtkTreeModelSort.html +15 -18
  630. data/vendor/local/share/gtk-doc/html/gtk3/GtkTreeSelection.html +12 -15
  631. data/vendor/local/share/gtk-doc/html/gtk3/GtkTreeSortable.html +12 -15
  632. data/vendor/local/share/gtk-doc/html/gtk3/GtkTreeStore.html +13 -16
  633. data/vendor/local/share/gtk-doc/html/gtk3/GtkTreeView.html +23 -26
  634. data/vendor/local/share/gtk-doc/html/gtk3/GtkTreeViewColumn.html +16 -19
  635. data/vendor/local/share/gtk-doc/html/gtk3/GtkUIManager.html +114 -25
  636. data/vendor/local/share/gtk-doc/html/gtk3/GtkVBox.html +17 -20
  637. data/vendor/local/share/gtk-doc/html/gtk3/GtkVButtonBox.html +13 -16
  638. data/vendor/local/share/gtk-doc/html/gtk3/GtkVPaned.html +13 -16
  639. data/vendor/local/share/gtk-doc/html/gtk3/GtkVScale.html +14 -17
  640. data/vendor/local/share/gtk-doc/html/gtk3/GtkVScrollbar.html +14 -17
  641. data/vendor/local/share/gtk-doc/html/gtk3/GtkVSeparator.html +13 -16
  642. data/vendor/local/share/gtk-doc/html/gtk3/GtkViewport.html +16 -19
  643. data/vendor/local/share/gtk-doc/html/gtk3/GtkVolumeButton.html +13 -16
  644. data/vendor/local/share/gtk-doc/html/gtk3/GtkWidget.html +1137 -138
  645. data/vendor/local/share/gtk-doc/html/gtk3/GtkWindow.html +113 -30
  646. data/vendor/local/share/gtk-doc/html/gtk3/GtkWindowGroup.html +13 -16
  647. data/vendor/local/share/gtk-doc/html/gtk3/LayoutContainers.html +35 -20
  648. data/vendor/local/share/gtk-doc/html/gtk3/MenusAndCombos.html +10 -13
  649. data/vendor/local/share/gtk-doc/html/gtk3/MiscObjects.html +10 -10
  650. data/vendor/local/share/gtk-doc/html/gtk3/NumericEntry.html +14 -11
  651. data/vendor/local/share/gtk-doc/html/gtk3/Ornaments.html +11 -11
  652. data/vendor/local/share/gtk-doc/html/gtk3/PlugSocket.html +13 -13
  653. data/vendor/local/share/gtk-doc/html/gtk3/Printing.html +10 -10
  654. data/vendor/local/share/gtk-doc/html/gtk3/RecentDocuments.html +11 -11
  655. data/vendor/local/share/gtk-doc/html/gtk3/ScrollingWidgets.html +10 -10
  656. data/vendor/local/share/gtk-doc/html/gtk3/SelectorWidgets.html +14 -11
  657. data/vendor/local/share/gtk-doc/html/gtk3/TextWidget.html +17 -17
  658. data/vendor/local/share/gtk-doc/html/gtk3/TextWidgetObjects.html +10 -10
  659. data/vendor/local/share/gtk-doc/html/gtk3/TreeWidget.html +15 -15
  660. data/vendor/local/share/gtk-doc/html/gtk3/TreeWidgetObjects.html +10 -10
  661. data/vendor/local/share/gtk-doc/html/gtk3/WindowWidgets.html +17 -17
  662. data/vendor/local/share/gtk-doc/html/gtk3/aboutdialog.png +0 -0
  663. data/vendor/local/share/gtk-doc/html/gtk3/accel-label.png +0 -0
  664. data/vendor/local/share/gtk-doc/html/gtk3/annotation-glossary.html +41 -59
  665. data/vendor/local/share/gtk-doc/html/gtk3/api-index-3-0.html +41 -44
  666. data/vendor/local/share/gtk-doc/html/gtk3/api-index-3-10.html +666 -0
  667. data/vendor/local/share/gtk-doc/html/gtk3/api-index-3-2.html +39 -42
  668. data/vendor/local/share/gtk-doc/html/gtk3/api-index-3-4.html +31 -34
  669. data/vendor/local/share/gtk-doc/html/gtk3/api-index-3-6.html +27 -30
  670. data/vendor/local/share/gtk-doc/html/gtk3/api-index-3-8.html +24 -27
  671. data/vendor/local/share/gtk-doc/html/gtk3/api-index-deprecated.html +1825 -224
  672. data/vendor/local/share/gtk-doc/html/gtk3/api-index-full.html +917 -112
  673. data/vendor/local/share/gtk-doc/html/gtk3/appchooserbutton.png +0 -0
  674. data/vendor/local/share/gtk-doc/html/gtk3/appchooserdialog.png +0 -0
  675. data/vendor/local/share/gtk-doc/html/gtk3/assistant.png +0 -0
  676. data/vendor/local/share/gtk-doc/html/gtk3/broadwayd.html +10 -10
  677. data/vendor/local/share/gtk-doc/html/gtk3/button.png +0 -0
  678. data/vendor/local/share/gtk-doc/html/gtk3/ch01s02.html +130 -0
  679. data/vendor/local/share/gtk-doc/html/gtk3/ch01s03.html +248 -0
  680. data/vendor/local/share/gtk-doc/html/gtk3/ch01s04.html +157 -0
  681. data/vendor/local/share/gtk-doc/html/gtk3/ch01s05.html +1773 -0
  682. data/vendor/local/share/gtk-doc/html/gtk3/ch02.html +20 -14
  683. data/vendor/local/share/gtk-doc/html/gtk3/ch03.html +232 -156
  684. data/vendor/local/share/gtk-doc/html/gtk3/{ch25s02.html → ch24s02.html} +47 -47
  685. data/vendor/local/share/gtk-doc/html/gtk3/{ch27s02.html → ch26s02.html} +9 -9
  686. data/vendor/local/share/gtk-doc/html/gtk3/{ch29s02.html → ch28s02.html} +11 -11
  687. data/vendor/local/share/gtk-doc/html/gtk3/{ch29s03.html → ch28s03.html} +11 -11
  688. data/vendor/local/share/gtk-doc/html/gtk3/chap-drawing-model.html +10 -10
  689. data/vendor/local/share/gtk-doc/html/gtk3/check-button.png +0 -0
  690. data/vendor/local/share/gtk-doc/html/gtk3/checklist-gdkeventexpose-region.html +9 -9
  691. data/vendor/local/share/gtk-doc/html/gtk3/checklist-modifiers.html +9 -9
  692. data/vendor/local/share/gtk-doc/html/gtk3/checklist-named-icons.html +9 -9
  693. data/vendor/local/share/gtk-doc/html/gtk3/color-button.png +0 -0
  694. data/vendor/local/share/gtk-doc/html/gtk3/colorchooser.png +0 -0
  695. data/vendor/local/share/gtk-doc/html/gtk3/combo-box-entry.png +0 -0
  696. data/vendor/local/share/gtk-doc/html/gtk3/combo-box-text.png +0 -0
  697. data/vendor/local/share/gtk-doc/html/gtk3/combo-box.png +0 -0
  698. data/vendor/local/share/gtk-doc/html/gtk3/drawing.png +0 -0
  699. data/vendor/local/share/gtk-doc/html/gtk3/entry.png +0 -0
  700. data/vendor/local/share/gtk-doc/html/gtk3/exampleapp.png +0 -0
  701. data/vendor/local/share/gtk-doc/html/gtk3/file-button.png +0 -0
  702. data/vendor/local/share/gtk-doc/html/gtk3/filechooser.png +0 -0
  703. data/vendor/local/share/gtk-doc/html/gtk3/font-button.png +0 -0
  704. data/vendor/local/share/gtk-doc/html/gtk3/fontchooser.png +0 -0
  705. data/vendor/local/share/gtk-doc/html/gtk3/frame.png +0 -0
  706. data/vendor/local/share/gtk-doc/html/gtk3/getting-started-app1.png +0 -0
  707. data/vendor/local/share/gtk-doc/html/gtk3/getting-started-app2.png +0 -0
  708. data/vendor/local/share/gtk-doc/html/gtk3/getting-started-app3.png +0 -0
  709. data/vendor/local/share/gtk-doc/html/gtk3/getting-started-app4.png +0 -0
  710. data/vendor/local/share/gtk-doc/html/gtk3/getting-started-app6.png +0 -0
  711. data/vendor/local/share/gtk-doc/html/gtk3/getting-started-app7.png +0 -0
  712. data/vendor/local/share/gtk-doc/html/gtk3/getting-started-app8.png +0 -0
  713. data/vendor/local/share/gtk-doc/html/gtk3/getting-started-app9.png +0 -0
  714. data/vendor/local/share/gtk-doc/html/gtk3/glossary.html +10 -10
  715. data/vendor/local/share/gtk-doc/html/gtk3/grid-packing.png +0 -0
  716. data/vendor/local/share/gtk-doc/html/gtk3/gtk-broadway.html +11 -11
  717. data/vendor/local/share/gtk-doc/html/gtk3/gtk-building.html +20 -12
  718. data/vendor/local/share/gtk-doc/html/gtk3/gtk-compiling.html +15 -15
  719. data/vendor/local/share/gtk-doc/html/gtk3/gtk-getting-started.html +147 -965
  720. data/vendor/local/share/gtk-doc/html/gtk3/gtk-launch.html +9 -9
  721. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-2-to-3.html +67 -67
  722. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-GtkGrid.html +13 -13
  723. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-GtkStyleContext-bonus-points.html +11 -11
  724. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-GtkStyleContext-checklist.html +12 -12
  725. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-GtkStyleContext-css.html +11 -11
  726. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-GtkStyleContext-parser-extensions.html +9 -9
  727. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-GtkStyleContext-parsing.html +10 -10
  728. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-GtkStyleContext.html +10 -10
  729. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-checklist.html +12 -12
  730. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-smclient-GtkApplication.html +10 -10
  731. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-theme-GtkStyleContext-engines.html +10 -10
  732. data/vendor/local/share/gtk-doc/html/gtk3/gtk-migrating-unique-GtkApplication.html +12 -12
  733. data/vendor/local/share/gtk-doc/html/gtk3/gtk-osx.html +11 -11
  734. data/vendor/local/share/gtk-doc/html/gtk3/gtk-query-immodules-3.0.html +9 -9
  735. data/vendor/local/share/gtk-doc/html/gtk3/gtk-question-index.html +65 -65
  736. data/vendor/local/share/gtk-doc/html/gtk3/gtk-resources.html +13 -13
  737. data/vendor/local/share/gtk-doc/html/gtk3/gtk-running.html +19 -16
  738. data/vendor/local/share/gtk-doc/html/gtk3/gtk-update-icon-cache.html +9 -9
  739. data/vendor/local/share/gtk-doc/html/gtk3/gtk-wayland.html +12 -12
  740. data/vendor/local/share/gtk-doc/html/gtk3/gtk-windows.html +11 -11
  741. data/vendor/local/share/gtk-doc/html/gtk3/gtk-x11.html +27 -12
  742. data/vendor/local/share/gtk-doc/html/gtk3/gtk.html +26 -49
  743. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Accelerator-Maps.html +14 -17
  744. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Bindings.html +20 -23
  745. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Clipboards.html +17 -18
  746. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Drag-and-Drop.html +32 -56
  747. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Feature-Test-Macros.html +17 -20
  748. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Filesystem-utilities.html +14 -17
  749. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-General.html +26 -29
  750. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-GtkGradient.html +24 -27
  751. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-GtkPlug.html +303 -0
  752. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-GtkSocket.html +273 -0
  753. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-GtkStyleProperties.html +17 -20
  754. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-GtkSymbolicColor.html +22 -25
  755. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-GtkTreeView-drag-and-drop.html +12 -15
  756. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-GtkWidgetPath.html +16 -19
  757. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-High-level-Printing-API.html +29 -32
  758. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Keyboard-Accelerators.html +18 -18
  759. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Orientable.html +15 -18
  760. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Resource-Files.html +45 -48
  761. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Selections.html +15 -18
  762. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Standard-Enumerations.html +13 -16
  763. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Stock-Items.html +568 -123
  764. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Testing.html +40 -16
  765. data/vendor/local/share/gtk-doc/html/gtk3/gtk3-Themeable-Stock-Images.html +248 -27
  766. data/vendor/local/share/gtk-doc/html/gtk3/gtk3.devhelp2 +6347 -6099
  767. data/vendor/local/share/gtk-doc/html/gtk3/gtkbase.html +11 -14
  768. data/vendor/local/share/gtk-doc/html/gtk3/gtkobjects.html +139 -118
  769. data/vendor/local/share/gtk-doc/html/gtk3/headerbar.png +0 -0
  770. data/vendor/local/share/gtk-doc/html/gtk3/hello-world.png +0 -0
  771. data/vendor/local/share/gtk-doc/html/gtk3/home.png +0 -0
  772. data/vendor/local/share/gtk-doc/html/gtk3/icon-view.png +0 -0
  773. data/vendor/local/share/gtk-doc/html/gtk3/image.png +0 -0
  774. data/vendor/local/share/gtk-doc/html/gtk3/index.html +248 -209
  775. data/vendor/local/share/gtk-doc/html/gtk3/index.sgml +5994 -5707
  776. data/vendor/local/share/gtk-doc/html/gtk3/info-bar.png +0 -0
  777. data/vendor/local/share/gtk-doc/html/gtk3/label.png +0 -0
  778. data/vendor/local/share/gtk-doc/html/gtk3/left-insensitive.png +0 -0
  779. data/vendor/local/share/gtk-doc/html/gtk3/left.png +0 -0
  780. data/vendor/local/share/gtk-doc/html/gtk3/levelbar.png +0 -0
  781. data/vendor/local/share/gtk-doc/html/gtk3/link-button.png +0 -0
  782. data/vendor/local/share/gtk-doc/html/gtk3/list-and-tree.png +0 -0
  783. data/vendor/local/share/gtk-doc/html/gtk3/list-box.png +0 -0
  784. data/vendor/local/share/gtk-doc/html/gtk3/lock-button.png +0 -0
  785. data/vendor/local/share/gtk-doc/html/gtk3/menu-button.png +0 -0
  786. data/vendor/local/share/gtk-doc/html/gtk3/menubar.png +0 -0
  787. data/vendor/local/share/gtk-doc/html/gtk3/messagedialog.png +0 -0
  788. data/vendor/local/share/gtk-doc/html/gtk3/migrating.html +31 -31
  789. data/vendor/local/share/gtk-doc/html/gtk3/multiline-text.png +0 -0
  790. data/vendor/local/share/gtk-doc/html/gtk3/notebook.png +0 -0
  791. data/vendor/local/share/gtk-doc/html/gtk3/pagesetupdialog.png +0 -0
  792. data/vendor/local/share/gtk-doc/html/gtk3/panes.png +0 -0
  793. data/vendor/local/share/gtk-doc/html/gtk3/placessidebar.png +0 -0
  794. data/vendor/local/share/gtk-doc/html/gtk3/platform-support.html +75 -0
  795. data/vendor/local/share/gtk-doc/html/gtk3/printdialog.png +0 -0
  796. data/vendor/local/share/gtk-doc/html/gtk3/progressbar.png +0 -0
  797. data/vendor/local/share/gtk-doc/html/gtk3/pt06.html +9 -9
  798. data/vendor/local/share/gtk-doc/html/gtk3/radio-group.png +0 -0
  799. data/vendor/local/share/gtk-doc/html/gtk3/recentchooserdialog.png +0 -0
  800. data/vendor/local/share/gtk-doc/html/gtk3/right-insensitive.png +0 -0
  801. data/vendor/local/share/gtk-doc/html/gtk3/right.png +0 -0
  802. data/vendor/local/share/gtk-doc/html/gtk3/scales.png +0 -0
  803. data/vendor/local/share/gtk-doc/html/gtk3/scrollbar.png +0 -0
  804. data/vendor/local/share/gtk-doc/html/gtk3/scrolledwindow.png +0 -0
  805. data/vendor/local/share/gtk-doc/html/gtk3/search-entry.png +0 -0
  806. data/vendor/local/share/gtk-doc/html/gtk3/separator.png +0 -0
  807. data/vendor/local/share/gtk-doc/html/gtk3/spinbutton.png +0 -0
  808. data/vendor/local/share/gtk-doc/html/gtk3/spinner.png +0 -0
  809. data/vendor/local/share/gtk-doc/html/gtk3/stack.png +0 -0
  810. data/vendor/local/share/gtk-doc/html/gtk3/stackswitcher.png +0 -0
  811. data/vendor/local/share/gtk-doc/html/gtk3/statusbar.png +0 -0
  812. data/vendor/local/share/gtk-doc/html/gtk3/style.css +71 -16
  813. data/vendor/local/share/gtk-doc/html/gtk3/switch.png +0 -0
  814. data/vendor/local/share/gtk-doc/html/gtk3/theming.html +10 -10
  815. data/vendor/local/share/gtk-doc/html/gtk3/toggle-button.png +0 -0
  816. data/vendor/local/share/gtk-doc/html/gtk3/toolbar.png +0 -0
  817. data/vendor/local/share/gtk-doc/html/gtk3/toolpalette.png +0 -0
  818. data/vendor/local/share/gtk-doc/html/gtk3/up-insensitive.png +0 -0
  819. data/vendor/local/share/gtk-doc/html/gtk3/up.png +0 -0
  820. data/vendor/local/share/gtk-doc/html/gtk3/volumebutton.png +0 -0
  821. data/vendor/local/share/gtk-doc/html/gtk3/window-default.png +0 -0
  822. data/vendor/local/share/gtk-doc/html/gtk3/window.png +0 -0
  823. data/vendor/local/share/locale/af/LC_MESSAGES/gtk30.mo +0 -0
  824. data/vendor/local/share/locale/an/LC_MESSAGES/gtk30.mo +0 -0
  825. data/vendor/local/share/locale/ar/LC_MESSAGES/gtk30.mo +0 -0
  826. data/vendor/local/share/locale/as/LC_MESSAGES/gtk30-properties.mo +0 -0
  827. data/vendor/local/share/locale/as/LC_MESSAGES/gtk30.mo +0 -0
  828. data/vendor/local/share/locale/be/LC_MESSAGES/gtk30.mo +0 -0
  829. data/vendor/local/share/locale/bg/LC_MESSAGES/gtk30.mo +0 -0
  830. data/vendor/local/share/locale/bn/LC_MESSAGES/gtk30.mo +0 -0
  831. data/vendor/local/share/locale/bn_IN/LC_MESSAGES/gtk30.mo +0 -0
  832. data/vendor/local/share/locale/ca/LC_MESSAGES/gtk30-properties.mo +0 -0
  833. data/vendor/local/share/locale/ca/LC_MESSAGES/gtk30.mo +0 -0
  834. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gtk30-properties.mo +0 -0
  835. data/vendor/local/share/locale/ca@valencia/LC_MESSAGES/gtk30.mo +0 -0
  836. data/vendor/local/share/locale/cs/LC_MESSAGES/gtk30-properties.mo +0 -0
  837. data/vendor/local/share/locale/cs/LC_MESSAGES/gtk30.mo +0 -0
  838. data/vendor/local/share/locale/da/LC_MESSAGES/gtk30-properties.mo +0 -0
  839. data/vendor/local/share/locale/da/LC_MESSAGES/gtk30.mo +0 -0
  840. data/vendor/local/share/locale/de/LC_MESSAGES/gtk30-properties.mo +0 -0
  841. data/vendor/local/share/locale/de/LC_MESSAGES/gtk30.mo +0 -0
  842. data/vendor/local/share/locale/el/LC_MESSAGES/gtk30-properties.mo +0 -0
  843. data/vendor/local/share/locale/el/LC_MESSAGES/gtk30.mo +0 -0
  844. data/vendor/local/share/locale/en/LC_MESSAGES/gtk30.mo +0 -0
  845. data/vendor/local/share/locale/en_GB/LC_MESSAGES/gtk30.mo +0 -0
  846. data/vendor/local/share/locale/eo/LC_MESSAGES/gtk30.mo +0 -0
  847. data/vendor/local/share/locale/es/LC_MESSAGES/gtk30-properties.mo +0 -0
  848. data/vendor/local/share/locale/es/LC_MESSAGES/gtk30.mo +0 -0
  849. data/vendor/local/share/locale/et/LC_MESSAGES/gtk30.mo +0 -0
  850. data/vendor/local/share/locale/eu/LC_MESSAGES/gtk30-properties.mo +0 -0
  851. data/vendor/local/share/locale/eu/LC_MESSAGES/gtk30.mo +0 -0
  852. data/vendor/local/share/locale/fa/LC_MESSAGES/gtk30.mo +0 -0
  853. data/vendor/local/share/locale/fi/LC_MESSAGES/gtk30-properties.mo +0 -0
  854. data/vendor/local/share/locale/fi/LC_MESSAGES/gtk30.mo +0 -0
  855. data/vendor/local/share/locale/fr/LC_MESSAGES/gtk30-properties.mo +0 -0
  856. data/vendor/local/share/locale/fr/LC_MESSAGES/gtk30.mo +0 -0
  857. data/vendor/local/share/locale/ga/LC_MESSAGES/gtk30.mo +0 -0
  858. data/vendor/local/share/locale/gd/LC_MESSAGES/gtk30-properties.mo +0 -0
  859. data/vendor/local/share/locale/gd/LC_MESSAGES/gtk30.mo +0 -0
  860. data/vendor/local/share/locale/gl/LC_MESSAGES/gtk30-properties.mo +0 -0
  861. data/vendor/local/share/locale/gl/LC_MESSAGES/gtk30.mo +0 -0
  862. data/vendor/local/share/locale/gu/LC_MESSAGES/gtk30.mo +0 -0
  863. data/vendor/local/share/locale/he/LC_MESSAGES/gtk30-properties.mo +0 -0
  864. data/vendor/local/share/locale/he/LC_MESSAGES/gtk30.mo +0 -0
  865. data/vendor/local/share/locale/hi/LC_MESSAGES/gtk30.mo +0 -0
  866. data/vendor/local/share/locale/hu/LC_MESSAGES/gtk30-properties.mo +0 -0
  867. data/vendor/local/share/locale/hu/LC_MESSAGES/gtk30.mo +0 -0
  868. data/vendor/local/share/locale/ia/LC_MESSAGES/gtk30-properties.mo +0 -0
  869. data/vendor/local/share/locale/ia/LC_MESSAGES/gtk30.mo +0 -0
  870. data/vendor/local/share/locale/id/LC_MESSAGES/gtk30-properties.mo +0 -0
  871. data/vendor/local/share/locale/id/LC_MESSAGES/gtk30.mo +0 -0
  872. data/vendor/local/share/locale/it/LC_MESSAGES/gtk30-properties.mo +0 -0
  873. data/vendor/local/share/locale/it/LC_MESSAGES/gtk30.mo +0 -0
  874. data/vendor/local/share/locale/ja/LC_MESSAGES/gtk30.mo +0 -0
  875. data/vendor/local/share/locale/kk/LC_MESSAGES/gtk30.mo +0 -0
  876. data/vendor/local/share/locale/km/LC_MESSAGES/gtk30.mo +0 -0
  877. data/vendor/local/share/locale/kn/LC_MESSAGES/gtk30-properties.mo +0 -0
  878. data/vendor/local/share/locale/kn/LC_MESSAGES/gtk30.mo +0 -0
  879. data/vendor/local/share/locale/ko/LC_MESSAGES/gtk30-properties.mo +0 -0
  880. data/vendor/local/share/locale/ko/LC_MESSAGES/gtk30.mo +0 -0
  881. data/vendor/local/share/locale/lt/LC_MESSAGES/gtk30-properties.mo +0 -0
  882. data/vendor/local/share/locale/lt/LC_MESSAGES/gtk30.mo +0 -0
  883. data/vendor/local/share/locale/lv/LC_MESSAGES/gtk30-properties.mo +0 -0
  884. data/vendor/local/share/locale/lv/LC_MESSAGES/gtk30.mo +0 -0
  885. data/vendor/local/share/locale/ml/LC_MESSAGES/gtk30.mo +0 -0
  886. data/vendor/local/share/locale/mr/LC_MESSAGES/gtk30-properties.mo +0 -0
  887. data/vendor/local/share/locale/mr/LC_MESSAGES/gtk30.mo +0 -0
  888. data/vendor/local/share/locale/nb/LC_MESSAGES/gtk30.mo +0 -0
  889. data/vendor/local/share/locale/nl/LC_MESSAGES/gtk30.mo +0 -0
  890. data/vendor/local/share/locale/nn/LC_MESSAGES/gtk30.mo +0 -0
  891. data/vendor/local/share/locale/or/LC_MESSAGES/gtk30.mo +0 -0
  892. data/vendor/local/share/locale/pa/LC_MESSAGES/gtk30-properties.mo +0 -0
  893. data/vendor/local/share/locale/pa/LC_MESSAGES/gtk30.mo +0 -0
  894. data/vendor/local/share/locale/pl/LC_MESSAGES/gtk30-properties.mo +0 -0
  895. data/vendor/local/share/locale/pl/LC_MESSAGES/gtk30.mo +0 -0
  896. data/vendor/local/share/locale/pt/LC_MESSAGES/gtk30-properties.mo +0 -0
  897. data/vendor/local/share/locale/pt/LC_MESSAGES/gtk30.mo +0 -0
  898. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gtk30-properties.mo +0 -0
  899. data/vendor/local/share/locale/pt_BR/LC_MESSAGES/gtk30.mo +0 -0
  900. data/vendor/local/share/locale/ro/LC_MESSAGES/gtk30.mo +0 -0
  901. data/vendor/local/share/locale/ru/LC_MESSAGES/gtk30-properties.mo +0 -0
  902. data/vendor/local/share/locale/ru/LC_MESSAGES/gtk30.mo +0 -0
  903. data/vendor/local/share/locale/sk/LC_MESSAGES/gtk30-properties.mo +0 -0
  904. data/vendor/local/share/locale/sk/LC_MESSAGES/gtk30.mo +0 -0
  905. data/vendor/local/share/locale/sl/LC_MESSAGES/gtk30-properties.mo +0 -0
  906. data/vendor/local/share/locale/sl/LC_MESSAGES/gtk30.mo +0 -0
  907. data/vendor/local/share/locale/sr/LC_MESSAGES/gtk30-properties.mo +0 -0
  908. data/vendor/local/share/locale/sr/LC_MESSAGES/gtk30.mo +0 -0
  909. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gtk30-properties.mo +0 -0
  910. data/vendor/local/share/locale/sr@latin/LC_MESSAGES/gtk30.mo +0 -0
  911. data/vendor/local/share/locale/sv/LC_MESSAGES/gtk30.mo +0 -0
  912. data/vendor/local/share/locale/ta/LC_MESSAGES/gtk30-properties.mo +0 -0
  913. data/vendor/local/share/locale/ta/LC_MESSAGES/gtk30.mo +0 -0
  914. data/vendor/local/share/locale/te/LC_MESSAGES/gtk30.mo +0 -0
  915. data/vendor/local/share/locale/tg/LC_MESSAGES/gtk30-properties.mo +0 -0
  916. data/vendor/local/share/locale/tg/LC_MESSAGES/gtk30.mo +0 -0
  917. data/vendor/local/share/locale/th/LC_MESSAGES/gtk30.mo +0 -0
  918. data/vendor/local/share/locale/ug/LC_MESSAGES/gtk30-properties.mo +0 -0
  919. data/vendor/local/share/locale/ug/LC_MESSAGES/gtk30.mo +0 -0
  920. data/vendor/local/share/locale/uk/LC_MESSAGES/gtk30.mo +0 -0
  921. data/vendor/local/share/locale/vi/LC_MESSAGES/gtk30.mo +0 -0
  922. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gtk30-properties.mo +0 -0
  923. data/vendor/local/share/locale/zh_CN/LC_MESSAGES/gtk30.mo +0 -0
  924. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gtk30-properties.mo +0 -0
  925. data/vendor/local/share/locale/zh_HK/LC_MESSAGES/gtk30.mo +0 -0
  926. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gtk30-properties.mo +0 -0
  927. data/vendor/local/share/locale/zh_TW/LC_MESSAGES/gtk30.mo +0 -0
  928. data/vendor/local/share/man/man1/broadwayd.1 +1 -1
  929. data/vendor/local/share/man/man1/gtk-launch.1 +1 -1
  930. data/vendor/local/share/man/man1/gtk-query-immodules-3.0.1 +1 -1
  931. data/vendor/local/share/man/man1/gtk-update-icon-cache.1 +1 -1
  932. metadata +86 -39
  933. data/vendor/local/lib/gdk-win32-3.0.def +0 -539
  934. data/vendor/local/lib/gtk-win32-3.0.def +0 -3875
  935. data/vendor/local/share/gtk-doc/html/gtk3/Actions.html +0 -53
  936. data/vendor/local/share/gtk-doc/html/gtk3/GtkPlug.html +0 -388
  937. data/vendor/local/share/gtk-doc/html/gtk3/GtkSocket.html +0 -362
  938. data/vendor/local/share/gtk-doc/html/gtk3/colorsel.png +0 -0
  939. data/vendor/local/share/gtk-doc/html/gtk3/fontsel.png +0 -0
data/vendor/local/share/gtk-doc/html/gtk3/ch01s05.html ADDED
@@ -0,0 +1,1773 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
+ <html>
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
+ <title>GTK+ 3 Reference Manual: Building applications</title>
6
+ <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
+ <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
8
+ <link rel="up" href="gtk-getting-started.html" title="Getting Started with GTK+">
9
+ <link rel="prev" href="ch01s04.html" title="Building user interfaces">
10
+ <link rel="next" href="gtk-resources.html" title="Mailing lists and bug reports">
11
+ <meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
12
+ <link rel="stylesheet" href="style.css" type="text/css">
13
+ </head>
14
+ <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
+ <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
16
+ <td width="100%" align="left"></td>
17
+ <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
18
+ <td><a accesskey="u" href="gtk-getting-started.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
19
+ <td><a accesskey="p" href="ch01s04.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
20
+ <td><a accesskey="n" href="gtk-resources.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
21
+ </tr></table>
22
+ <div class="section">
23
+ <div class="titlepage"><div><div><h2 class="title" style="clear: both">
24
+ <a name="id-1.2.3.7"></a>Building applications</h2></div></div></div>
25
+ <p>An application consists of a number of files:
26
+ </p>
27
+ <div class="variablelist"><table border="0" class="variablelist">
28
+ <colgroup>
29
+ <col align="left" valign="top">
30
+ <col>
31
+ </colgroup>
32
+ <tbody>
33
+ <tr>
34
+ <td><p><span class="term">The binary</span></p></td>
35
+ <td>This gets installed in <code class="filename">/usr/bin</code>.</td>
36
+ </tr>
37
+ <tr>
38
+ <td><p><span class="term">A desktop file</span></p></td>
39
+ <td>The desktop file provides important information about the application to the desktop shell, such as its name, icon, D-Bus name, commandline to launch it, etc. It is installed in <code class="filename">/usr/share/applications</code>.</td>
40
+ </tr>
41
+ <tr>
42
+ <td><p><span class="term">An icon</span></p></td>
43
+ <td>The icon gets installed in <code class="filename">/usr/share/icons/hicolor/48x48/apps</code>, where it will be found regardless of the current theme.</td>
44
+ </tr>
45
+ <tr>
46
+ <td><p><span class="term">A settings schema</span></p></td>
47
+ <td>If the application uses GSettings, it will install its schema
48
+ in <code class="filename">/usr/share/glib-2.0/schemas</code>, so that tools
49
+ like dconf-editor can find it.</td>
50
+ </tr>
51
+ <tr>
52
+ <td><p><span class="term">Other resources</span></p></td>
53
+ <td>Other files, such as GtkBuilder ui files, are best loaded from
54
+ resources stored in the application binary itself. This eliminates the
55
+ need for most of the files that would traditionally be installed in
56
+ an application-specific location in <code class="filename">/usr/share</code>.</td>
57
+ </tr>
58
+ </tbody>
59
+ </table></div>
60
+ <p>
61
+ </p>
62
+ <p>GTK+ includes application support that is built on top of
63
+ <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GApplication.html"><span class="type">GApplication</span></a>. In this tutorial we'll build a simple application by
64
+ starting from scratch, adding more and more pieces over time. Along
65
+ the way, we'll learn about <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a>, templates, resources,
66
+ application menus, settings, <a class="link" href="GtkHeaderBar.html" title="GtkHeaderBar"><span class="type">GtkHeaderBar</span></a>, <a class="link" href="GtkStack.html" title="GtkStack"><span class="type">GtkStack</span></a>, <a class="link" href="GtkSearchBar.html" title="GtkSearchBar"><span class="type">GtkSearchBar</span></a>,
67
+ <a class="link" href="GtkListBox.html" title="GtkListBox"><span class="type">GtkListBox</span></a>, and more.</p>
68
+ <p>The full, buildable sources for these examples can be found
69
+ in the examples/ directory of the GTK+ source distribution, or
70
+ <a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples" target="_top">online</a> in the GTK+ git repository.</p>
71
+ <div class="section">
72
+ <div class="titlepage"><div><div><h3 class="title">
73
+ <a name="id-1.2.3.7.5"></a>A trivial application</h3></div></div></div>
74
+ <p>When using <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a>, the <code class="function">main()</code> function can be very
75
+ simple. We just call <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GApplication.html#g-application-run"><code class="function">g_application_run()</code></a> and give it an instance
76
+ of our application class.</p>
77
+ <div class="informalexample">
78
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
79
+ <tbody>
80
+ <tr>
81
+ <td class="listing_lines" align="right"><pre>1
82
+ 2
83
+ 3
84
+ 4
85
+ 5
86
+ 6
87
+ 7
88
+ 8</pre></td>
89
+ <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;gtk/gtk.h&gt;</span>
90
+ <span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;exampleapp.h&gt;</span>
91
+
92
+ <span class="type">int</span>
93
+ <span class="function">main</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">argv</span><span class="symbol">[])</span>
94
+ <span class="cbracket">{</span>
95
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GApplication.html#g-application-run">g_application_run</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">G_APPLICATION</span><span class="normal"> </span><span class="symbol">(</span><span class="function">example_app_new</span><span class="normal"> </span><span class="symbol">()),</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> argv</span><span class="symbol">);</span>
96
+ <span class="cbracket">}</span></pre></td>
97
+ </tr>
98
+ </tbody>
99
+ </table>
100
+ </div>
101
+
102
+ <p>All the application logic is in the application class, which
103
+ is a subclass of <a class="link" href="GtkApplication.html" title="GtkApplication"><span class="type">GtkApplication</span></a>. Our example does not yet have any
104
+ interesting functionality. All it does is open a window when it is
105
+ activated without arguments, and open the files it is given, if it
106
+ is started with arguments.</p>
107
+ <p>To handle these two cases, we override the <code class="function">activate()</code> vfunc,
108
+ which gets called when the application is launched without commandline
109
+ arguments, and the <code class="function">open()</code> vfunc, which gets called when the application
110
+ is launched with commandline arguments.</p>
111
+ <p>To learn more about GApplication entry points, consult the
112
+ GIO <a class="ulink" href="https://developer.gnome.org/gio/2.36/GApplication.html#GApplication.description" target="_top">documentation</a>.</p>
113
+ <div class="informalexample">
114
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
115
+ <tbody>
116
+ <tr>
117
+ <td class="listing_lines" align="right"><pre>1
118
+ 2
119
+ 3
120
+ 4
121
+ 5
122
+ 6
123
+ 7
124
+ 8
125
+ 9
126
+ 10
127
+ 11
128
+ 12
129
+ 13
130
+ 14
131
+ 15
132
+ 16
133
+ 17
134
+ 18
135
+ 19
136
+ 20
137
+ 21
138
+ 22
139
+ 23
140
+ 24
141
+ 25
142
+ 26
143
+ 27
144
+ 28
145
+ 29
146
+ 30
147
+ 31
148
+ 32
149
+ 33
150
+ 34
151
+ 35
152
+ 36
153
+ 37
154
+ 38
155
+ 39
156
+ 40
157
+ 41
158
+ 42
159
+ 43
160
+ 44
161
+ 45
162
+ 46
163
+ 47
164
+ 48
165
+ 49
166
+ 50
167
+ 51
168
+ 52
169
+ 53
170
+ 54
171
+ 55
172
+ 56
173
+ 57
174
+ 58
175
+ 59
176
+ 60
177
+ 61
178
+ 62
179
+ 63
180
+ 64
181
+ 65
182
+ 66
183
+ 67
184
+ 68</pre></td>
185
+ <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;gtk/gtk.h&gt;</span>
186
+
187
+ <span class="preproc">#include</span><span class="normal"> </span><span class="string">"exampleapp.h"</span>
188
+ <span class="preproc">#include</span><span class="normal"> </span><span class="string">"exampleappwin.h"</span>
189
+
190
+ <span class="keyword">struct</span><span class="normal"> </span><span class="classname">_ExampleApp</span>
191
+ <span class="cbracket">{</span>
192
+ <span class="normal"> </span><span class="usertype">GtkApplication</span><span class="normal"> parent</span><span class="symbol">;</span>
193
+ <span class="cbracket">}</span><span class="symbol">;</span>
194
+
195
+ <span class="keyword">struct</span><span class="normal"> </span><span class="classname">_ExampleAppClass</span>
196
+ <span class="cbracket">{</span>
197
+ <span class="normal"> </span><span class="usertype">GtkApplicationClass</span><span class="normal"> parent_class</span><span class="symbol">;</span>
198
+ <span class="cbracket">}</span><span class="symbol">;</span>
199
+
200
+ <span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-DEFINE-TYPE:CAPS">G_DEFINE_TYPE</a></span><span class="symbol">(</span><span class="normal">ExampleApp</span><span class="symbol">,</span><span class="normal"> example_app</span><span class="symbol">,</span><span class="normal"> GTK_TYPE_APPLICATION</span><span class="symbol">);</span>
201
+
202
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
203
+ <span class="function">example_app_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ExampleApp</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">app</span><span class="symbol">)</span>
204
+ <span class="cbracket">{</span>
205
+ <span class="cbracket">}</span>
206
+
207
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
208
+ <span class="function">example_app_activate</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GApplication</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">app</span><span class="symbol">)</span>
209
+ <span class="cbracket">{</span>
210
+ <span class="normal"> </span><span class="usertype">ExampleAppWindow</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">win</span><span class="symbol">;</span>
211
+
212
+ <span class="normal"> win </span><span class="symbol">=</span><span class="normal"> </span><span class="function">example_app_window_new</span><span class="normal"> </span><span class="symbol">(</span><span class="function">EXAMPLE_APP</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">));</span>
213
+ <span class="normal"> </span><span class="function"><a href="GtkWindow.html#gtk-window-present">gtk_window_present</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WINDOW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">win</span><span class="symbol">));</span>
214
+ <span class="cbracket">}</span>
215
+
216
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
217
+ <span class="function">example_app_open</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GApplication</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">app</span><span class="symbol">,</span>
218
+ <span class="normal"> </span><span class="usertype">GFile</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">files</span><span class="symbol">,</span>
219
+ <span class="normal"> </span><span class="usertype">gint</span><span class="normal"> n_files</span><span class="symbol">,</span>
220
+ <span class="normal"> </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">hint</span><span class="symbol">)</span>
221
+ <span class="cbracket">{</span>
222
+ <span class="normal"> </span><span class="usertype">GList</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">windows</span><span class="symbol">;</span>
223
+ <span class="normal"> </span><span class="usertype">ExampleAppWindow</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">win</span><span class="symbol">;</span>
224
+ <span class="normal"> </span><span class="type">int</span><span class="normal"> i</span><span class="symbol">;</span>
225
+
226
+ <span class="normal"> windows </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkApplication.html#gtk-application-get-windows">gtk_application_get_windows</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_APPLICATION</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">));</span>
227
+ <span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">windows</span><span class="symbol">)</span>
228
+ <span class="normal"> win </span><span class="symbol">=</span><span class="normal"> </span><span class="function">EXAMPLE_APP_WINDOW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">windows</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">);</span>
229
+ <span class="normal"> </span><span class="keyword">else</span>
230
+ <span class="normal"> win </span><span class="symbol">=</span><span class="normal"> </span><span class="function">example_app_window_new</span><span class="normal"> </span><span class="symbol">(</span><span class="function">EXAMPLE_APP</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">app</span><span class="symbol">));</span>
231
+
232
+ <span class="normal"> </span><span class="keyword">for</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span><span class="normal"> i </span><span class="symbol">&lt;</span><span class="normal"> n_files</span><span class="symbol">;</span><span class="normal"> i</span><span class="symbol">++)</span>
233
+ <span class="normal"> </span><span class="function">example_app_window_open</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">win</span><span class="symbol">,</span><span class="normal"> files</span><span class="symbol">[</span><span class="normal">i</span><span class="symbol">]);</span>
234
+
235
+ <span class="normal"> </span><span class="function"><a href="GtkWindow.html#gtk-window-present">gtk_window_present</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WINDOW</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">win</span><span class="symbol">));</span>
236
+ <span class="cbracket">}</span>
237
+
238
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
239
+ <span class="function">example_app_class_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ExampleAppClass</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">class</span><span class="symbol">)</span>
240
+ <span class="cbracket">{</span>
241
+ <span class="normal"> </span><span class="function">G_APPLICATION_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">class</span><span class="symbol">)-&gt;</span><span class="normal">activate </span><span class="symbol">=</span><span class="normal"> example_app_activate</span><span class="symbol">;</span>
242
+ <span class="normal"> </span><span class="function">G_APPLICATION_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">class</span><span class="symbol">)-&gt;</span><span class="normal">open </span><span class="symbol">=</span><span class="normal"> example_app_open</span><span class="symbol">;</span>
243
+ <span class="cbracket">}</span>
244
+
245
+ <span class="normal">ExampleApp </span><span class="symbol">*</span>
246
+ <span class="function">example_app_new</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
247
+ <span class="cbracket">{</span>
248
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">EXAMPLE_APP_TYPE</span><span class="symbol">,</span>
249
+ <span class="normal"> </span><span class="string">"application-id"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"org.gtk.exampleapp"</span><span class="symbol">,</span>
250
+ <span class="normal"> </span><span class="string">"flags"</span><span class="symbol">,</span><span class="normal"> <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GApplication.html#G-APPLICATION-HANDLES-OPEN:CAPS">G_APPLICATION_HANDLES_OPEN</a></span><span class="symbol">,</span>
251
+ <span class="normal"> <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
252
+ <span class="cbracket">}</span></pre></td>
253
+ </tr>
254
+ </tbody>
255
+ </table>
256
+ </div>
257
+
258
+ <p>Another important class that is part of the application support
259
+ in GTK+ is <a class="link" href="GtkApplicationWindow.html" title="GtkApplicationWindow"><span class="type">GtkApplicationWindow</span></a>. It is typically subclassed as well.
260
+ Our subclass does not do anything yet, so we will just get an empty
261
+ window.</p>
262
+ <div class="informalexample">
263
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
264
+ <tbody>
265
+ <tr>
266
+ <td class="listing_lines" align="right"><pre>1
267
+ 2
268
+ 3
269
+ 4
270
+ 5
271
+ 6
272
+ 7
273
+ 8
274
+ 9
275
+ 10
276
+ 11
277
+ 12
278
+ 13
279
+ 14
280
+ 15
281
+ 16
282
+ 17
283
+ 18
284
+ 19
285
+ 20
286
+ 21
287
+ 22
288
+ 23
289
+ 24
290
+ 25
291
+ 26
292
+ 27
293
+ 28
294
+ 29
295
+ 30
296
+ 31
297
+ 32
298
+ 33
299
+ 34
300
+ 35
301
+ 36
302
+ 37</pre></td>
303
+ <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">"exampleapp.h"</span>
304
+ <span class="preproc">#include</span><span class="normal"> </span><span class="string">"exampleappwin.h"</span>
305
+ <span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;gtk/gtk.h&gt;</span>
306
+
307
+ <span class="keyword">struct</span><span class="normal"> </span><span class="classname">_ExampleAppWindow</span>
308
+ <span class="cbracket">{</span>
309
+ <span class="normal"> </span><span class="usertype">GtkApplicationWindow</span><span class="normal"> parent</span><span class="symbol">;</span>
310
+ <span class="cbracket">}</span><span class="symbol">;</span>
311
+
312
+ <span class="keyword">struct</span><span class="normal"> </span><span class="classname">_ExampleAppWindowClass</span>
313
+ <span class="cbracket">{</span>
314
+ <span class="normal"> </span><span class="usertype">GtkApplicationWindowClass</span><span class="normal"> parent_class</span><span class="symbol">;</span>
315
+ <span class="cbracket">}</span><span class="symbol">;</span>
316
+
317
+ <span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-DEFINE-TYPE:CAPS">G_DEFINE_TYPE</a></span><span class="symbol">(</span><span class="normal">ExampleAppWindow</span><span class="symbol">,</span><span class="normal"> example_app_window</span><span class="symbol">,</span><span class="normal"> GTK_TYPE_APPLICATION_WINDOW</span><span class="symbol">);</span>
318
+
319
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
320
+ <span class="function">example_app_window_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ExampleAppWindow</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">app</span><span class="symbol">)</span>
321
+ <span class="cbracket">{</span>
322
+ <span class="cbracket">}</span>
323
+
324
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
325
+ <span class="function">example_app_window_class_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ExampleAppWindowClass</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">class</span><span class="symbol">)</span>
326
+ <span class="cbracket">{</span>
327
+ <span class="cbracket">}</span>
328
+
329
+ <span class="normal">ExampleAppWindow </span><span class="symbol">*</span>
330
+ <span class="function">example_app_window_new</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ExampleApp</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">app</span><span class="symbol">)</span>
331
+ <span class="cbracket">{</span>
332
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">EXAMPLE_APP_WINDOW_TYPE</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"application"</span><span class="symbol">,</span><span class="normal"> app</span><span class="symbol">,</span><span class="normal"> <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
333
+ <span class="cbracket">}</span>
334
+
335
+ <span class="type">void</span>
336
+ <span class="function">example_app_window_open</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ExampleAppWindow</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">win</span><span class="symbol">,</span>
337
+ <span class="normal"> </span><span class="usertype">GFile</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">file</span><span class="symbol">)</span>
338
+ <span class="cbracket">{</span>
339
+ <span class="cbracket">}</span></pre></td>
340
+ </tr>
341
+ </tbody>
342
+ </table>
343
+ </div>
344
+
345
+ <p>As part of the initial setup of our application, we also
346
+ create an icon and a desktop file.</p>
347
+ <div class="informalfigure"><div class="mediaobject"><img src="exampleapp.png"></div></div>
348
+ <div class="informalexample">
349
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
350
+ <tbody>
351
+ <tr>
352
+ <td class="listing_lines" align="right"><pre>1
353
+ 2
354
+ 3
355
+ 4
356
+ 5
357
+ 6</pre></td>
358
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">[</span><span class="usertype">Desktop</span><span class="normal"> Entry</span><span class="symbol">]</span>
359
+ <span class="normal">Type</span><span class="symbol">=</span><span class="normal">Application</span>
360
+ <span class="normal">Name</span><span class="symbol">=</span><span class="normal">Example</span>
361
+ <span class="normal">Icon</span><span class="symbol">=</span><span class="normal">exampleapp</span>
362
+ <span class="normal">StartupNotify</span><span class="symbol">=</span><span class="normal">true</span>
363
+ <span class="normal">Exec</span><span class="symbol">=</span><span class="normal">@bindir@</span><span class="symbol">/</span><span class="normal">exampleapp</span></pre></td>
364
+ </tr>
365
+ </tbody>
366
+ </table>
367
+ </div>
368
+
369
+ <p>Note that <em class="replaceable"><code>@bindir@</code></em> needs to be replaced
370
+ with the actual path to the binary before this desktop file can be used.</p>
371
+ <p>Here is what we've achieved so far:</p>
372
+ <div class="informalfigure"><div class="mediaobject"><img src="getting-started-app1.png"></div></div>
373
+ <p>This does not look very impressive yet, but our application
374
+ is already presenting itself on the session bus, it has single-instance
375
+ semantics, and it accepts files as commandline arguments.</p>
376
+ </div>
377
+ <div class="section">
378
+ <div class="titlepage"><div><div><h3 class="title">
379
+ <a name="id-1.2.3.7.6"></a>Populating the window</h3></div></div></div>
380
+ <p>In this step, we use a <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> template to associate a
381
+ <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> ui file with our application window class.</p>
382
+ <p>Our simple ui file puts a <a class="link" href="GtkHeaderBar.html" title="GtkHeaderBar"><span class="type">GtkHeaderBar</span></a> on top of a <a class="link" href="GtkStack.html" title="GtkStack"><span class="type">GtkStack</span></a>
383
+ widget. The header bar contains a <a class="link" href="GtkStackSwitcher.html" title="GtkStackSwitcher"><span class="type">GtkStackSwitcher</span></a>, which is a
384
+ standalone widget to show a row of 'tabs' for the pages of a <a class="link" href="GtkStack.html" title="GtkStack"><span class="type">GtkStack</span></a>.
385
+ </p>
386
+ <div class="informalexample">
387
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
388
+ <tbody>
389
+ <tr>
390
+ <td class="listing_lines" align="right"><pre>1
391
+ 2
392
+ 3
393
+ 4
394
+ 5
395
+ 6
396
+ 7
397
+ 8
398
+ 9
399
+ 10
400
+ 11
401
+ 12
402
+ 13
403
+ 14
404
+ 15
405
+ 16
406
+ 17
407
+ 18
408
+ 19
409
+ 20
410
+ 21
411
+ 22
412
+ 23
413
+ 24
414
+ 25
415
+ 26
416
+ 27
417
+ 28
418
+ 29
419
+ 30
420
+ 31</pre></td>
421
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="usertype">xml</span><span class="normal"> version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="normal"> encoding</span><span class="symbol">=</span><span class="string">"UTF-8"</span><span class="symbol">?&gt;</span>
422
+ <span class="symbol">&lt;</span><span class="normal">interface</span><span class="symbol">&gt;</span>
423
+ <span class="normal"> </span><span class="symbol">&lt;!--</span><span class="normal"> interface</span><span class="symbol">-</span><span class="usertype">requires</span><span class="normal"> gtk</span><span class="symbol">+</span><span class="normal"> </span><span class="number">3.8</span><span class="normal"> </span><span class="symbol">--&gt;</span>
424
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">template</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"ExampleAppWindow"</span><span class="normal"> parent</span><span class="symbol">=</span><span class="string">"GtkApplicationWindow"</span><span class="symbol">&gt;</span>
425
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"title"</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="symbol">&gt;</span><span class="usertype">Example</span><span class="normal"> Application</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
426
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"default-width"</span><span class="symbol">&gt;</span><span class="number">600</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
427
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"default-height"</span><span class="symbol">&gt;</span><span class="number">400</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
428
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
429
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkBox"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"content_box"</span><span class="symbol">&gt;</span>
430
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
431
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"orientation"</span><span class="symbol">&gt;</span><span class="normal">vertical</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
432
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
433
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkHeaderBar"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"header"</span><span class="symbol">&gt;</span>
434
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
435
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">child</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"title"</span><span class="symbol">&gt;</span>
436
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkStackSwitcher"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"tabs"</span><span class="symbol">&gt;</span>
437
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
438
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"stack"</span><span class="symbol">&gt;</span><span class="normal">stack</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
439
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
440
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
441
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
442
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
443
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
444
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkStack"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"stack"</span><span class="symbol">&gt;</span>
445
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
446
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
447
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
448
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
449
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
450
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">template</span><span class="symbol">&gt;</span>
451
+ <span class="symbol">&lt;/</span><span class="normal">interface</span><span class="symbol">&gt;</span></pre></td>
452
+ </tr>
453
+ </tbody>
454
+ </table>
455
+ </div>
456
+
457
+ <p>To make use of this file in our application, we revisit
458
+ our <a class="link" href="GtkApplicationWindow.html" title="GtkApplicationWindow"><span class="type">GtkApplicationWindow</span></a> subclass, and call
459
+ <a class="link" href="GtkWidget.html#gtk-widget-class-set-template-from-resource" title="gtk_widget_class_set_template_from_resource ()"><code class="function">gtk_widget_class_set_template_from_resource()</code></a> from the class init
460
+ function to set the ui file as template for this class. We also
461
+ add a call to <a class="link" href="GtkWidget.html#gtk-widget-init-template" title="gtk_widget_init_template ()"><code class="function">gtk_widget_init_template()</code></a> in the instance init
462
+ function to instantiate the template for each instance of our
463
+ class.</p>
464
+ <div class="informalexample">
465
+ <pre class="programlisting">
466
+ ...
467
+
468
+ static void
469
+ example_app_window_init (ExampleAppWindow *win)
470
+ {
471
+ gtk_widget_init_template (GTK_WIDGET (win));
472
+ }
473
+
474
+ static void
475
+ example_app_window_class_init (ExampleAppWindowClass *class)
476
+ {
477
+ gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (class),
478
+ "/org/gtk/exampleapp/window.ui");
479
+ }
480
+
481
+ ...
482
+ </pre>
483
+ <p>(<a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application2/exampleappwin.c" target="_top">full source</a>)</p>
484
+ </div>
485
+ <p>You may have noticed that we used the <code class="function">_from_resource()</code> variant
486
+ of the function that sets a template. Now we need to use GLib's resource
487
+ functionality to include the ui file in the binary. This is commonly
488
+ done by listing all resources in a .gresource.xml file, such as this:
489
+ </p>
490
+ <div class="informalexample">
491
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
492
+ <tbody>
493
+ <tr>
494
+ <td class="listing_lines" align="right"><pre>1
495
+ 2
496
+ 3
497
+ 4
498
+ 5
499
+ 6</pre></td>
500
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="usertype">xml</span><span class="normal"> version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="normal"> encoding</span><span class="symbol">=</span><span class="string">"UTF-8"</span><span class="symbol">?&gt;</span>
501
+ <span class="symbol">&lt;</span><span class="normal">gresources</span><span class="symbol">&gt;</span>
502
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">gresource</span><span class="normal"> prefix</span><span class="symbol">=</span><span class="string">"/org/gtk/exampleapp"</span><span class="symbol">&gt;</span>
503
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">file</span><span class="normal"> preprocess</span><span class="symbol">=</span><span class="string">"xml-stripblanks"</span><span class="symbol">&gt;</span><span class="normal">window</span><span class="symbol">.</span><span class="normal">ui</span><span class="symbol">&lt;/</span><span class="normal">file</span><span class="symbol">&gt;</span>
504
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">gresource</span><span class="symbol">&gt;</span>
505
+ <span class="symbol">&lt;/</span><span class="normal">gresources</span><span class="symbol">&gt;</span></pre></td>
506
+ </tr>
507
+ </tbody>
508
+ </table>
509
+ </div>
510
+
511
+ <p>This file has to be converted into a C source file that will be
512
+ compiled and linked into the application together with the other source
513
+ files. To do so, we use the glib-compile-resources utility:</p>
514
+ <pre class="screen">
515
+ glib-compile-resources exampleapp.gresource.xml --target=resources.c --generate-source
516
+ </pre>
517
+ <p>Our application now looks like this:</p>
518
+ <div class="informalfigure"><div class="mediaobject"><img src="getting-started-app2.png"></div></div>
519
+ </div>
520
+ <div class="section">
521
+ <div class="titlepage"><div><div><h3 class="title">
522
+ <a name="id-1.2.3.7.7"></a>Opening files</h3></div></div></div>
523
+ <p>In this step, we make our application show the content of
524
+ all the files that it is given on the commandline.</p>
525
+ <p>To this end, we add a private struct to our application
526
+ window subclass and keep a reference to the <a class="link" href="GtkStack.html" title="GtkStack"><span class="type">GtkStack</span></a> there.
527
+ The <code class="function">gtk_widget_class_bind_child()</code> function arranges things so
528
+ that after instantiating the template, the <em class="parameter"><code>stack</code></em> member of
529
+ the private struct will point to the widget of the same name
530
+ from the template.</p>
531
+ <div class="informalexample">
532
+ <pre class="programlisting">
533
+ ...
534
+
535
+ struct _ExampleAppWindowPrivate
536
+ {
537
+ GtkWidget *stack;
538
+ };
539
+
540
+ G_DEFINE_TYPE_WITH_PRIVATE(ExampleAppWindow, example_app_window, GTK_TYPE_APPLICATION_WINDOW);
541
+
542
+ ...
543
+
544
+ static void
545
+ example_app_window_class_init (ExampleAppWindowClass *class)
546
+ {
547
+ gtk_widget_class_set_template_from_resource (GTK_WIDGET_CLASS (class),
548
+ "/org/gtk/exampleapp/window.ui");
549
+ gtk_widget_class_bind_template_child_private (GTK_WIDGET_CLASS (class), ExampleAppWindow, stack);
550
+ }
551
+
552
+ ...
553
+ </pre>
554
+ <p>(<a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application3/exampleappwin.c" target="_top">full source</a>)</p>
555
+ </div>
556
+ <p>Now we revisit the <code class="function">example_app_window_open()</code> function that
557
+ is called for each commandline argument, and construct a GtkTextView
558
+ that we then add as a page to the stack:</p>
559
+ <div class="informalexample">
560
+ <pre class="programlisting">
561
+ ...
562
+
563
+ void
564
+ example_app_window_open (ExampleAppWindow *win,
565
+ GFile *file)
566
+ {
567
+ ExampleAppWindowPrivate *priv;
568
+ gchar *basename;
569
+ GtkWidget *scrolled, *view;
570
+ gchar *contents;
571
+ gsize length;
572
+
573
+ priv = example_app_window_get_instance_private (win);
574
+ basename = g_file_get_basename (file);
575
+
576
+ scrolled = gtk_scrolled_window_new (NULL, NULL);
577
+ gtk_widget_show (scrolled);
578
+ gtk_widget_set_hexpand (scrolled, TRUE);
579
+ gtk_widget_set_vexpand (scrolled, TRUE);
580
+ view = gtk_text_view_new ();
581
+ gtk_text_view_set_editable (GTK_TEXT_VIEW (view), FALSE);
582
+ gtk_text_view_set_cursor_visible (GTK_TEXT_VIEW (view), FALSE);
583
+ gtk_widget_show (view);
584
+ gtk_container_add (GTK_CONTAINER (scrolled), view);
585
+ gtk_stack_add_titled (GTK_STACK (priv-&gt;stack), scrolled, basename, basename);
586
+
587
+ if (g_file_load_contents (file, NULL, &amp;contents, &amp;length, NULL, NULL))
588
+ {
589
+ GtkTextBuffer *buffer;
590
+
591
+ buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (view));
592
+ gtk_text_buffer_set_text (buffer, contents, length);
593
+ g_free (contents);
594
+ }
595
+
596
+ g_free (basename);
597
+ }
598
+
599
+ ...
600
+ </pre>
601
+ <p>(<a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application3/exampleappwin.c" target="_top">full source</a>)</p>
602
+ </div>
603
+ <p>Note that we did not have to touch the stack switcher
604
+ at all. It gets all its information from the stack that it
605
+ belongs to. Here, we are passing the label to show for each
606
+ file as the last argument to the <a class="link" href="GtkStack.html#gtk-stack-add-titled" title="gtk_stack_add_titled ()"><code class="function">gtk_stack_add_titled()</code></a>
607
+ function.</p>
608
+ <p>Our application is beginning to take shape:</p>
609
+ <div class="informalfigure"><div class="mediaobject"><img src="getting-started-app3.png"></div></div>
610
+ </div>
611
+ <div class="section">
612
+ <div class="titlepage"><div><div><h3 class="title">
613
+ <a name="id-1.2.3.7.8"></a>An application menu</h3></div></div></div>
614
+ <p>An application menu is shown by GNOME shell at the top of the
615
+ screen. It is meant to collect infrequently used actions that affect
616
+ the whole application.</p>
617
+ <p>Just like the window template, we specify our application menu
618
+ in a ui file, and add it as a resource to our binary.</p>
619
+ <div class="informalexample">
620
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
621
+ <tbody>
622
+ <tr>
623
+ <td class="listing_lines" align="right"><pre>1
624
+ 2
625
+ 3
626
+ 4
627
+ 5
628
+ 6
629
+ 7
630
+ 8
631
+ 9
632
+ 10
633
+ 11
634
+ 12
635
+ 13
636
+ 14
637
+ 15
638
+ 16
639
+ 17
640
+ 18
641
+ 19</pre></td>
642
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="usertype">xml</span><span class="normal"> version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="symbol">?&gt;</span>
643
+ <span class="symbol">&lt;</span><span class="normal">interface</span><span class="symbol">&gt;</span>
644
+ <span class="normal"> </span><span class="symbol">&lt;!--</span><span class="normal"> interface</span><span class="symbol">-</span><span class="usertype">requires</span><span class="normal"> gtk</span><span class="symbol">+</span><span class="normal"> </span><span class="number">3.0</span><span class="normal"> </span><span class="symbol">--&gt;</span>
645
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">menu</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"appmenu"</span><span class="symbol">&gt;</span>
646
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">section</span><span class="symbol">&gt;</span>
647
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">item</span><span class="symbol">&gt;</span>
648
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="symbol">&gt;</span><span class="normal">_Preferences</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
649
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"action"</span><span class="symbol">&gt;</span><span class="normal">app</span><span class="symbol">.</span><span class="normal">preferences</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
650
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
651
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">section</span><span class="symbol">&gt;</span>
652
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">section</span><span class="symbol">&gt;</span>
653
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">item</span><span class="symbol">&gt;</span>
654
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="symbol">&gt;</span><span class="normal">_Quit</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
655
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"action"</span><span class="symbol">&gt;</span><span class="normal">app</span><span class="symbol">.</span><span class="normal">quit</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
656
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"accel"</span><span class="symbol">&gt;&lt;![</span><span class="normal">CDATA</span><span class="symbol">[&lt;</span><span class="normal">Ctrl</span><span class="symbol">&gt;</span><span class="normal">Q</span><span class="symbol">]]&gt;&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
657
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
658
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">section</span><span class="symbol">&gt;</span>
659
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">menu</span><span class="symbol">&gt;</span>
660
+ <span class="symbol">&lt;/</span><span class="normal">interface</span><span class="symbol">&gt;</span></pre></td>
661
+ </tr>
662
+ </tbody>
663
+ </table>
664
+ </div>
665
+
666
+ <p>To associate the app menu with the application, we have to call
667
+ <a class="link" href="GtkApplication.html#gtk-application-set-app-menu" title="gtk_application_set_app_menu ()"><code class="function">gtk_application_set_app_menu()</code></a>. Since app menus work by activating
668
+ <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GAction.html"><span class="type">GActions</span></a>, we also have to add a suitable set of actions to our
669
+ application.</p>
670
+ <p>Both of these tasks are best done in the <code class="function">startup()</code> vfunc,
671
+ which is guaranteed to be called once for each primary application
672
+ instance:</p>
673
+ <div class="informalexample">
674
+ <pre class="programlisting">
675
+ ...
676
+
677
+ static void
678
+ preferences_activated (GSimpleAction *action,
679
+ GVariant *parameter,
680
+ gpointer app)
681
+ {
682
+ }
683
+
684
+ static void
685
+ quit_activated (GSimpleAction *action,
686
+ GVariant *parameter,
687
+ gpointer app)
688
+ {
689
+ g_application_quit (G_APPLICATION (app));
690
+ }
691
+
692
+ static GActionEntry app_entries[] =
693
+ {
694
+ { "preferences", preferences_activated, NULL, NULL, NULL },
695
+ { "quit", quit_activated, NULL, NULL, NULL }
696
+ };
697
+
698
+ static void
699
+ example_app_startup (GApplication *app)
700
+ {
701
+ GtkBuilder *builder;
702
+ GMenuModel *app_menu;
703
+
704
+ G_APPLICATION_CLASS (example_app_parent_class)-&gt;startup (app);
705
+
706
+ g_action_map_add_action_entries (G_ACTION_MAP (app),
707
+ app_entries, G_N_ELEMENTS (app_entries),
708
+ app);
709
+
710
+ builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/app-menu.ui");
711
+ app_menu = G_MENU_MODEL (gtk_builder_get_object (builder, "appmenu"));
712
+ gtk_application_set_app_menu (GTK_APPLICATION (app), app_menu);
713
+ g_object_unref (builder);
714
+ }
715
+
716
+ static void
717
+ example_app_class_init (ExampleAppClass *class)
718
+ {
719
+ G_APPLICATION_CLASS (class)-&gt;startup = example_app_startup;
720
+ ...
721
+ }
722
+
723
+ ...
724
+ </pre>
725
+ <p>(<a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application4/exampleapp.c" target="_top">full source</a>)</p>
726
+ </div>
727
+ <p>Our preferences menu item does not do anything yet,
728
+ but the Quit menu item is fully functional. Note that it
729
+ can also be activated by the usual Ctrl-Q shortcut. The
730
+ shortcut was specified in the ui file.
731
+ </p>
732
+ <p>The application menu looks like this:</p>
733
+ <div class="informalfigure"><div class="mediaobject"><img src="getting-started-app4.png"></div></div>
734
+ </div>
735
+ <div class="section">
736
+ <div class="titlepage"><div><div><h3 class="title">
737
+ <a name="id-1.2.3.7.9"></a>A preference dialog</h3></div></div></div>
738
+ <p>A typical application will have a some preferences that
739
+ should be remembered from one run to the next. Even for our
740
+ simple example application, we may want to change the font
741
+ that is used for the content.</p>
742
+ <p>We are going to use GSettings to store our preferences.
743
+ GSettings requires a schema that describes our settings:</p>
744
+ <div class="informalexample">
745
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
746
+ <tbody>
747
+ <tr>
748
+ <td class="listing_lines" align="right"><pre>1
749
+ 2
750
+ 3
751
+ 4
752
+ 5
753
+ 6
754
+ 7
755
+ 8
756
+ 9
757
+ 10
758
+ 11
759
+ 12
760
+ 13
761
+ 14
762
+ 15
763
+ 16
764
+ 17
765
+ 18
766
+ 19
767
+ 20</pre></td>
768
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="usertype">xml</span><span class="normal"> version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="normal"> encoding</span><span class="symbol">=</span><span class="string">"UTF-8"</span><span class="symbol">?&gt;</span>
769
+ <span class="symbol">&lt;</span><span class="normal">schemalist</span><span class="symbol">&gt;</span>
770
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">schema</span><span class="normal"> path</span><span class="symbol">=</span><span class="string">"/org/gtk/exampleapp/"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"org.gtk.exampleapp"</span><span class="symbol">&gt;</span>
771
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">key</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"font"</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"s"</span><span class="symbol">&gt;</span>
772
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="keyword">default</span><span class="symbol">&gt;</span><span class="string">'Monospace 12'</span><span class="symbol">&lt;/</span><span class="keyword">default</span><span class="symbol">&gt;</span>
773
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">summary</span><span class="symbol">&gt;</span><span class="normal">Font</span><span class="symbol">&lt;/</span><span class="normal">summary</span><span class="symbol">&gt;</span>
774
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">description</span><span class="symbol">&gt;</span><span class="normal">The font to be used </span><span class="usertype">for</span><span class="normal"> content</span><span class="symbol">.&lt;/</span><span class="normal">description</span><span class="symbol">&gt;</span>
775
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">key</span><span class="symbol">&gt;</span>
776
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">key</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"transition"</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"s"</span><span class="symbol">&gt;</span>
777
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">choices</span><span class="symbol">&gt;</span>
778
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">choice</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">'none'</span><span class="symbol">/&gt;</span>
779
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">choice</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">'crossfade'</span><span class="symbol">/&gt;</span>
780
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">choice</span><span class="normal"> value</span><span class="symbol">=</span><span class="string">'slide-left-right'</span><span class="symbol">/&gt;</span>
781
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">choices</span><span class="symbol">&gt;</span>
782
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="keyword">default</span><span class="symbol">&gt;</span><span class="string">'none'</span><span class="symbol">&lt;/</span><span class="keyword">default</span><span class="symbol">&gt;</span>
783
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">summary</span><span class="symbol">&gt;</span><span class="normal">Transition</span><span class="symbol">&lt;/</span><span class="normal">summary</span><span class="symbol">&gt;</span>
784
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">description</span><span class="symbol">&gt;</span><span class="normal">The transition to use when </span><span class="usertype">switching</span><span class="normal"> tabs</span><span class="symbol">.&lt;/</span><span class="normal">description</span><span class="symbol">&gt;</span>
785
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">key</span><span class="symbol">&gt;</span>
786
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">schema</span><span class="symbol">&gt;</span>
787
+ <span class="symbol">&lt;/</span><span class="normal">schemalist</span><span class="symbol">&gt;</span></pre></td>
788
+ </tr>
789
+ </tbody>
790
+ </table>
791
+ </div>
792
+
793
+ <p>Before we can make use of this schema in our application,
794
+ we need to compile it into the binary form that GSettings
795
+ expects. GIO provides <a class="ulink" href="https://developer.gnome.org/gio/2.36/ch31s06.html" target="_top">macros</a>
796
+ to do this in autotools-based projects.</p>
797
+ <p>Next, we need to connect our settings to the widgets
798
+ that they are supposed to control. One convenient way to do
799
+ this is to use GSettings bind functionality to bind settings
800
+ keys to object properties, as we do here for the transition
801
+ setting.</p>
802
+ <div class="informalexample">
803
+ <pre class="programlisting">
804
+ ...
805
+
806
+ static void
807
+ example_app_window_init (ExampleAppWindow *win)
808
+ {
809
+ ExampleAppWindowPrivate *priv;
810
+
811
+ priv = example_app_window_get_instance_private (win);
812
+ gtk_widget_init_template (GTK_WIDGET (win));
813
+ priv-&gt;settings = g_settings_new ("org.gtk.exampleapp");
814
+
815
+ g_settings_bind (priv-&gt;settings, "transition",
816
+ priv-&gt;stack, "transition-type",
817
+ G_SETTINGS_BIND_DEFAULT);
818
+ }
819
+
820
+ ...
821
+ </pre>
822
+ <p>(<a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application5/exampleappwin.c" target="_top">full source</a>)</p>
823
+ </div>
824
+ <p>The code to connect the font setting is a little more involved,
825
+ since there is no simple object property that it corresponds to, so
826
+ we are not going to go into that here.</p>
827
+ <p>At this point, the application will already react if you
828
+ change one of the settings, e.g. using the gsettings commandline
829
+ tool. Of course, we expect the application to provide a preference
830
+ dialog for these. So lets do that now. Our preference dialog will
831
+ be a subclass of GtkDialog, and we'll use the same techniques that
832
+ we've already seen: templates, private structs, settings
833
+ bindings.</p>
834
+ <p>Lets start with the template.</p>
835
+ <div class="informalexample">
836
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
837
+ <tbody>
838
+ <tr>
839
+ <td class="listing_lines" align="right"><pre>1
840
+ 2
841
+ 3
842
+ 4
843
+ 5
844
+ 6
845
+ 7
846
+ 8
847
+ 9
848
+ 10
849
+ 11
850
+ 12
851
+ 13
852
+ 14
853
+ 15
854
+ 16
855
+ 17
856
+ 18
857
+ 19
858
+ 20
859
+ 21
860
+ 22
861
+ 23
862
+ 24
863
+ 25
864
+ 26
865
+ 27
866
+ 28
867
+ 29
868
+ 30
869
+ 31
870
+ 32
871
+ 33
872
+ 34
873
+ 35
874
+ 36
875
+ 37
876
+ 38
877
+ 39
878
+ 40
879
+ 41
880
+ 42
881
+ 43
882
+ 44
883
+ 45
884
+ 46
885
+ 47
886
+ 48
887
+ 49
888
+ 50
889
+ 51
890
+ 52
891
+ 53
892
+ 54
893
+ 55
894
+ 56
895
+ 57
896
+ 58
897
+ 59
898
+ 60
899
+ 61
900
+ 62
901
+ 63
902
+ 64
903
+ 65
904
+ 66
905
+ 67
906
+ 68
907
+ 69
908
+ 70
909
+ 71
910
+ 72
911
+ 73
912
+ 74
913
+ 75
914
+ 76
915
+ 77
916
+ 78
917
+ 79
918
+ 80
919
+ 81
920
+ 82
921
+ 83</pre></td>
922
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="usertype">xml</span><span class="normal"> version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="normal"> encoding</span><span class="symbol">=</span><span class="string">"UTF-8"</span><span class="symbol">?&gt;</span>
923
+ <span class="symbol">&lt;</span><span class="normal">interface</span><span class="symbol">&gt;</span>
924
+ <span class="normal"> </span><span class="symbol">&lt;!--</span><span class="normal"> interface</span><span class="symbol">-</span><span class="usertype">requires</span><span class="normal"> gtk</span><span class="symbol">+</span><span class="normal"> </span><span class="number">3.8</span><span class="normal"> </span><span class="symbol">--&gt;</span>
925
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">template</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"ExampleAppPrefs"</span><span class="normal"> parent</span><span class="symbol">=</span><span class="string">"GtkDialog"</span><span class="symbol">&gt;</span>
926
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"title"</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="symbol">&gt;</span><span class="normal">Preferences</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
927
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"resizable"</span><span class="symbol">&gt;</span><span class="normal">False</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
928
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"modal"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
929
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">child</span><span class="normal"> internal</span><span class="symbol">-</span><span class="normal">child</span><span class="symbol">=</span><span class="string">"vbox"</span><span class="symbol">&gt;</span>
930
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkBox"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"vbox"</span><span class="symbol">&gt;</span>
931
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
932
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkGrid"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"grid"</span><span class="symbol">&gt;</span>
933
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
934
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"margin"</span><span class="symbol">&gt;</span><span class="number">6</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
935
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"row-spacing"</span><span class="symbol">&gt;</span><span class="number">12</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
936
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"column-spacing"</span><span class="symbol">&gt;</span><span class="number">6</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
937
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
938
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkLabel"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"fontlabel"</span><span class="symbol">&gt;</span>
939
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
940
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="symbol">&gt;</span><span class="normal">_Font</span><span class="symbol">:&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
941
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"use-underline"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
942
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"mnemonic-widget"</span><span class="symbol">&gt;</span><span class="normal">font</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
943
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"xalign"</span><span class="symbol">&gt;</span><span class="number">1</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
944
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
945
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">packing</span><span class="symbol">&gt;</span>
946
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"left-attach"</span><span class="symbol">&gt;</span><span class="number">0</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
947
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"top-attach"</span><span class="symbol">&gt;</span><span class="number">0</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
948
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">packing</span><span class="symbol">&gt;</span>
949
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
950
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
951
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkFontButton"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"font"</span><span class="symbol">&gt;</span>
952
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
953
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
954
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">packing</span><span class="symbol">&gt;</span>
955
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"left-attach"</span><span class="symbol">&gt;</span><span class="number">1</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
956
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"top-attach"</span><span class="symbol">&gt;</span><span class="number">0</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
957
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">packing</span><span class="symbol">&gt;</span>
958
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
959
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
960
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkLabel"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"transitionlabel"</span><span class="symbol">&gt;</span>
961
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
962
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="symbol">&gt;</span><span class="normal">_Transition</span><span class="symbol">:&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
963
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"use-underline"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
964
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"mnemonic-widget"</span><span class="symbol">&gt;</span><span class="normal">transition</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
965
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"xalign"</span><span class="symbol">&gt;</span><span class="number">1</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
966
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
967
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">packing</span><span class="symbol">&gt;</span>
968
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"left-attach"</span><span class="symbol">&gt;</span><span class="number">0</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
969
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"top-attach"</span><span class="symbol">&gt;</span><span class="number">1</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
970
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">packing</span><span class="symbol">&gt;</span>
971
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
972
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
973
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkComboBoxText"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"transition"</span><span class="symbol">&gt;</span>
974
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
975
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">items</span><span class="symbol">&gt;</span>
976
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"none"</span><span class="symbol">&gt;</span><span class="normal">None</span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
977
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"crossfade"</span><span class="symbol">&gt;</span><span class="normal">Fade</span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
978
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">item</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"slide-left-right"</span><span class="symbol">&gt;</span><span class="normal">Slide</span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
979
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">items</span><span class="symbol">&gt;</span>
980
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
981
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">packing</span><span class="symbol">&gt;</span>
982
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"left-attach"</span><span class="symbol">&gt;</span><span class="number">1</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
983
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"top-attach"</span><span class="symbol">&gt;</span><span class="number">1</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
984
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">packing</span><span class="symbol">&gt;</span>
985
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
986
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
987
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
988
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">child</span><span class="normal"> internal</span><span class="symbol">-</span><span class="normal">child</span><span class="symbol">=</span><span class="string">"action_area"</span><span class="symbol">&gt;</span>
989
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkButtonBox"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"action_area"</span><span class="symbol">&gt;</span>
990
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
991
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
992
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkButton"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"close"</span><span class="symbol">&gt;</span>
993
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">signal</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"clicked"</span><span class="normal"> handler</span><span class="symbol">=</span><span class="string">"preferences_closed"</span><span class="symbol">/&gt;</span>
994
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
995
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="symbol">&gt;</span><span class="normal">_Close</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
996
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"use-underline"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
997
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
998
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
999
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1000
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1001
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1002
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1003
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">template</span><span class="symbol">&gt;</span>
1004
+ <span class="symbol">&lt;/</span><span class="normal">interface</span><span class="symbol">&gt;</span></pre></td>
1005
+ </tr>
1006
+ </tbody>
1007
+ </table>
1008
+ </div>
1009
+
1010
+ <p>Next comes the dialog subclass.</p>
1011
+ <div class="informalexample">
1012
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1013
+ <tbody>
1014
+ <tr>
1015
+ <td class="listing_lines" align="right"><pre>1
1016
+ 2
1017
+ 3
1018
+ 4
1019
+ 5
1020
+ 6
1021
+ 7
1022
+ 8
1023
+ 9
1024
+ 10
1025
+ 11
1026
+ 12
1027
+ 13
1028
+ 14
1029
+ 15
1030
+ 16
1031
+ 17
1032
+ 18
1033
+ 19
1034
+ 20
1035
+ 21
1036
+ 22
1037
+ 23
1038
+ 24
1039
+ 25
1040
+ 26
1041
+ 27
1042
+ 28
1043
+ 29
1044
+ 30
1045
+ 31
1046
+ 32
1047
+ 33
1048
+ 34
1049
+ 35
1050
+ 36
1051
+ 37
1052
+ 38
1053
+ 39
1054
+ 40
1055
+ 41
1056
+ 42
1057
+ 43
1058
+ 44
1059
+ 45
1060
+ 46
1061
+ 47
1062
+ 48
1063
+ 49
1064
+ 50
1065
+ 51
1066
+ 52
1067
+ 53
1068
+ 54
1069
+ 55
1070
+ 56
1071
+ 57
1072
+ 58
1073
+ 59
1074
+ 60
1075
+ 61
1076
+ 62
1077
+ 63
1078
+ 64
1079
+ 65
1080
+ 66
1081
+ 67
1082
+ 68
1083
+ 69
1084
+ 70
1085
+ 71
1086
+ 72
1087
+ 73
1088
+ 74
1089
+ 75
1090
+ 76
1091
+ 77
1092
+ 78
1093
+ 79</pre></td>
1094
+ <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;gtk/gtk.h&gt;</span>
1095
+
1096
+ <span class="preproc">#include</span><span class="normal"> </span><span class="string">"exampleapp.h"</span>
1097
+ <span class="preproc">#include</span><span class="normal"> </span><span class="string">"exampleappwin.h"</span>
1098
+ <span class="preproc">#include</span><span class="normal"> </span><span class="string">"exampleappprefs.h"</span>
1099
+
1100
+ <span class="keyword">struct</span><span class="normal"> </span><span class="classname">_ExampleAppPrefs</span>
1101
+ <span class="cbracket">{</span>
1102
+ <span class="normal"> </span><span class="usertype">GtkDialog</span><span class="normal"> parent</span><span class="symbol">;</span>
1103
+ <span class="cbracket">}</span><span class="symbol">;</span>
1104
+
1105
+ <span class="keyword">struct</span><span class="normal"> </span><span class="classname">_ExampleAppPrefsClass</span>
1106
+ <span class="cbracket">{</span>
1107
+ <span class="normal"> </span><span class="usertype">GtkDialogClass</span><span class="normal"> parent_class</span><span class="symbol">;</span>
1108
+ <span class="cbracket">}</span><span class="symbol">;</span>
1109
+
1110
+ <span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="classname">_ExampleAppPrefsPrivate</span><span class="normal"> ExampleAppPrefsPrivate</span><span class="symbol">;</span>
1111
+
1112
+ <span class="keyword">struct</span><span class="normal"> </span><span class="classname">_ExampleAppPrefsPrivate</span>
1113
+ <span class="cbracket">{</span>
1114
+ <span class="normal"> </span><span class="usertype">GSettings</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">settings</span><span class="symbol">;</span>
1115
+ <span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">font</span><span class="symbol">;</span>
1116
+ <span class="normal"> </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">transition</span><span class="symbol">;</span>
1117
+ <span class="cbracket">}</span><span class="symbol">;</span>
1118
+
1119
+ <span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Type-Information.html#G-DEFINE-TYPE-WITH-PRIVATE:CAPS">G_DEFINE_TYPE_WITH_PRIVATE</a></span><span class="symbol">(</span><span class="normal">ExampleAppPrefs</span><span class="symbol">,</span><span class="normal"> example_app_prefs</span><span class="symbol">,</span><span class="normal"> GTK_TYPE_DIALOG</span><span class="symbol">)</span>
1120
+
1121
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
1122
+ <span class="function">preferences_closed</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">button</span><span class="symbol">)</span>
1123
+ <span class="cbracket">{</span>
1124
+ <span class="normal"> </span><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="function"><a href="GtkWidget.html#gtk-widget-get-toplevel">gtk_widget_get_toplevel</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">button</span><span class="symbol">));</span>
1125
+ <span class="cbracket">}</span>
1126
+
1127
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
1128
+ <span class="function">example_app_prefs_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ExampleAppPrefs</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">prefs</span><span class="symbol">)</span>
1129
+ <span class="cbracket">{</span>
1130
+ <span class="normal"> </span><span class="usertype">ExampleAppPrefsPrivate</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">priv</span><span class="symbol">;</span>
1131
+
1132
+ <span class="normal"> priv </span><span class="symbol">=</span><span class="normal"> </span><span class="function">example_app_prefs_get_instance_private</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">prefs</span><span class="symbol">);</span>
1133
+ <span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-init-template">gtk_widget_init_template</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WIDGET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">prefs</span><span class="symbol">));</span>
1134
+ <span class="normal"> priv</span><span class="symbol">-&gt;</span><span class="normal">settings </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GSettings.html#g-settings-new">g_settings_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"org.gtk.exampleapp"</span><span class="symbol">);</span>
1135
+
1136
+ <span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GSettings.html#g-settings-bind">g_settings_bind</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">priv</span><span class="symbol">-&gt;</span><span class="normal">settings</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"font"</span><span class="symbol">,</span>
1137
+ <span class="normal"> priv</span><span class="symbol">-&gt;</span><span class="normal">font</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"font"</span><span class="symbol">,</span>
1138
+ <span class="normal"> <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GSettings.html#G-SETTINGS-BIND-DEFAULT:CAPS">G_SETTINGS_BIND_DEFAULT</a></span><span class="symbol">);</span>
1139
+ <span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GSettings.html#g-settings-bind">g_settings_bind</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">priv</span><span class="symbol">-&gt;</span><span class="normal">settings</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"transition"</span><span class="symbol">,</span>
1140
+ <span class="normal"> priv</span><span class="symbol">-&gt;</span><span class="normal">transition</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"active-id"</span><span class="symbol">,</span>
1141
+ <span class="normal"> <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/GSettings.html#G-SETTINGS-BIND-DEFAULT:CAPS">G_SETTINGS_BIND_DEFAULT</a></span><span class="symbol">);</span>
1142
+ <span class="cbracket">}</span>
1143
+
1144
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
1145
+ <span class="function">example_app_prefs_dispose</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GObject</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">object</span><span class="symbol">)</span>
1146
+ <span class="cbracket">{</span>
1147
+ <span class="normal"> </span><span class="usertype">ExampleAppPrefsPrivate</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">priv</span><span class="symbol">;</span>
1148
+
1149
+ <span class="normal"> priv </span><span class="symbol">=</span><span class="normal"> </span><span class="function">example_app_prefs_get_instance_private</span><span class="normal"> </span><span class="symbol">(</span><span class="function">EXAMPLE_APP_PREFS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">));</span>
1150
+ <span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-clear-object">g_clear_object</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">priv</span><span class="symbol">-&gt;</span><span class="normal">settings</span><span class="symbol">);</span>
1151
+
1152
+ <span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#G-OBJECT-CLASS:CAPS">G_OBJECT_CLASS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">example_app_prefs_parent_class</span><span class="symbol">)-&gt;</span><span class="function">dispose</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">object</span><span class="symbol">);</span>
1153
+ <span class="cbracket">}</span>
1154
+
1155
+ <span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
1156
+ <span class="function">example_app_prefs_class_init</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ExampleAppPrefsClass</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">class</span><span class="symbol">)</span>
1157
+ <span class="cbracket">{</span>
1158
+ <span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#G-OBJECT-CLASS:CAPS">G_OBJECT_CLASS</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">class</span><span class="symbol">)-&gt;</span><span class="normal">dispose </span><span class="symbol">=</span><span class="normal"> example_app_prefs_dispose</span><span class="symbol">;</span>
1159
+
1160
+ <span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-class-set-template-from-resource">gtk_widget_class_set_template_from_resource</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WIDGET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">class</span><span class="symbol">),</span>
1161
+ <span class="normal"> </span><span class="string">"/org/gtk/exampleapp/prefs.ui"</span><span class="symbol">);</span>
1162
+ <span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-class-bind-template-child-private">gtk_widget_class_bind_template_child_private</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WIDGET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">class</span><span class="symbol">),</span><span class="normal"> ExampleAppPrefs</span><span class="symbol">,</span><span class="normal"> font</span><span class="symbol">);</span>
1163
+ <span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-class-bind-template-child-private">gtk_widget_class_bind_template_child_private</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WIDGET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">class</span><span class="symbol">),</span><span class="normal"> ExampleAppPrefs</span><span class="symbol">,</span><span class="normal"> transition</span><span class="symbol">);</span>
1164
+
1165
+ <span class="normal"> </span><span class="function"><a href="GtkWidget.html#gtk-widget-class-bind-template-callback">gtk_widget_class_bind_template_callback</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_WIDGET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">class</span><span class="symbol">),</span><span class="normal"> preferences_closed</span><span class="symbol">);</span>
1166
+ <span class="cbracket">}</span>
1167
+
1168
+ <span class="normal">ExampleAppPrefs </span><span class="symbol">*</span>
1169
+ <span class="function">example_app_prefs_new</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">ExampleAppWindow</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">win</span><span class="symbol">)</span>
1170
+ <span class="cbracket">{</span>
1171
+ <span class="normal"> </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-new">g_object_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">EXAMPLE_APP_PREFS_TYPE</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"transient-for"</span><span class="symbol">,</span><span class="normal"> win</span><span class="symbol">,</span><span class="normal"> <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
1172
+ <span class="cbracket">}</span></pre></td>
1173
+ </tr>
1174
+ </tbody>
1175
+ </table>
1176
+ </div>
1177
+
1178
+ <p>Now we revisit the <code class="function">preferences_activated()</code> function in our
1179
+ application class, and make it open a new preference dialog.</p>
1180
+ <div class="informalexample">
1181
+ <pre class="programlisting">
1182
+ ...
1183
+
1184
+ static void
1185
+ preferences_activated (GSimpleAction *action,
1186
+ GVariant *parameter,
1187
+ gpointer app)
1188
+ {
1189
+ ExampleAppPrefs *prefs;
1190
+ GtkWindow *win;
1191
+
1192
+ win = gtk_application_get_active_window (GTK_APPLICATION (app));
1193
+ prefs = example_app_prefs_new (EXAMPLE_APP_WINDOW (win));
1194
+ gtk_window_present (GTK_WINDOW (prefs));
1195
+ }
1196
+
1197
+ ...
1198
+ </pre>
1199
+ <p>(<a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application6/exampleapp.c" target="_top">full source</a>)</p>
1200
+ </div>
1201
+ <p>After all this work, our application can now show
1202
+ a preference dialog like this:</p>
1203
+ <div class="informalfigure"><div class="mediaobject"><img src="getting-started-app6.png"></div></div>
1204
+ </div>
1205
+ <div class="section">
1206
+ <div class="titlepage"><div><div><h3 class="title">
1207
+ <a name="id-1.2.3.7.10"></a>Adding a search bar</h3></div></div></div>
1208
+ <p>We continue to flesh out the functionality of our application.
1209
+ For now, we add search. GTK+ supports this with <a class="link" href="GtkSearchEntry.html" title="GtkSearchEntry"><span class="type">GtkSearchEntry</span></a> and
1210
+ <a class="link" href="GtkSearchBar.html" title="GtkSearchBar"><span class="type">GtkSearchBar</span></a>. The search bar is a widget that can slide in from the
1211
+ top to present a search entry.</p>
1212
+ <p>We add a toggle button to the header bar, which can be used
1213
+ to slide out the search bar below the header bar.</p>
1214
+ <div class="informalexample">
1215
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1216
+ <tbody>
1217
+ <tr>
1218
+ <td class="listing_lines" align="right"><pre>1
1219
+ 2
1220
+ 3
1221
+ 4
1222
+ 5
1223
+ 6
1224
+ 7
1225
+ 8
1226
+ 9
1227
+ 10
1228
+ 11
1229
+ 12
1230
+ 13
1231
+ 14
1232
+ 15
1233
+ 16
1234
+ 17
1235
+ 18
1236
+ 19
1237
+ 20
1238
+ 21
1239
+ 22
1240
+ 23
1241
+ 24
1242
+ 25
1243
+ 26
1244
+ 27
1245
+ 28
1246
+ 29
1247
+ 30
1248
+ 31
1249
+ 32
1250
+ 33
1251
+ 34
1252
+ 35
1253
+ 36
1254
+ 37
1255
+ 38
1256
+ 39
1257
+ 40
1258
+ 41
1259
+ 42
1260
+ 43
1261
+ 44
1262
+ 45
1263
+ 46
1264
+ 47
1265
+ 48
1266
+ 49
1267
+ 50
1268
+ 51
1269
+ 52
1270
+ 53
1271
+ 54
1272
+ 55
1273
+ 56
1274
+ 57
1275
+ 58
1276
+ 59</pre></td>
1277
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="usertype">xml</span><span class="normal"> version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="normal"> encoding</span><span class="symbol">=</span><span class="string">"UTF-8"</span><span class="symbol">?&gt;</span>
1278
+ <span class="symbol">&lt;</span><span class="normal">interface</span><span class="symbol">&gt;</span>
1279
+ <span class="normal"> </span><span class="symbol">&lt;!--</span><span class="normal"> interface</span><span class="symbol">-</span><span class="usertype">requires</span><span class="normal"> gtk</span><span class="symbol">+</span><span class="normal"> </span><span class="number">3.8</span><span class="normal"> </span><span class="symbol">--&gt;</span>
1280
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">template</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"ExampleAppWindow"</span><span class="normal"> parent</span><span class="symbol">=</span><span class="string">"GtkApplicationWindow"</span><span class="symbol">&gt;</span>
1281
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"title"</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="symbol">&gt;</span><span class="usertype">Example</span><span class="normal"> Application</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1282
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"default-width"</span><span class="symbol">&gt;</span><span class="number">600</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1283
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"default-height"</span><span class="symbol">&gt;</span><span class="number">400</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1284
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1285
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkBox"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"content_box"</span><span class="symbol">&gt;</span>
1286
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1287
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"orientation"</span><span class="symbol">&gt;</span><span class="normal">vertical</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1288
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1289
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkHeaderBar"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"header"</span><span class="symbol">&gt;</span>
1290
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1291
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">child</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"title"</span><span class="symbol">&gt;</span>
1292
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkStackSwitcher"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"tabs"</span><span class="symbol">&gt;</span>
1293
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1294
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"stack"</span><span class="symbol">&gt;</span><span class="normal">stack</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1295
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1296
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1297
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1298
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkToggleButton"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"search"</span><span class="symbol">&gt;</span>
1299
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1300
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"sensitive"</span><span class="symbol">&gt;</span><span class="normal">False</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1301
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1302
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkImage"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"search-icon"</span><span class="symbol">&gt;</span>
1303
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1304
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"icon-name"</span><span class="symbol">&gt;</span><span class="normal">edit</span><span class="symbol">-</span><span class="normal">find</span><span class="symbol">-</span><span class="normal">symbolic</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1305
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"icon-size"</span><span class="symbol">&gt;</span><span class="number">1</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1306
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1307
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1308
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1309
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">packing</span><span class="symbol">&gt;</span>
1310
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"pack-type"</span><span class="symbol">&gt;</span><span class="normal">end</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1311
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">packing</span><span class="symbol">&gt;</span>
1312
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1313
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1314
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1315
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1316
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkSearchBar"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"searchbar"</span><span class="symbol">&gt;</span>
1317
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1318
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1319
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkSearchEntry"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"searchentry"</span><span class="symbol">&gt;</span>
1320
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">signal</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"search-changed"</span><span class="normal"> handler</span><span class="symbol">=</span><span class="string">"search_text_changed"</span><span class="symbol">/&gt;</span>
1321
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1322
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1323
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1324
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1325
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1326
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1327
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkStack"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"stack"</span><span class="symbol">&gt;</span>
1328
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">signal</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"notify::visible-child"</span><span class="normal"> handler</span><span class="symbol">=</span><span class="string">"visible_child_changed"</span><span class="symbol">/&gt;</span>
1329
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1330
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1331
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1332
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1333
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1334
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">template</span><span class="symbol">&gt;</span>
1335
+ <span class="symbol">&lt;/</span><span class="normal">interface</span><span class="symbol">&gt;</span></pre></td>
1336
+ </tr>
1337
+ </tbody>
1338
+ </table>
1339
+ </div>
1340
+
1341
+ <p>Implementing the search needs quite a few code changes that
1342
+ we are not going to completely go over here. The central piece of
1343
+ the search implementation is a signal handler that listens for
1344
+ text changes in the search entry.</p>
1345
+ <div class="informalexample">
1346
+ <pre class="programlisting">
1347
+ ...
1348
+
1349
+ static void
1350
+ search_text_changed (GtkEntry *entry,
1351
+ ExampleAppWindow *win)
1352
+ {
1353
+ ExampleAppWindowPrivate *priv;
1354
+ const gchar *text;
1355
+ GtkWidget *tab;
1356
+ GtkWidget *view;
1357
+ GtkTextBuffer *buffer;
1358
+ GtkTextIter start, match_start, match_end;
1359
+
1360
+ text = gtk_entry_get_text (entry);
1361
+
1362
+ if (text[0] == '\0')
1363
+ return;
1364
+
1365
+ priv = example_app_window_get_instance_private (win);
1366
+
1367
+ tab = gtk_stack_get_visible_child (GTK_STACK (priv-&gt;stack));
1368
+ view = gtk_bin_get_child (GTK_BIN (tab));
1369
+ buffer = gtk_text_view_get_buffer (GTK_TEXT_VIEW (view));
1370
+
1371
+ /* Very simple-minded search implementation */
1372
+ gtk_text_buffer_get_start_iter (buffer, &amp;start);
1373
+ if (gtk_text_iter_forward_search (&amp;start, text, GTK_TEXT_SEARCH_CASE_INSENSITIVE,
1374
+ &amp;match_start, &amp;match_end, NULL))
1375
+ {
1376
+ gtk_text_buffer_select_range (buffer, &amp;match_start, &amp;match_end);
1377
+ gtk_text_view_scroll_to_iter (GTK_TEXT_VIEW (view), &amp;match_start,
1378
+ 0.0, FALSE, 0.0, 0.0);
1379
+ }
1380
+ }
1381
+
1382
+ static void
1383
+ example_app_window_init (ExampleAppWindow *win)
1384
+ {
1385
+
1386
+ ...
1387
+
1388
+ gtk_widget_class_bind_template_callback (GTK_WIDGET_CLASS (class), search_text_changed);
1389
+
1390
+ ...
1391
+
1392
+ }
1393
+
1394
+ ...
1395
+ </pre>
1396
+ <p>(<a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application7/exampleappwin.c" target="_top">full source</a>)</p>
1397
+ </div>
1398
+ <p>With the search bar, our application now looks like this:</p>
1399
+ <div class="informalfigure"><div class="mediaobject"><img src="getting-started-app7.png"></div></div>
1400
+ </div>
1401
+ <div class="section">
1402
+ <div class="titlepage"><div><div><h3 class="title">
1403
+ <a name="id-1.2.3.7.11"></a>Adding a side bar</h3></div></div></div>
1404
+ <p>As another piece of functionality, we are adding a sidebar,
1405
+ which demonstrates <a class="link" href="GtkMenuButton.html" title="GtkMenuButton"><span class="type">GtkMenuButton</span></a>, <a class="link" href="GtkRevealer.html" title="GtkRevealer"><span class="type">GtkRevealer</span></a> and <a class="link" href="GtkListBox.html" title="GtkListBox"><span class="type">GtkListBox</span></a>.</p>
1406
+ <div class="informalexample">
1407
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1408
+ <tbody>
1409
+ <tr>
1410
+ <td class="listing_lines" align="right"><pre>1
1411
+ 2
1412
+ 3
1413
+ 4
1414
+ 5
1415
+ 6
1416
+ 7
1417
+ 8
1418
+ 9
1419
+ 10
1420
+ 11
1421
+ 12
1422
+ 13
1423
+ 14
1424
+ 15
1425
+ 16
1426
+ 17
1427
+ 18
1428
+ 19
1429
+ 20
1430
+ 21
1431
+ 22
1432
+ 23
1433
+ 24
1434
+ 25
1435
+ 26
1436
+ 27
1437
+ 28
1438
+ 29
1439
+ 30
1440
+ 31
1441
+ 32
1442
+ 33
1443
+ 34
1444
+ 35
1445
+ 36
1446
+ 37
1447
+ 38
1448
+ 39
1449
+ 40
1450
+ 41
1451
+ 42
1452
+ 43
1453
+ 44
1454
+ 45
1455
+ 46
1456
+ 47
1457
+ 48
1458
+ 49
1459
+ 50
1460
+ 51
1461
+ 52
1462
+ 53
1463
+ 54
1464
+ 55
1465
+ 56
1466
+ 57
1467
+ 58
1468
+ 59
1469
+ 60
1470
+ 61
1471
+ 62
1472
+ 63
1473
+ 64
1474
+ 65
1475
+ 66
1476
+ 67
1477
+ 68
1478
+ 69
1479
+ 70
1480
+ 71
1481
+ 72
1482
+ 73
1483
+ 74
1484
+ 75
1485
+ 76
1486
+ 77
1487
+ 78
1488
+ 79
1489
+ 80
1490
+ 81
1491
+ 82
1492
+ 83
1493
+ 84
1494
+ 85
1495
+ 86
1496
+ 87
1497
+ 88
1498
+ 89
1499
+ 90
1500
+ 91
1501
+ 92
1502
+ 93
1503
+ 94
1504
+ 95
1505
+ 96
1506
+ 97
1507
+ 98</pre></td>
1508
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="usertype">xml</span><span class="normal"> version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="normal"> encoding</span><span class="symbol">=</span><span class="string">"UTF-8"</span><span class="symbol">?&gt;</span>
1509
+ <span class="symbol">&lt;</span><span class="normal">interface</span><span class="symbol">&gt;</span>
1510
+ <span class="normal"> </span><span class="symbol">&lt;!--</span><span class="normal"> interface</span><span class="symbol">-</span><span class="usertype">requires</span><span class="normal"> gtk</span><span class="symbol">+</span><span class="normal"> </span><span class="number">3.8</span><span class="normal"> </span><span class="symbol">--&gt;</span>
1511
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">template</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"ExampleAppWindow"</span><span class="normal"> parent</span><span class="symbol">=</span><span class="string">"GtkApplicationWindow"</span><span class="symbol">&gt;</span>
1512
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"title"</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="symbol">&gt;</span><span class="usertype">Example</span><span class="normal"> Application</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1513
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"default-width"</span><span class="symbol">&gt;</span><span class="number">600</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1514
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"default-height"</span><span class="symbol">&gt;</span><span class="number">400</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1515
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1516
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkBox"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"content_box"</span><span class="symbol">&gt;</span>
1517
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1518
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"orientation"</span><span class="symbol">&gt;</span><span class="normal">vertical</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1519
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1520
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkHeaderBar"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"header"</span><span class="symbol">&gt;</span>
1521
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1522
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">child</span><span class="normal"> type</span><span class="symbol">=</span><span class="string">"title"</span><span class="symbol">&gt;</span>
1523
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkStackSwitcher"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"tabs"</span><span class="symbol">&gt;</span>
1524
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1525
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"stack"</span><span class="symbol">&gt;</span><span class="normal">stack</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1526
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1527
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1528
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1529
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkToggleButton"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"search"</span><span class="symbol">&gt;</span>
1530
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1531
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"sensitive"</span><span class="symbol">&gt;</span><span class="normal">False</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1532
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1533
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkImage"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"search-icon"</span><span class="symbol">&gt;</span>
1534
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1535
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"icon-name"</span><span class="symbol">&gt;</span><span class="normal">edit</span><span class="symbol">-</span><span class="normal">find</span><span class="symbol">-</span><span class="normal">symbolic</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1536
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"icon-size"</span><span class="symbol">&gt;</span><span class="number">1</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1537
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1538
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1539
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1540
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">packing</span><span class="symbol">&gt;</span>
1541
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"pack-type"</span><span class="symbol">&gt;</span><span class="normal">end</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1542
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">packing</span><span class="symbol">&gt;</span>
1543
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1544
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1545
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkMenuButton"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"gears"</span><span class="symbol">&gt;</span>
1546
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1547
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1548
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkImage"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"gears-icon"</span><span class="symbol">&gt;</span>
1549
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1550
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"icon-name"</span><span class="symbol">&gt;</span><span class="normal">emblem</span><span class="symbol">-</span><span class="normal">system</span><span class="symbol">-</span><span class="normal">symbolic</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1551
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"icon-size"</span><span class="symbol">&gt;</span><span class="number">1</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1552
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1553
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1554
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1555
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">packing</span><span class="symbol">&gt;</span>
1556
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"pack-type"</span><span class="symbol">&gt;</span><span class="normal">end</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1557
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">packing</span><span class="symbol">&gt;</span>
1558
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1559
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1560
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1561
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1562
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkSearchBar"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"searchbar"</span><span class="symbol">&gt;</span>
1563
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1564
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1565
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkSearchEntry"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"searchentry"</span><span class="symbol">&gt;</span>
1566
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">signal</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"search-changed"</span><span class="normal"> handler</span><span class="symbol">=</span><span class="string">"search_text_changed"</span><span class="symbol">/&gt;</span>
1567
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1568
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1569
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1570
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1571
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1572
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1573
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkBox"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"hbox"</span><span class="symbol">&gt;</span>
1574
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1575
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1576
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkRevealer"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"sidebar"</span><span class="symbol">&gt;</span>
1577
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1578
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"transition-type"</span><span class="symbol">&gt;</span><span class="normal">slide</span><span class="symbol">-</span><span class="normal">right</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1579
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1580
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkScrolledWindow"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"sidebar-sw"</span><span class="symbol">&gt;</span>
1581
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1582
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"hscrollbar-policy"</span><span class="symbol">&gt;</span><span class="normal">never</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1583
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"vscrollbar-policy"</span><span class="symbol">&gt;</span><span class="normal">automatic</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1584
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1585
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkListBox"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"words"</span><span class="symbol">&gt;</span>
1586
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1587
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"selection-mode"</span><span class="symbol">&gt;</span><span class="normal">none</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1588
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1589
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1590
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1591
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1592
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1593
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1594
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">child</span><span class="symbol">&gt;</span>
1595
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkStack"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"stack"</span><span class="symbol">&gt;</span>
1596
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">signal</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"notify::visible-child"</span><span class="normal"> handler</span><span class="symbol">=</span><span class="string">"visible_child_changed"</span><span class="symbol">/&gt;</span>
1597
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"visible"</span><span class="symbol">&gt;</span><span class="normal">True</span><span class="symbol">&lt;/</span><span class="normal">property</span><span class="symbol">&gt;</span>
1598
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1599
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1600
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1601
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1602
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">object</span><span class="symbol">&gt;</span>
1603
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">child</span><span class="symbol">&gt;</span>
1604
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">template</span><span class="symbol">&gt;</span>
1605
+ <span class="symbol">&lt;/</span><span class="normal">interface</span><span class="symbol">&gt;</span></pre></td>
1606
+ </tr>
1607
+ </tbody>
1608
+ </table>
1609
+ </div>
1610
+
1611
+ <p>The code to populate the sidebar with buttons for the words
1612
+ found in each file is a little too involved to go into here. But we'll
1613
+ look at the code to add the gears menu.</p>
1614
+ <p>As expected by now, the gears menu is specified in a GtkBuilder
1615
+ ui file.</p>
1616
+ <div class="informalexample">
1617
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1618
+ <tbody>
1619
+ <tr>
1620
+ <td class="listing_lines" align="right"><pre>1
1621
+ 2
1622
+ 3
1623
+ 4
1624
+ 5
1625
+ 6
1626
+ 7
1627
+ 8
1628
+ 9
1629
+ 10
1630
+ 11
1631
+ 12</pre></td>
1632
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="usertype">xml</span><span class="normal"> version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="symbol">?&gt;</span>
1633
+ <span class="symbol">&lt;</span><span class="normal">interface</span><span class="symbol">&gt;</span>
1634
+ <span class="normal"> </span><span class="symbol">&lt;!--</span><span class="normal"> interface</span><span class="symbol">-</span><span class="usertype">requires</span><span class="normal"> gtk</span><span class="symbol">+</span><span class="normal"> </span><span class="number">3.0</span><span class="normal"> </span><span class="symbol">--&gt;</span>
1635
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">menu</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"menu"</span><span class="symbol">&gt;</span>
1636
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">section</span><span class="symbol">&gt;</span>
1637
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">item</span><span class="symbol">&gt;</span>
1638
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="symbol">&gt;</span><span class="normal">_Words</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
1639
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"action"</span><span class="symbol">&gt;</span><span class="normal">win</span><span class="symbol">.</span><span class="normal">show</span><span class="symbol">-</span><span class="normal">words</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
1640
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
1641
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">section</span><span class="symbol">&gt;</span>
1642
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">menu</span><span class="symbol">&gt;</span>
1643
+ <span class="symbol">&lt;/</span><span class="normal">interface</span><span class="symbol">&gt;</span></pre></td>
1644
+ </tr>
1645
+ </tbody>
1646
+ </table>
1647
+ </div>
1648
+
1649
+ <p>To connect the menuitem to the show-words setting,
1650
+ we use a <span class="type">GSettingsAction</span>.</p>
1651
+ <div class="informalexample">
1652
+ <pre class="programlisting">
1653
+ ...
1654
+
1655
+ static void
1656
+ example_app_window_init (ExampleAppWindow *win)
1657
+ {
1658
+
1659
+ ...
1660
+
1661
+ builder = gtk_builder_new_from_resource ("/org/gtk/exampleapp/gears-menu.ui");
1662
+ menu = G_MENU_MODEL (gtk_builder_get_object (builder, "menu"));
1663
+ gtk_menu_button_set_menu_model (GTK_MENU_BUTTON (priv-&gt;gears), menu);
1664
+ g_object_unref (builder);
1665
+
1666
+ action = g_settings_create_action (priv-&gt;settings, "show-words");
1667
+ g_action_map_add_action (G_ACTION_MAP (win), action);
1668
+ g_object_unref (action);
1669
+ }
1670
+
1671
+ ...
1672
+ </pre>
1673
+ <p>(<a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application8/exampleappwin.c" target="_top">full source</a>)</p>
1674
+ </div>
1675
+ <p>What our application looks like now:</p>
1676
+ <div class="informalfigure"><div class="mediaobject"><img src="getting-started-app8.png"></div></div>
1677
+ </div>
1678
+ <div class="section">
1679
+ <div class="titlepage"><div><div><h3 class="title">
1680
+ <a name="id-1.2.3.7.12"></a>Properties</h3></div></div></div>
1681
+ <p>Widgets and other objects have many useful properties.</p>
1682
+ <p>Here we show some ways to use them in new and flexible ways,
1683
+ by wrapping them in actions with <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/gio-GPropertyAction.html#GPropertyAction"><span class="type">GPropertyAction</span></a> or by binding them
1684
+ with <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/GBinding.html"><span class="type">GBinding</span></a>.</p>
1685
+ <p>To set this up, we add two labels to the header bar in our
1686
+ window template, named <em class="parameter"><code>lines_label</code></em> and <em class="parameter"><code>lines</code></em>, and bind them to
1687
+ struct members in the private struct, as we've seen a couple of times
1688
+ by now.</p>
1689
+ <p>We add a new "Lines" menu item to the gears menu, which
1690
+ triggers the show-lines action:</p>
1691
+ <div class="informalexample">
1692
+ <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
1693
+ <tbody>
1694
+ <tr>
1695
+ <td class="listing_lines" align="right"><pre>1
1696
+ 2
1697
+ 3
1698
+ 4
1699
+ 5
1700
+ 6
1701
+ 7
1702
+ 8
1703
+ 9
1704
+ 10
1705
+ 11
1706
+ 12
1707
+ 13
1708
+ 14
1709
+ 15
1710
+ 16</pre></td>
1711
+ <td class="listing_code"><pre class="programlisting"><span class="symbol">&lt;?</span><span class="usertype">xml</span><span class="normal"> version</span><span class="symbol">=</span><span class="string">"1.0"</span><span class="symbol">?&gt;</span>
1712
+ <span class="symbol">&lt;</span><span class="normal">interface</span><span class="symbol">&gt;</span>
1713
+ <span class="normal"> </span><span class="symbol">&lt;!--</span><span class="normal"> interface</span><span class="symbol">-</span><span class="usertype">requires</span><span class="normal"> gtk</span><span class="symbol">+</span><span class="normal"> </span><span class="number">3.0</span><span class="normal"> </span><span class="symbol">--&gt;</span>
1714
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">menu</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"menu"</span><span class="symbol">&gt;</span>
1715
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">section</span><span class="symbol">&gt;</span>
1716
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">item</span><span class="symbol">&gt;</span>
1717
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="symbol">&gt;</span><span class="normal">_Words</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
1718
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"action"</span><span class="symbol">&gt;</span><span class="normal">win</span><span class="symbol">.</span><span class="normal">show</span><span class="symbol">-</span><span class="normal">words</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
1719
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
1720
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="normal">item</span><span class="symbol">&gt;</span>
1721
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"label"</span><span class="normal"> translatable</span><span class="symbol">=</span><span class="string">"yes"</span><span class="symbol">&gt;</span><span class="normal">_Lines</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
1722
+ <span class="normal"> </span><span class="symbol">&lt;</span><span class="usertype">attribute</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"action"</span><span class="symbol">&gt;</span><span class="normal">win</span><span class="symbol">.</span><span class="normal">show</span><span class="symbol">-</span><span class="normal">lines</span><span class="symbol">&lt;/</span><span class="normal">attribute</span><span class="symbol">&gt;</span>
1723
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">item</span><span class="symbol">&gt;</span>
1724
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">section</span><span class="symbol">&gt;</span>
1725
+ <span class="normal"> </span><span class="symbol">&lt;/</span><span class="normal">menu</span><span class="symbol">&gt;</span>
1726
+ <span class="symbol">&lt;/</span><span class="normal">interface</span><span class="symbol">&gt;</span></pre></td>
1727
+ </tr>
1728
+ </tbody>
1729
+ </table>
1730
+ </div>
1731
+
1732
+ <p>To make this menu item do something, we create a property
1733
+ action for the visible property of the <em class="parameter"><code>lines</code></em> label, and add it to the
1734
+ actions of the window. The effect of this is that the visibility
1735
+ of the label gets toggled every time the action is activated.</p>
1736
+ <p>Since we want both labels to appear and disappear together,
1737
+ we bind the visible property of the <em class="parameter"><code>lines_label</code></em> widget to the
1738
+ same property of the <em class="parameter"><code>lines</code></em> widget.</p>
1739
+ <div class="informalexample">
1740
+ <pre class="programlisting">
1741
+ ...
1742
+
1743
+ static void
1744
+ example_app_window_init (ExampleAppWindow *win)
1745
+ {
1746
+ ...
1747
+
1748
+ action = (GAction*) g_property_action_new ("show-lines", priv-&gt;lines, "visible");
1749
+ g_action_map_add_action (G_ACTION_MAP (win), action);
1750
+ g_object_unref (action);
1751
+
1752
+ g_object_bind_property (priv-&gt;lines, "visible",
1753
+ priv-&gt;lines_label, "visible",
1754
+ G_BINDING_DEFAULT);
1755
+ }
1756
+
1757
+ ...
1758
+ </pre>
1759
+ <p>(<a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application9/exampleappwin.c" target="_top">full source</a>)</p>
1760
+ </div>
1761
+ <p>We also need a function that counts the lines of the currently
1762
+ active tab, and updates the <em class="parameter"><code>lines</code></em> label. See the
1763
+ <a class="ulink" href="https://git.gnome.org/browse/gtk+/tree/examples/application9/exampleappwin.c" target="_top">full source</a>
1764
+ if you are interested in the details.</p>
1765
+ <p>This brings our example application to its final appearance:</p>
1766
+ <div class="informalfigure"><div class="mediaobject"><img src="getting-started-app9.png"></div></div>
1767
+ </div>
1768
+ </div>
1769
+ <div class="footer">
1770
+ <hr>
1771
+ Generated by GTK-Doc V1.19.1</div>
1772
+ </body>
1773
+ </html>