EtsT_Nt_Time_Change_Callback
Abstract
Callback: Called whenever the time visualized in a network changes.
Syntax
EtsT_Nt_Time_Change_Callback (model_hndl, callback_tag, user_state_ptr, old_offset, new_offset)
| Argument | Type | Description |
|---|---|---|
model_hndl |
EtsT_Model_Handle |
Network model with which the callback is registered. |
callback_tag |
const char * |
Name of the callback to invoke. |
user_state_ptr |
void * |
User-defined state information passed to the callback when it is invoked. |
old_offset |
double |
The network time before the visualization change. |
new_offset |
double |
The network time after the visualization change. |
Return Type
void
No return value.
Header
ets_api_nt.h
Details
This callback can be used to perform custom tasks whenever the time visualized in the network display changes. For example, if the network view is in non-geographic mode, any time -related changes to the view must be made by a user-defined time change callback. There can be multiple instances of this callback registered with a network model.
The network times passed to the callback (old_offset and new_offset) are offsets, in seconds, from the network start time.
Time change callbacks can be associated with a network model with Ets_Nt_Time_Change_Callback_Register() and removed with Ets_Nt_Time_Change_Callback_Deregister().