Description: This function adds a contributor to a container.
Returns: Nothing
Usage: Script.
Format: AddContributor(HandleName, ArrayName, CountName, ContainerObj, ContributorObj, IndexAddress, Value, CountIncrement);
Parameters: HandleName { text } { required } { no default: }
HandleName is the name of the handle variable in the container module.
ArrayName { text } { optional } { no default: }
ArrayName the name of the variable in the ContainerObj that holds an array of values to which the contributor is to be added. The ArrayName parameter may be invalid if there is no such array in the container.
CountName { text } { optional } { no default: }
CountName is the name of the variable in the ContainerObj that holds a count of the current number of this type of contributor. CountName may be invalid if no such variable exists in the ContainerObj. Not all contributors need to be counted. CountIncrement determines the initial change in the count and the contributor must maintain the count.
ContainerObj { object value } { required } { no default: }
ContainerObj is the object value of the container tag module.
ContributorObj { object value } { required } { no default: }
ContributerObj is the object value of the new contributor to add to the container.
IndexAddress { pointer } { optional } { no default: }
IndexAddress is the address of the variable holding the contributor index.
Value { numeric } { required } { no default: }
Value is the current value to set in the container's ArrayName array. Value may be Invalid. Value may also be updated at any time by the contributor by scoping into the ArrayName array in the container, and setting the array element at the index that will be set in the variable pointed to by IndexAddress.
CountIncrement { numeric } { optional } { no default: }
CountIncrement is the value that will be added to the variable in the container that has the same name as CountName. CountIncrement's value is usually a "1" or a "0", indicating whether or not the contributor is actively contributing its value. The contributor will increment or decrement the value of the CountName variable as the corresponding state of the contributor changes.
Comments: This function can be called from the contributor.