ars_SetActiveLink(ctrl, name, activeLinkHash)

This function modifies an existing active link. You must first populate the activeLinkHash before calling this routine.

name is the name of the active link.

activeLinkHash is a partially assigned Active Link Attributes hash.

On success
Returns 1
On failure
Returns 0

Example:

This example changes the name and execution mask of an existing active link.
      ($al = ars_GetActiveLink($c, "TEST:ActiveLink")) ||
	    die $ars_errstr;

      ars_SetActiveLink( $c, $al->{name}, {
        name        => $al->{name} . "(renamed)",
        executeMask => 1 + 16,    # button, display
      } ) || die $ars_errstr;
      

This function was introduced in version 1.90 of ARSperl

<-- Back to Table of Contents