ncmenu_item_set_status: man page, NEWS, python, c++ #1057

NEWS.md

@@ -1,6 +1,9 @@
 This document attempts to list user-visible changes and any major internal
 rearrangements of Notcurses.
 
+* 2.1.0 (not yet released)
+  * Add `ncmenu_item_set_status()` for disabling or enabling menu items.
+
 * 2.0.0 (2020-10-12) "Stankonia"
   * **API STABILITY!** The API expressed in 2.0.0 will be maintained throughout
     at least 2.x.x. A program compiled against 2.0.0 will continue to compile

doc/man/man3/notcurses_menu.3.md

@@ -51,6 +51,8 @@ typedef struct ncmenu_options {
 
 **int ncmenu_previtem(struct ncmenu* n);**
 
+**int ncmenu_item_set_status(struct ncmenu* n, const char* section, const char* item, bool enabled);**
+
 **const char* ncmenu_selected(const struct ncmenu* n, struct ncinput* ni);**
 
 **const char* ncmenu_mouse_selected(const struct ncmenu* n, const struct ncinput* click, struct ncinput* ni);**

include/ncpp/Menu.hh

@@ -60,6 +60,11 @@ namespace ncpp
 			return error_guard (ncmenu_previtem (menu), -1);
 		}
 
+		bool item_set_status (const char* section, const char* item, bool status) const NOEXCEPT_MAYBE
+		{
+			return error_guard (ncmenu_item_set_status (menu, section, item, status), -1);
+		}
+
 		const char* get_selected (ncinput *ni = nullptr) const noexcept
 		{
 			return ncmenu_selected (menu, ni);

python/src/notcurses/build_notcurses.py

@@ -315,6 +315,7 @@ int ncmenu_nextsection(struct ncmenu* n);
 int ncmenu_prevsection(struct ncmenu* n);
 int ncmenu_nextitem(struct ncmenu* n);
 int ncmenu_previtem(struct ncmenu* n);
+int ncmenu_item_set_status(struct ncmenu* n, const char* section, const char* item, bool enabled);
 const char* ncmenu_selected(const struct ncmenu* n, struct ncinput* ni);
 bool ncmenu_offer_input(struct ncmenu* n, const struct ncinput* nc);
 int ncmenu_destroy(struct ncmenu* n);