This interface represents a content node that loads images. The interface exists to allow getting information on the images that the content node loads and to allow registration of observers for the image loads.
Implementors of this interface should handle all the mechanics of actually loading an image -- getting the URI, checking with content policies and the security manager to see whether loading the URI is allowed, performing the load, firing any DOM events as needed.
An implementation of this interface may support the concepts of a "current" image and a "pending" image. If it does, a request to change the currently loaded image will start a "pending" request which will become current only when the image is loaded. It is the responsibility of observers to check which request they are getting notifications for.
Observers added in mid-load will not get any notifications they missed. We should NOT freeze this interface without considering this issue. (It could be that the image status on imgIRequest is sufficient, when combined with the imageBlockingStatus information.)
XXXbz Do not freeze without removing imageURIChanged!
This interface is implemented by the following components:
readonly nsIURI currentURI
Gets the URI of the current request, if available. Otherwise, returns the last URI that this content tried to load, or null if there haven't been any such attempts.
readonly PRInt16 imageBlockingStatus
Returns the image blocking status (@see nsIContentPolicy). This will always be an nsIContentPolicy REJECT_* status for cases when the image was blocked. This status always refers to the CURRENT_REQUEST load.
LoadingEnabled is used to enable and disable loading in situations where loading images is unwanted. Note that enabling loading will *not* automatically trigger an image load.
void addObserver ( imgIDecoderObserver* observer )
imgIRequest* getRequest ( PRInt32 requestType )
PRInt32 getRequestType ( imgIRequest* request )
[noscript] void imageURIChanged ( AString newURI )
nsIStreamListener loadImageWithChannel ( nsIChannel channel )
void removeObserver ( imgIDecoderObserver* observer )
Used to register an image decoder observer. Typically, this will be a proxy for a frame that wants to paint the image. Notifications from ongoing image loads will be passed to all registered observers. Notifications for all request types, current and pending, will be passed through.
- observer: the observer to register
Accessor to get the image requests
- requestType: a value saying which request is wanted
- the imgIRequest object (may be null, even when no error is thrown)
Used to find out what type of request one is dealing with (eg which request got passed through to the imgIDecoderObserver interface of an observer)
- request: the request whose type we want to know
- an enum value saying what type this request is
ImageURIChanged is called when the appropriate attributes (eg 'src' for tags) change. The string passed in is the new uri string.
LoadImageWithChannel allows data from an existing channel to be used as the image data for this content node.
- channel: the channel that will deliver the data
- a stream listener to pump the image data into
Used to unregister an image decoder observer.
- observer: the observer to unregister
Reference documentation is generated from Mozilla's source.