Readonly
MIMETypeThe MIME type of this MIMEInfo.
String representing the MIME type.
use nsIHandlerInfo::type instead.
alwaysAskBeforeHandling: if true, we should always give the user a dialog asking how to dispose of this content.
Readonly
defaultA pretty name description of the associated default application. Only usable if hasDefaultHandler is true.
A human readable description of the handler type
Readonly
hasIndicates whether a default application handler exists, i.e. whether launchWithFile with action = useSystemDefault is possible and defaultDescription will contain usable information.
Readonly
possibleApplications that can handle this content type.
The list will include the preferred handler, if any. Elements of this array are nsIHandlerApp objects, and this attribute will always reference an array, whether or not there are any possible handlers. If there are no possible handlers, the array will contain no elements, so just check its length (nsIArray::length) to see if there are any possible handlers.
Readonly
possibleReturns a list of nsILocalHandlerApp objects containing handlers associated with this mimeinfo. Implemented per platform using information in this object to generate the best list. Typically used for an "open with" style user option.
nsIArray of nsILocalHandlerApp
preferredAction is how the user specified they would like to handle this content type: save to disk, use specified helper app, use OS default handler or handle using navigator; possible value constants listed below
The application the user has said they want associated with this content type. This is not always guaranteed to be set!!
Returns the first extension association in the internal set of extensions.
The first extension.
Readonly
typeThe type of this handler info. For MIME handlers, this is the MIME type. For protocol handlers, it's the scheme.
String representing the type.
Optional
aInstancePtr: objectA run time mechanism for interface discovery.
NS_OK if the interface is supported by the associated instance, NS_NOINTERFACE if it is not.
aInstancePtr must not be null.
[in] A requested interface IID
[out] A pointer to an interface pointer to receive the result.
Launches the application with the specified file, in a way that depends on the value of preferredAction. preferredAction must be useHelperApp or useSystemDefault.
NS_ERROR_INVALID_ARG if action is not valid for this function. Other exceptions may be thrown.
The file to launch this application with.
Launches the application with the specified URI, in a way that depends on the value of preferredAction. preferredAction must be useHelperApp or useSystemDefault.
Only the URI scheme is used to determine how to launch. This is essentially a pass-by-value operation. This means that in the case of a file: URI, the handler that is registered for file: will be launched and our code will not make any decision based on the content-type or extension, though the invoked file: handler is free to do so.
NS_ERROR_INVALID_ARG if preferredAction is not valid for this call. Other exceptions may be thrown.
The URI to launch this application with
The window to parent the dialog against, and, if a web handler is chosen, it is loaded in this window as well. See nsIHandlerApp.launchWithURI for more details.
Generated using TypeDoc
nsIMIMEInfo extends nsIHandlerInfo with a bunch of information specific to MIME content-types. There is a one-to-many relationship between MIME types and file extensions. This means that a MIMEInfo object may have multiple file extensions associated with it. However, the reverse is not true.
MIMEInfo objects are generally retrieved from the MIME Service
See
nsIMIMEService