Description
Fired when an embedded image is about to be loaded, allowing the container to cancel or re-direct the object load.
Arguments
|
Name |
Type |
I/O |
Description |
|
ImageURL |
String (by Reference) |
Both |
The URL of the image to be loaded. The image is identified by the URL initially issued even if subsequently redirected by the container. |
|
Cancel |
Boolean (by Reference) |
Out |
Leave False to allow this load to proceed, or set to True to veto loading of ImageURL. |
Remarks
This event allows the container to intercept and veto the loading of the embedded image, or to allow the load operation to proceed but from a different URL. Alternatively, setting Cancel to True instructs Webster to completely abandon the request.
When the URL is changed by the container, the image is retrieved from the changed URL but remains internally identified as being from the original URL. Any HTML reference to the original URL will then be directed to that image.