append-item

• (send a-mred:menu append-item name callback help-string checkable? key) -> int
      name : string
      callback : a thunk
      help-string = null : string or null
      checkable? = #f : boolean
      key = #f : a procedure of one argument or a string or #f

  Appends a new item onto the menu with the label name. When the menu item is selected, callback will be invoked with no arguments. The help-string and checkable? arguments are optional, as with append. The return value is the menu id generated for the new item.

  If key is a string, then it is prepended with

  1. "c:" under Windows
  2. "d:" under MacOS
  3. "c:m;" under X.
  and then is parsed in the same way keymap strings are parsed are parsed, see . If key is a procedure then it is passed the value of wx:platform and the result is expected to be a string naming a keymap binding. If key is #f no binding is set for the menu item.

  Since menu key bindings are very different on the various platforms, a separate keymap is kept for every platform, and all of them are built, no matter which platform is running. Thus, even if you are running under MacOS, you can tell if your keybinding causes a conflict under X Windows or Windows.

  If (mred:get-preference 'mred:menu-bindings) returns #f, no keybinding is used for this menu.