ars_CreateVUI(ctrl, vuiHash)

This function creates a new VUI. You must first populate the vuiHash before calling this routine.

vuiHash is an VUI Attributes hash.

On success
Returns 1
On failure
Returns 0

Example:

This example copies an existing VUI to a new VUI. I.e. it simply re-saves the VUI link under a new name.
      ($v = ars_GetVUI( $c, "Schema", $vuiId )) ||
	    die $ars_errstr;
      $v->{vuiId}   = $v->{vuiId} + 100000;
      $v->{vuiName} = "Copy of ".$v->{vuiName};
      ars_CreateVUI( $c, "Schema", $v ) || 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