diff -r 000000000000 -r dd21522fd290 webengine/osswebengine/WebKit/WebView/WebArchive.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/webengine/osswebengine/WebKit/WebView/WebArchive.h Mon Mar 30 12:54:55 2009 +0300 @@ -0,0 +1,97 @@ +/* + * Copyright (C) 2004, 2005 Apple Computer, Inc. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of + * its contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY + * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY + * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND + * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF + * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#import + +@class WebArchivePrivate; +@class WebResource; + +/*! + @const WebArchivePboardType + @abstract The pasteboard type constant used when adding or accessing a WebArchive on the pasteboard. +*/ +extern NSString *WebArchivePboardType; + +/*! + @class WebArchive + @discussion WebArchive represents a main resource as well as all the subresources and subframes associated with the main resource. + The main resource can be an entire web page, a portion of a web page, or some other kind of data such as an image. + This class can be used for saving standalone web pages, representing portions of a web page on the pasteboard, or any other + application where one class is needed to represent rich web content. +*/ +@interface WebArchive : NSObject +{ + @private + WebArchivePrivate *_private; +} + +/*! + @method initWithMainResource:subresources:subframeArchives: + @abstract The initializer for WebArchive. + @param mainResource The main resource of the archive. + @param subresources The subresources of the archive (can be nil). + @param subframeArchives The archives representing the subframes of the archive (can be nil). + @result An initialized WebArchive. +*/ +- (id)initWithMainResource:(WebResource *)mainResource subresources:(NSArray *)subresources subframeArchives:(NSArray *)subframeArchives; + +/*! + @method initWithData: + @abstract The initializer for creating a WebArchive from data. + @param data The data representing the archive. This can be obtained using WebArchive's data method. + @result An initialized WebArchive. +*/ +- (id)initWithData:(NSData *)data; + +/*! + @method mainResource + @result The main resource of the archive. +*/ +- (WebResource *)mainResource; + +/*! + @method subresources + @result The subresource of the archive (can be nil). +*/ +- (NSArray *)subresources; + +/*! + @method subframeArchives + @result The archives representing the subframes of the archive (can be nil). +*/ +- (NSArray *)subframeArchives; + +/*! + @method data + @result The data representation of the archive. + @discussion The data returned by this method can be used to save a web archive to a file or to place a web archive on the pasteboard + using WebArchivePboardType. To create a WebArchive using the returned data, call initWithData:. +*/ +- (NSData *)data; + +@end