diff etc/NEWS.8.md @ 30999:fef2957c38ec

Deprecate uimenu properties "label" and "callback" (bug #62443) Replace "label" property with "text". Replace "callback" property with "menuselectedfcn". Both old properties are hidden, but continue to exist and work as before to support old code. * NEWS.8.md: Announce deprecation. * graphics.in.h (uimenu::BEGIN_PROPERTIES): Mark "callback" property with "hgs" for hidden, get, set routines. Mark "label" property with "hgs". * graphics.in.h (uimenu::get_callback, uimenu::set_callback): New functions which simply relay calls to "get_menuselectedfcn" and "set_menuselectedfcn". * Menu.cc (Menu::actionTriggered, Menu::actionHovered): Replace "callback" with "menuselectedfcn" in gh_callback_event calls. * __init_fltk__.cc (script_cb): Rename "execute_callback" to "execute_menuselectedfcn". * __init_fltk__.cc (update_menuselectedfcn): Rename function from "update_callback". Rename "get_callback" to "get_menuselectedfcn". * __init_fltk__.cc (add_to_uimenu): Rename "update_callback" to "update_menuselectedfcn". * __init_fltk__.cc (uimenu_update): Rename "ID_CALLBACK" to "ID_MENUSELECTEDFCN". * uimenu.m: Update documentation to use "menuselectedfcn" and "text". Update demos and BIST tests to use new property names. * __add_default_menu__.m: Update code to use "menuselectedfcn" and "text".
author Rik <rik@octave.org>
date Sat, 14 May 2022 19:06:56 -0700
parents 5330efaf9476
children 81b51b823663
line wrap: on
line diff
--- a/etc/NEWS.8.md	Sat May 14 18:03:35 2022 -0700
+++ b/etc/NEWS.8.md	Sat May 14 19:06:56 2022 -0700
@@ -65,6 +65,17 @@
   storage.  This setting was `false` by default for compatibility with
   Matlab.  Now you must manually convert to full storage when desired.
 
+
+- Properties
+
+  The following property names are discouraged, but there is no fixed
+  date for their removal.
+
+  Object           | Property    | Replacement
+  -----------------|-------------|------------
+  `uimenu`         | `label`     | `text`
+  `uimenu`         | `callback`  | `menuselectedfcn`
+
 The following functions were deprecated in Octave 6 and have been removed
 from Octave 8.