tcRegPostLoadTrigger

tcRegPostLoadTrigger(
s_function
[ x_priority ]
) 
=> t / nil

Description

Registers a trigger function the system calls after loading a technology file. The s_function argument is a SKILL procedure with two arguments: the database identifier of the technology database and the name of the ASCII technology file you are loading. Trigger functions are called in order of priority, with 0 having the highest priority. If you do not specify a priority argument, the default is the lowest priority (that is, it executes after any other trigger function that specifies a priority).

You can use this function to keep track of the contents of the technology file or to update any related technology data based on the contents of the technology file.

Arguments

s_function	Symbol indicating the name of the trigger function. The format is as follows: function( d_techId t_techFileName ) => t / nil where, d_techId is the database identifier of the technology database. t_techFileName is the name of the ASCII technology file. Returns t if the database identifier is loaded successfully; returns nil if the database identifier or ASCII technology file does not exist.
x_priority	Priority of this trigger function, with 0 having the highest priority. If you do not specify a priority argument, by default it takes the lowest priority. It means, this function is executed after any other trigger function that specifies a priority. Valid values: Any integer

Value Returned

t	The trigger function is registered.
nil	The SKILL procedure does not exist or is incomplete; the trigger function did not register.

Example

procedure(MYPostLoadTriggerFunc(techId techfile)
    if(techId~>owner == "sysAdmin" && techId~>mode == "a" 
    then
    ; set flag to indicate that tech data has 
    ; been overwritten
    techId~>myTechDataHasBeenModifiedFlag = t
    )
)
tcRegPostLoadTrigger(’MYPostLoadTriggerFunc)

Registers a trigger function that indicates that the technology data in the technology library has been overwritten.

Return to top