nsIMozIconURI Interface

 nsIIconURI

 This interface derives from nsIURI, to provide additional information
 about moz-icon URIs.

 What *is* a moz-icon URI you ask?  Well, it has the following syntax:

 moz-icon://[<file-uri> | <file-with-extension> | <stock-image>]? ['?'[<parameter-value-pairs>]]

 <file-uri> is a legal file: URI spec.  You only need to specify a file: URI inside the icon
 if the file you want the icon for actually exists.

 <file-with-extension> is any filename with an extension, e.g. "dummy.html".
 If the file you want an icon for isn't known to exist, you can omit the file URI, and just
 place a dummy file name with the extension or content type you want: moz-icon://dummy.html.

 <stock-image> is of the format:   stock/<icon-name>

 <icon-name> is a valid icon name, such as 'ok', 'cancel', 'yes', 'no'.
 XXXcaa Should these considered platform dependent or can we share and document them?

 Legal parameter value pairs are listed below:

   Parameter:   size
   Values:      [<integer> | button | toolbar | toolbarsmall | menu | dialog]
   Description: If integer, this is the desired size in square pixels of the icon
                Else, use the OS default for the specified keyword context.

   Parameter:   state
   Values:      [normal | disabled]
   Description: The state of the icon.

   Parameter:   contentType
   Values:      <mime-type>
   Description: The mime type we want an icon for. This is ignored by stock images.