WebPlugInViewFactory Protocol Reference
| Conforms to | |
| Framework | |
| Declared in | WebKit/WebPlugInViewFactory.h
|
| Availability | Available in Mac OS X v10.3.9 and later.
|
| Companion guides | |
Overview
An WebPlugInViewFactory object is used to create an NSView for a plug-in. The principal class in a plug-in bundle must conform to this protocol.
Tasks
Creating the Plug-in View
Class Methods
plugInViewWithArguments:
Creates a new plug-in view.
+ (NSView *)plugInViewWithArguments:(NSDictionary *)arguments
Discussion
This method returns an NSView object that conforms to the WebPlugIn informal protocol. The arguments dictionary should be specified by the keys and objects described in “Constants.” This method is required.
Availability
- Available in Mac OS X v10.3.9 and later.
Constants
The following constants are defined by WebPlugInViewFactory. They define the keys used to access the values in the arguments dictionary passed in to the plugInViewWithArguments: method. Note that WebPlugInBaseURLKey and WebPlugInAttributesKey will always correspond to data, the others may be nil.
Constant | Description |
WebPlugInBaseURLKey | The base URL of the document containing the plug-in's view. Required key. |
WebPlugInAttributesKey | The NSDictionary object containing all names and values of all attributes of the plug-in’s associated HTML element, as well as all names and values of the parameters to be passed to the plug-in. For example, this dictionary will contain all PARAM elements within an APPLET element. If attribute and parameter names conflict, the attributes of an element take precedence over any of its parameters. All keys and values in this dictionary must be of type NSString. Required key. |
WebPlugInContainerKey | An object that conforms to the WebPlugInContainer informal protocol. This object is used for callbacks from the plug-in to the enclosing application. If WebPlugInContainerKey is nil, no callbacks will occur. |
WebPlugInContainingElementKey | If an element of the page’s Document Object Model was used to specify the plug-in, this will contain that element. Otherwise, it will be nil. |