add docs and an example for menus

docs/make.jl

@@ -18,6 +18,7 @@ makedocs(
                      "manual/builder.md",
                      "manual/actions.md",
                      "manual/buttons.md",
+                     "manual/menus.md",
                      "manual/textwidgets.md",
                      "manual/display.md",
                      "manual/combobox.md",

examples/menubutton.jl

@@ -0,0 +1,21 @@
+using Gtk4, Gtk4.GLib
+
+# simple example defining a menu and showing it using a GtkMenuButton
+
+# the menu items are grayed out and unresponsive because no actions are defined!
+
+win = GtkWindow("MenuButton example")
+mb = GtkMenuButton(;icon_name="open-menu-symbolic")
+
+menu = GMenu()
+item1 = GMenuItem("Open...", "app.open")
+push!(menu,item1)
+item2 = GMenuItem("Save...", "app.save")
+push!(menu,item2)
+item3 = GMenuItem("Quit", "app.quit")
+push!(menu,item3)
+
+Gtk4.menu_model(mb, menu)
+
+win[] = mb
+

src/GLib/actions.jl

@@ -134,6 +134,12 @@ function GMenu(i::GMenuItem)
     G_.set_submenu(i,m)
     m
 end
+"""
+    GMenuItem(label, [detailed_action])
+
+Create a GMenuItem with attributes `label` and an optional `detailed_action`, which is
+an action name with an optional detail argument.
+"""
 GMenuItem(label,detailed_action = nothing) = G_.MenuItem_new(label, detailed_action)
 
 push!(m::GMenu, i::GMenuItem) = (G_.append_item(m,i); m)

test/gui/window.jl

@@ -25,7 +25,7 @@ visible(w,true)
 
 @test Gtk4.issuspended(w) == false
 @test Gtk4.isfullscreen(w) == false
-#@test Gtk4.isactive(w) == true
+#@test Gtk4.isactive(w) == true  # fails on Ubuntu in CI
 
 m = Gtk4.monitor(w)
 if m!==nothing