WebPlugInContainer Protocol Reference

(informal protocol)

Framework
/System/Library/Frameworks/WebKit.framework
Availability
Available in OS X v10.3.9 and later.
Declared in
WebPluginContainer.h
Companion guides
Web Kit Plug-In Programming Topics
WebKit Objective-C Programming Guide

Overview

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

Tasks

Performing Actions on the Enclosing Container

Obtaining Information About the Container

Instance Methods

webFrame

Returns the WebFrame that contains the plug-in.

- (WebFrame *)webFrame
Return Value

The WebFrame that contains the plug-in.

Discussion

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

Availability
  • Available in 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
Parameters
request

The request that specifies the URL.

target

The frame into which the URL is loaded.

Discussion

If the frame specified by target is not found, a new window is opened, loaded with the URL request, and given the specified frame name. If target is nil, the frame enclosing the plug-in is loaded with the URL request.

Availability
  • Available in OS X v10.3.9 and later.
Declared In
WebPluginContainer.h

webPlugInContainerSelectionColor

Returns the plug-in selection color.

- (NSColor *)webPlugInContainerSelectionColor
Return Value

The plug-in selection color.

Discussion

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

Availability
  • Available in OS X v10.3.9 and later.
Declared In
WebPluginContainer.h

webPlugInContainerShowStatus:

Tells the container to show a status message.

- (void)webPlugInContainerShowStatus:(NSString *)message
Parameters
message

The status message to be displayed.

Availability
  • Available in OS X v10.3.9 and later.
Declared In
WebPluginContainer.h