2012-05-21 04:12:37 -07:00
|
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
|
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
|
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
2007-07-10 22:59:56 -07:00
|
|
|
|
|
|
|
|
#include "nsISupports.idl"
|
|
|
|
|
|
|
|
|
|
interface nsICommandLine;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Validates arguments on the command line of an XUL application.
|
|
|
|
|
*
|
|
|
|
|
* Each validator is registered in the category "command-line-validator".
|
|
|
|
|
* The entries in this category are read in alphabetical order, and each
|
|
|
|
|
* category value is treated as a service contractid implementing this
|
|
|
|
|
* interface.
|
|
|
|
|
*
|
|
|
|
|
* By convention, validator with ordinary priority should begin with "m".
|
|
|
|
|
*
|
|
|
|
|
* Example:
|
|
|
|
|
* Category Entry Value
|
|
|
|
|
* command-line-validator b-browser @mozilla.org/browser/clh;1
|
|
|
|
|
* command-line-validator m-edit @mozilla.org/composer/clh;1
|
|
|
|
|
* command-line-validator m-irc @mozilla.org/chatzilla/clh;1
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
[scriptable, uuid(5ecaa593-7660-4a3a-957a-92d5770671c7)]
|
|
|
|
|
interface nsICommandLineValidator : nsISupports
|
|
|
|
|
{
|
|
|
|
|
/**
|
|
|
|
|
* Process the command-line validators in the proper order, calling
|
|
|
|
|
* "validate()" on each.
|
|
|
|
|
*
|
|
|
|
|
* @throws NS_ERROR_ABORT if any validator throws NS_ERROR_ABORT. All other
|
|
|
|
|
* errors thrown by validators will be silently ignored.
|
|
|
|
|
*/
|
|
|
|
|
void validate(in nsICommandLine aCommandLine);
|
|
|
|
|
};
|
