Public Member Functions

amIWebInstallListener Interface Reference

The registered amIWebInstallListener is used to notify about new installs triggered by websites. More...

import "amIWebInstallListener.idl";

List of all members.

Public Member Functions

NS_SCRIPTABLE NS_IMETHOD OnWebInstallDisabled (nsIDOMWindowInternal *aWindow, nsIURI *aUri, nsIVariant **aInstalls, PRUint32 aCount)=0
 Called when installation by websites is currently disabled.
NS_SCRIPTABLE NS_IMETHOD OnWebInstallBlocked (nsIDOMWindowInternal *aWindow, nsIURI *aUri, nsIVariant **aInstalls, PRUint32 aCount, PRBool *_retval NS_OUTPARAM)=0
 Called when the website is not allowed to directly prompt the user to install add-ons.
NS_SCRIPTABLE NS_IMETHOD OnWebInstallRequested (nsIDOMWindowInternal *aWindow, nsIURI *aUri, nsIVariant **aInstalls, PRUint32 aCount, PRBool *_retval NS_OUTPARAM)=0
 Called when a website wants to ask the user to install add-ons.
void onWebInstallDisabled (in nsIDOMWindowInternal aWindow, in nsIURI aUri,[array, size_is(aCount)] in nsIVariant aInstalls,[optional] in PRUint32 aCount)
 Called when installation by websites is currently disabled.
boolean onWebInstallBlocked (in nsIDOMWindowInternal aWindow, in nsIURI aUri,[array, size_is(aCount)] in nsIVariant aInstalls,[optional] in PRUint32 aCount)
 Called when the website is not allowed to directly prompt the user to install add-ons.
boolean onWebInstallRequested (in nsIDOMWindowInternal aWindow, in nsIURI aUri,[array, size_is(aCount)] in nsIVariant aInstalls,[optional] in PRUint32 aCount)
 Called when a website wants to ask the user to install add-ons.

Detailed Description

The registered amIWebInstallListener is used to notify about new installs triggered by websites.

The default implementation displays a confirmation dialog when add-ons are ready to install and uses the observer service to notify when installations are blocked.


Member Function Documentation

NS_SCRIPTABLE NS_IMETHOD amIWebInstallListener::OnWebInstallBlocked ( nsIDOMWindowInternal aWindow,
nsIURI aUri,
nsIVariant **  aInstalls,
PRUint32  aCount,
PRBool *_retval  NS_OUTPARAM 
) [pure virtual]

Called when the website is not allowed to directly prompt the user to install add-ons.

Parameters:
aWindow The window that triggered the installs
aUri The URI of the site that triggered the installs
aInstalls The AddonInstalls that were blocked
aCount The number of AddonInstalls
Returns:
true if the caller should start the installs
boolean amIWebInstallListener::onWebInstallBlocked ( in nsIDOMWindowInternal  aWindow,
in nsIURI  aUri,
[array, size_is(aCount)] in nsIVariant  aInstalls,
[optional] in PRUint32  aCount 
)

Called when the website is not allowed to directly prompt the user to install add-ons.

Parameters:
aWindow The window that triggered the installs
aUri The URI of the site that triggered the installs
aInstalls The AddonInstalls that were blocked
aCount The number of AddonInstalls
Returns:
true if the caller should start the installs
NS_SCRIPTABLE NS_IMETHOD amIWebInstallListener::OnWebInstallDisabled ( nsIDOMWindowInternal aWindow,
nsIURI aUri,
nsIVariant **  aInstalls,
PRUint32  aCount 
) [pure virtual]

Called when installation by websites is currently disabled.

Parameters:
aWindow The window that triggered the installs
aUri The URI of the site that triggered the installs
aInstalls The AddonInstalls that were blocked
aCount The number of AddonInstalls
void amIWebInstallListener::onWebInstallDisabled ( in nsIDOMWindowInternal  aWindow,
in nsIURI  aUri,
[array, size_is(aCount)] in nsIVariant  aInstalls,
[optional] in PRUint32  aCount 
)

Called when installation by websites is currently disabled.

Parameters:
aWindow The window that triggered the installs
aUri The URI of the site that triggered the installs
aInstalls The AddonInstalls that were blocked
aCount The number of AddonInstalls
NS_SCRIPTABLE NS_IMETHOD amIWebInstallListener::OnWebInstallRequested ( nsIDOMWindowInternal aWindow,
nsIURI aUri,
nsIVariant **  aInstalls,
PRUint32  aCount,
PRBool *_retval  NS_OUTPARAM 
) [pure virtual]

Called when a website wants to ask the user to install add-ons.

Parameters:
aWindow The window that triggered the installs
aUri The URI of the site that triggered the installs
aInstalls The AddonInstalls that were requested
aCount The number of AddonInstalls
Returns:
true if the caller should start the installs
boolean amIWebInstallListener::onWebInstallRequested ( in nsIDOMWindowInternal  aWindow,
in nsIURI  aUri,
[array, size_is(aCount)] in nsIVariant  aInstalls,
[optional] in PRUint32  aCount 
)

Called when a website wants to ask the user to install add-ons.

Parameters:
aWindow The window that triggered the installs
aUri The URI of the site that triggered the installs
aInstalls The AddonInstalls that were requested
aCount The number of AddonInstalls
Returns:
true if the caller should start the installs

The documentation for this interface was generated from the following files: