18e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/* 28e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * Copyright (C) 2004 Apple Computer, Inc. All rights reserved. 38e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 48e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * Redistribution and use in source and binary forms, with or without 58e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * modification, are permitted provided that the following conditions 68e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * are met: 78e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 88e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 1. Redistributions of source code must retain the above copyright 98e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * notice, this list of conditions and the following disclaimer. 108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 2. Redistributions in binary form must reproduce the above copyright 118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * notice, this list of conditions and the following disclaimer in the 128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * documentation and/or other materials provided with the distribution. 138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of 148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * its contributors may be used to endorse or promote products derived 158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * from this software without specific prior written permission. 168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY 188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY 218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#import <Cocoa/Cocoa.h> 308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project This informal protocol enables a plug-in to request that its containing application 338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project perform certain operations. 348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@interface NSObject (WebPlugInContainer) 378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method webPlugInContainerLoadRequest:inFrame: 408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @abstract Tell the application to show a URL in a target frame 418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param request The request to be loaded. 428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param target The target frame. If the frame with the specified target is not 438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project found, a new window is opened and the main frame of the new window is named 448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project with the specified target. If nil is specified, the frame that contains 458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project the applet is targeted. 468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (void)webPlugInContainerLoadRequest:(NSURLRequest *)request inFrame:(NSString *)target; 488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method webPlugInContainerShowStatus: 518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @abstract Tell the application to show the specified status message. 528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param message The string to be shown. 538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (void)webPlugInContainerShowStatus:(NSString *)message; 558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method webPlugInContainerSelectionColor 588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Returns the color that should be used for any special drawing when 598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project plug-in is selected. 608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (NSColor *)webPlugInContainerSelectionColor; 628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method webFrame 658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @discussion The webFrame method allows the plug-in to access the WebFrame that 668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project contains the plug-in. This method will not be implemented by containers that 678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project are not WebKit based. 688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result Return the WebFrame that contains the plug-in. 698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project- (WebFrame *)webFrame; 718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project@end 73