ARSperl Programmer's Manual - ars_CreateCharMenu

## `ars_CreateCharMenu(ctrl, menuHash)`

This function creates a new menu. You must first populate the `menuHash` before calling this routine.

On success
  Returns 1
On failure
  Returns 0

Example:

> This example copies an existing menu to a new active link. I.e. it simply re-saves the menu under a new name.

          ($m = ars_GetCharMenu($c, "C-foobar")) ||
    	    die $ars_errstr;
          $m->{name} = "Copy of ".$m->{name};
          ars_CreateCharMenu($c, $m) || die $ars_errstr;

Notes: Hash keys `helpText, owner` and `changeDiary` are optional when calling this routine.

This function was introduced in version 1.90 of ARSperl

Back to Table of Contents