From b3150026383a9351cc57635dbb6707d0e457e5ff Mon Sep 17 00:00:00 2001 From: kotontrion Date: Wed, 12 Feb 2025 17:28:07 +0100 Subject: tray: add missing doc comments --- lib/tray/trayItem.vala | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) (limited to 'lib/tray/trayItem.vala') diff --git a/lib/tray/trayItem.vala b/lib/tray/trayItem.vala index 6da51cb..f753cd0 100644 --- a/lib/tray/trayItem.vala +++ b/lib/tray/trayItem.vala @@ -165,13 +165,22 @@ public class TrayItem : Object { private DBusMenu.Importer menu_importer; + /** + * The MenuModel describing the menu for this TrayItem to be used with a MenuButton or PopoverMenu. + * The actions for this menu are defined in [property@AstalTray.TrayItem:action-group]. + */ public MenuModel? menu_model { owned get { if (menu_importer == null) return null; return menu_importer.model; } } - + + /** + * The ActionGroup containing the actions for the menu. All actions have the `dbusmenu` prefix and are + * setup to work with the [property@AstalTray.TrayItem:menu-model]. Make sure to insert this action group + * into a parent widget of the menu, eg the MenuButton for which the MenuModel for this TrayItem is set. + */ public ActionGroup? action_group { owned get { if (menu_importer == null) return null; -- cgit v1.2.3