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 on a Macintosh, you can tell if your keybinding causes a conflict under X or Windows.