nsIPluginManager2

IID:d2962dc0-4eb6-11d2-8164-006008119d7a
Inherits From:nsIPluginManager

Plugin Manager 2 Interface These extensions to nsIPluginManager are only available in Communicator 5.0.


Methods

void allocateMenuID ( nsIEventHandler handler , PRBool isSubmenu , out PRInt16 result ) void beginWaitCursor ( ) void deallocateMenuID ( nsIEventHandler handler , PRInt16 menuID ) void endWaitCursor ( ) void findProxyForURL ( char* URL , out char* result ) void hasAllocatedMenuID ( nsIEventHandler handler , PRInt16 menuID , out PRBool result ) void notifyStatusChange ( nsIPlugin plugin , nsresult status ) void registerWindow ( nsIEventHandler handler , nsPluginPlatformWindowRef window ) void supportsURLProtocol ( char* protocol , out PRBool result ) void unregisterWindow ( nsIEventHandler handler , nsPluginPlatformWindowRef window )

void allocateMenuID ( nsIEventHandler handler , PRBool isSubmenu , out PRInt16 result )

Allocates a new menu ID (for the Mac).

Arguments:
handler: - the event handler for the window
isSubmenu: - whether this is a sub-menu ID or not
result: - the resulting menu ID

void beginWaitCursor ( )

Puts up a wait cursor.


void deallocateMenuID ( nsIEventHandler handler , PRInt16 menuID )

Deallocates a menu ID (for the Mac).

Arguments:
handler: - the event handler for the window
menuID: - the menu ID

void endWaitCursor ( )

Restores the previous (non-wait) cursor.


void findProxyForURL ( char* URL , out char* result )

Returns the proxy info for a given URL. The caller is required to free the resulting memory with nsIMalloc::Free. The result will be in the following format

I) "DIRECT" -- no proxy ii) "PROXY xxx.xxx.xxx.xxx" -- use proxy iii) "SOCKS xxx.xxx.xxx.xxx" -- use SOCKS iv) Mixed. e.g. "PROXY 111.111.111.111;PROXY 112.112.112.112", "PROXY 111.111.111.111;SOCKS 112.112.112.112"....

Which proxy/SOCKS to use is determined by the plugin.

Arguments:
URL
result

void hasAllocatedMenuID ( nsIEventHandler handler , PRInt16 menuID , out PRBool result )

Indicates whether this event handler has allocated the given menu ID.

Arguments:
handler: - the event handler for the window
menuID: - the menu ID
result: - returns PR_TRUE if the menu ID is allocated

void notifyStatusChange ( nsIPlugin plugin , nsresult status )

This method may be called by the plugin to indicate that an error has occurred, e.g. that the plugin has failed or is shutting down spontaneously. This allows the browser to clean up any plugin-specific state.

Arguments:
plugin: - the plugin whose status is changing
status: - the error status value

void registerWindow ( nsIEventHandler handler , nsPluginPlatformWindowRef window )

Registers a top-level window with the browser. Events received by that window will be dispatched to the event handler specified.

Arguments:
handler: - the event handler for the window
window: - the platform window reference

void supportsURLProtocol ( char* protocol , out PRBool result )

Returns true if a URL protocol (e.g. "http") is supported.

Arguments:
protocol: - the protocol name
result: - true if the protocol is supported

void unregisterWindow ( nsIEventHandler handler , nsPluginPlatformWindowRef window )

Unregisters a top-level window with the browser. The handler and window pair should be the same as that specified to RegisterWindow.

Arguments:
handler: - the event handler for the window
window: - the platform window reference

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
No comments available

Copyright © 1999 - 2005 XULPlanet.com