OnSourceDownloadProgressChanged (Silverlight Plug-in Object)
Gets or sets the name of the event handler that is called when the source download progress changes.
<object ...> <param name="onsourcedownloadprogresschanged" value="functionname"/> ... </object>
Not implemented in the functions.
Do not use; use the object parameter as the handler attachment point.
You can handle this event in order to report download progress in a splash screen or in the hosting HTML page.
The event reports progress for the package that has been requested through the Source property. The event that reports download progress is raised at intervals that are determined internally based on the size and the time of the download. The event is not raised as soon a particular percentage increment is downloaded. For short downloads, the event might be raised only a few times. For long downloads, the event might be raised thousands of times.
If you are referencing a Source that is cross-domain from the hosting HTML, handlers for OnSourceDownloadComplete or OnSourceDownloadProgressChanged are never invoked. Therefore you can only display indeterminate splash screens if loading source cross-domain. The hosting HTML may wish to assign a handler for OnLoad in this case, as it is the best available object lifetime event for resetting state after the source XAP loads.
For more information about how to work with splash screens, see Silverlight Splash Screens.
Arguments for an OnSourceDownloadProgressChanged Function
The Silverlight plug-in that raised the event.
An object that contains information about download progress. The Progress property of this object contains a number between 0 and 1, which indicates how much of the document has been downloaded.