ARSperl Programmer's Manual - ars_SetActiveLink

## `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