---

WebPlugInContainer Protocol Reference

(informal protocol)

Overview

WebPlugInContainer is an informal protocol that enables a plug-in to send messages to the application.

Tasks

Performing Actions on the Enclosing Container

• – webPlugInContainerLoadRequest:inFrame:
• – webPlugInContainerShowStatus:

Obtaining Information About the Container

• – webFrame
• – webPlugInContainerSelectionColor

Instance Methods

webFrame

Returns the WebFrame that contains the plug-in.

- (WebFrame *)webFrame

Discussion

Only implemented by containers that are based on the Web Kit’s plug-in architecture.

Availability

• Available in Mac OS X v10.3.9 and later.

Declared In

WebPluginContainer.h

webPlugInContainerLoadRequest:inFrame:

Loads a URL into a web frame.

- (void)webPlugInContainerLoadRequest:(NSURLRequest *)request inFrame:(NSString *)target

Discussion

Tells the plug-in’s enclosing application to load a URL specified by request in the frame specified by inFrame. If the frame specified by inFrame is not found, a new window is opened, loaded with the URL request, and named with the specified frame name. If inFrame is nil, the frame enclosing the plug-in is loaded with the URL request.

Availability

• Available in Mac OS X v10.3.9 and later.

Declared In

WebPluginContainer.h

webPlugInContainerSelectionColor

Returns the plug-in selection color.

- (NSColor *)webPlugInContainerSelectionColor

Discussion

The color should be used for any special drawing when the plug-in is selected.

Availability

• Available in Mac OS X v10.3.9 and later.

Declared In

WebPluginContainer.h

webPlugInContainerShowStatus:

Tells the container to show a status message.

- (void)webPlugInContainerShowStatus:(NSString *)message

Discussion

The argument message specifies the status message to be displayed.

Availability

• Available in Mac OS X v10.3.9 and later.

Declared In

WebPluginContainer.h

---