18e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/* 28e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * Copyright (C) 2006, 2007, 2008 Apple 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 * 1. Redistributions of source code must retain the above copyright 88e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * notice, this list of conditions and the following disclaimer. 98e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 2. Redistributions in binary form must reproduce the above copyright 108e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * notice, this list of conditions and the following disclaimer in the 118e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * documentation and/or other materials provided with the distribution. 128e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * 138e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY 148e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 158e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 168e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR 178e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 188e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 198e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 208e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY 218e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 228e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 238e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 248e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 258e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 268e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#ifndef DO_NO_IMPORTS 278e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectimport "oaidl.idl"; 288e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectimport "ocidl.idl"; 298e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectimport "DOMCore.idl"; 308e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectimport "IWebResource.idl"; 318e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project#endif 328e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 338e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectinterface IWebResource; 348e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 358e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project/*! 368e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @class WebArchive 378e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @discussion WebArchive represents a main resource as well as all the subresources and subframes associated with the main resource. 388e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 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. 398e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project This class can be used for saving standalone web pages, representing portions of a web page on the pasteboard, or any other 408e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project application where one class is needed to represent rich web content. 418e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project*/ 428e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project[ 438e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project object, 448e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project oleautomation, 458e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project uuid(F07D5252-F66E-4a4d-B9DC-33BD11DCC138), 468e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project pointer_default(unique) 478e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project] 488e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Projectinterface IWebArchive : IUnknown 498e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project{ 508e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /*! 518e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method initWithMainResource:subresources:subframeArchives: 528e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @abstract The initializer for WebArchive. 538e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param mainResource The main resource of the archive. 548e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param subresources The subresources of the archive (can be nil). 558e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param subframeArchives The archives representing the subframes of the archive (can be nil). 568e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result An initialized WebArchive. 578e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project - (id)initWithMainResource:(WebResource *)mainResource subresources:(NSArray *)subresources subframeArchives:(NSArray *)subframeArchives; 588e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 598e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project HRESULT initWithMainResource([in] IWebResource* mainResource, [in, size_is(cSubResources)] IWebResource** subResources, [in] int cSubResources, [in, size_is(cSubFrameArchives)] IWebArchive** subFrameArchives, [in] int cSubFrameArchives); 608e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 618e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /*! 628e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method initWithData: 638e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @abstract The initializer for creating a WebArchive from data. 648e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param data The data representing the archive. This can be obtained using WebArchive's data method. 658e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result An initialized WebArchive. 668e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project - (id)initWithData:(NSData *)data; 678e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 688e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project HRESULT initWithData([in] IStream* data); 698e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 708e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /*! 718e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method initWithData: 728e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @abstract The initializer for creating a WebArchive from data. 738e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @param data The data representing the archive. This can be obtained using WebArchive's data method. 748e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result An initialized WebArchive. 758e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project - (id)initWithData:(NSData *)data; 768e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 778e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project HRESULT initWithNode([in] IDOMNode* node); 788e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 798e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /*! 808e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method mainResource 818e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result The main resource of the archive. 828e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project - (WebResource *)mainResource; 838e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 848e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project HRESULT mainResource([out, retval] IWebResource** resource); 858e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 868e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /*! 878e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method subresources 888e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result The subresource of the archive (can be nil). 898e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project - (NSArray *)subresources; 908e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 918e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project HRESULT subResources([out, retval] IEnumVARIANT** enumResources); 928e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 938e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /*! 948e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method subframeArchives 958e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result The archives representing the subframes of the archive (can be nil). 968e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project - (NSArray *)subframeArchives; 978e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 988e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project HRESULT subframeArchives([out, retval] IEnumVARIANT** enumSubframes); 998e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project 1008e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project /*! 1018e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @method data 1028e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @result The data representation of the archive. 1038e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project @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 1048e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project using WebArchivePboardType. To create a WebArchive using the returned data, call initWithData:. 1058e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project - (NSData *)data; 1068e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project */ 1078e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project HRESULT data([out, retval] IStream** stream); 1088e35f3cfc7fba1d1c829dc557ebad6409cbe16a2The Android Open Source Project} 109