Runtime.StatusChanged Event
Occurs when the status of some Carmenta Engine objects have changed or when FireStatusChanged is called.
Syntax
public event StatusChangedEventHandler StatusChangedRemarks
Datasets are one example of Carmenta Engine objects that may fire this event. When a dataset is performing work that takes a lot of time, this event can be used to get information that would suit a progress bar or log. The following example shows a typical set of events generated by a DtedDataSet indexing a small number of files. Note that all the events in this example are part of the same job, indicated by having the same Id. The last event that occurs has IsLast set to True.
Id | Message | PercentComplete | IsPercentCompleteValid | IsLast |
|---|---|---|---|---|
1 | Initializing dataset DtedDataSet0 | 0 | True | False |
1 | Building index for DtedDataSet0 | 0 | True | False |
1 | Building index for DtedDataSet0 | 0 | True | False |
1 | Building index for DtedDataSet0 | 8 | True | False |
1 | Building index for DtedDataSet0 | 16 | True | False |
1 | Building index for DtedDataSet0 | 25 | True | False |
1 | Building index for DtedDataSet0 | 33 | True | False |
1 | Building index for DtedDataSet0 | 41 | True | False |
1 | Building index for DtedDataSet0 | 50 | True | False |
1 | Building index for DtedDataSet0 | 58 | True | False |
1 | Building index for DtedDataSet0 | 66 | True | False |
1 | Building index for DtedDataSet0 | 75 | True | False |
1 | Building index for DtedDataSet0 | 83 | True | False |
1 | 0 | True | True |
The event will be fired on the thread that caused the status change, which could be the application GUI thread or any background thread.
Platforms
Windows, Linux, Android