imgIRequest Interface

 imgIRequest interface

 @author Stuart Parmenter <stuart@mozilla.com>
 @version 0.1
 @see imagelib2

[scriptable, uuid(a297d3fa-5e0c-4e59-9f30-a01c9d4f3f8b)]

Constants

 Bits set in the return value from imageStatus
 @name statusflags

const long STATUS_NONE = 0

const long STATUS_SIZE_AVAILABLE = 1

const long STATUS_LOAD_PARTIAL = 2

const long STATUS_LOAD_COMPLETE = 4

const long STATUS_ERROR = 8

const long STATUS_FRAME_COMPLETE = 16

Attributes

 The URI the image load was started with.  Note that this might not be the
 actual URI for the image (e.g. if HTTP redirects happened during the
 load).

readonly attribute nsIURI URI

readonly attribute imgIDecoderObserver decoderObserver

 the image container...
 @return the image object associated with the request.
 @attention NEED DOCS

readonly attribute imgIContainer image

 The principal gotten from the channel the image was loaded from.

readonly attribute nsIPrincipal imagePrincipal

 something
 @attention NEED DOCS

readonly attribute unsigned long imageStatus

readonly attribute string mimeType

Methods

 Cancels this request as in nsIRequest::Cancel(); further, also nulls out
 decoderObserver so it gets no further notifications from us.

 NOTE: You should not use this in any new code; instead, use cancel(). Note
 that cancel() is asynchronous, which means that some time after you call
 it, the listener/observer will get an OnStopRequest(). This means that, if
 you're the observer, you can't call cancel() from your destructor.

void cancelAndForgetObserver(in nsresult aStatus)

 Clone this request; the returned request will have aObserver as the
 observer.  aObserver will be notified synchronously (before the clone()
 call returns) with all the notifications that have already been dispatched
 for this image load.

imgIRequest clone(in imgIDecoderObserver aObserver)