WebKit/win/Interfaces/IWebFrameLoadDelegate.idl
changeset 0 4f2f89ce4247
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/WebKit/win/Interfaces/IWebFrameLoadDelegate.idl	Fri Sep 17 09:02:29 2010 +0300
@@ -0,0 +1,205 @@
+/*
+ * Copyright (C) 2006, 2007, 2008, 2009 Apple 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.
+ *
+ * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``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 COMPUTER, INC. OR
+ * 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. 
+ */
+
+#ifndef DO_NO_IMPORTS
+import "oaidl.idl";
+import "ocidl.idl";
+import "IWebScriptObject.idl";
+import "IWebView.idl";
+import "IWebFrame.idl";
+import "JavaScriptCoreAPITypes.idl";
+#endif
+
+interface IWebError;
+interface IWebFrame;
+interface IWebScriptObject;
+interface IWebView;
+
+/*!
+    @category WebFrameLoadDelegate
+    @discussion A WebView's WebFrameLoadDelegate tracks the loading progress of its frames.
+    When a data source of a frame starts to load, the data source is considered "provisional".
+    Once at least one byte is received, the data source is considered "committed". This is done
+    so the contents of the frame will not be lost if the new data source fails to successfully load.
+    @interface NSObject (WebFrameLoadDelegate)
+*/
+
+[
+    object,
+    oleautomation,
+    uuid(3354665B-84BA-4fdf-B35E-BF5CF9D96026),
+    pointer_default(unique)
+]
+interface IWebFrameLoadDelegate : IUnknown
+{
+    /*!
+        @method webView:didStartProvisionalLoadForFrame:
+        @abstract Notifies the delegate that the provisional load of a frame has started
+        @param webView The WebView sending the message
+        @param frame The frame for which the provisional load has started
+        @discussion This method is called after the provisional data source of a frame
+        has started to load.
+        - (void)webView:(WebView *)sender didStartProvisionalLoadForFrame:(WebFrame *)frame;
+    */
+    HRESULT didStartProvisionalLoadForFrame([in] IWebView* webView, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:didReceiveServerRedirectForProvisionalLoadForFrame:
+        @abstract Notifies the delegate that a server redirect occurred during the provisional load
+        @param webView The WebView sending the message
+        @param frame The frame for which the redirect occurred
+        - (void)webView:(WebView *)sender didReceiveServerRedirectForProvisionalLoadForFrame:(WebFrame *)frame;
+    */
+    HRESULT didReceiveServerRedirectForProvisionalLoadForFrame([in] IWebView* webView, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:didFailProvisionalLoadWithError:forFrame:
+        @abstract Notifies the delegate that the provisional load has failed
+        @param webView The WebView sending the message
+        @param error The error that occurred
+        @param frame The frame for which the error occurred
+        @discussion This method is called after the provisional data source has failed to load.
+        The frame will continue to display the contents of the committed data source if there is one.
+        - (void)webView:(WebView *)sender didFailProvisionalLoadWithError:(NSError *)error forFrame:(WebFrame *)frame;
+    */
+    HRESULT didFailProvisionalLoadWithError([in] IWebView* webView, [in] IWebError* error, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:didCommitLoadForFrame:
+        @abstract Notifies the delegate that the load has changed from provisional to committed
+        @param webView The WebView sending the message
+        @param frame The frame for which the load has committed
+        @discussion This method is called after the provisional data source has become the
+        committed data source.
+
+        In some cases, a single load may be committed more than once. This happens
+        in the case of multipart/x-mixed-replace, also known as "server push". In this case,
+        a single location change leads to multiple documents that are loaded in sequence. When
+        this happens, a new commit will be sent for each document.
+        - (void)webView:(WebView *)sender didCommitLoadForFrame:(WebFrame *)frame;
+    */
+    HRESULT didCommitLoadForFrame([in] IWebView* webView, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:didReceiveTitle:forFrame:
+        @abstract Notifies the delegate that the page title for a frame has been received
+        @param webView The WebView sending the message
+        @param title The new page title
+        @param frame The frame for which the title has been received
+        @discussion The title may update during loading; clients should be prepared for this.
+        - (void)webView:(WebView *)sender didReceiveTitle:(NSString *)title forFrame:(WebFrame *)frame;
+    */
+    HRESULT didReceiveTitle([in] IWebView* webView, [in] BSTR title, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:didReceiveIcon:forFrame:
+        @abstract Notifies the delegate that a page icon image for a frame has been received
+        @param webView The WebView sending the message
+        @param image The icon image. Also known as a "favicon".
+        @param frame The frame for which a page icon has been received
+        - (void)webView:(WebView *)sender didReceiveIcon:(NSImage *)image forFrame:(WebFrame *)frame;
+    */
+    HRESULT didReceiveIcon([in] IWebView* webView, [in] OLE_HANDLE hBitmap, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:didFinishLoadForFrame:
+        @abstract Notifies the delegate that the committed load of a frame has completed
+        @param webView The WebView sending the message
+        @param frame The frame that finished loading
+        @discussion This method is called after the committed data source of a frame has successfully loaded
+        and will only be called when all subresources such as images and stylesheets are done loading.
+        Plug-In content and JavaScript-requested loads may occur after this method is called.
+        - (void)webView:(WebView *)sender didFinishLoadForFrame:(WebFrame *)frame;
+    */
+    HRESULT didFinishLoadForFrame([in] IWebView* webView, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:didFailLoadWithError:forFrame:
+        @abstract Notifies the delegate that the committed load of a frame has failed
+        @param webView The WebView sending the message
+        @param error The error that occurred
+        @param frame The frame that failed to load
+        @discussion This method is called after a data source has committed but failed to completely load.
+        - (void)webView:(WebView *)sender didFailLoadWithError:(NSError *)error forFrame:(WebFrame *)frame;
+    */
+    HRESULT didFailLoadWithError([in] IWebView* webView, [in] IWebError* error, [in] IWebFrame* forFrame);
+
+    /*!
+        @method webView:didChangeLocationWithinPageForFrame:
+        @abstract Notifies the delegate that the scroll position in a frame has changed
+        @param webView The WebView sending the message
+        @param frame The frame that scrolled
+        @discussion This method is called when anchors within a page have been clicked.
+        - (void)webView:(WebView *)sender didChangeLocationWithinPageForFrame:(WebFrame *)frame;
+    */
+    HRESULT didChangeLocationWithinPageForFrame([in] IWebView* webView, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:willPerformClientRedirectToURL:delay:fireDate:forFrame:
+        @abstract Notifies the delegate that a frame will perform a client-side redirect
+        @param webView The WebView sending the message
+        @param URL The URL to be redirected to
+        @param seconds Seconds in which the redirect will happen
+        @param date The fire date
+        @param frame The frame on which the redirect will occur
+        @discussion This method can be used to continue progress feedback while a client-side
+        redirect is pending.
+        - (void)webView:(WebView *)sender willPerformClientRedirectToURL:(NSURL *)URL delay:(NSTimeInterval)seconds fireDate:(NSDate *)date forFrame:(WebFrame *)frame;
+    */
+    HRESULT willPerformClientRedirectToURL([in] IWebView* webView, [in] BSTR url, [in] double delaySeconds, [in] DATE fireDate, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:didCancelClientRedirectForFrame:
+        @abstract Notifies the delegate that a pending client-side redirect has been cancelled
+        @param webView The WebView sending the message
+        @param frame The frame for which the pending redirect was cancelled
+        @discussion A client-side redirect can be cancelled if a frame changes location before the timeout.
+        - (void)webView:(WebView *)sender didCancelClientRedirectForFrame:(WebFrame *)frame;
+    */
+    HRESULT didCancelClientRedirectForFrame([in] IWebView* webView, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:willCloseFrame:
+        @abstract Notifies the delegate that a frame will be closed
+        @param webView The WebView sending the message
+        @param frame The frame that will be closed
+        @discussion This method is called right before WebKit is done with the frame
+        and the objects that it contains.
+        - (void)webView:(WebView *)sender willCloseFrame:(WebFrame *)frame;
+    */
+    HRESULT willCloseFrame([in] IWebView* webView, [in] IWebFrame* frame);
+
+    /*!
+        @method webView:windowScriptObjectAvailable:
+        @abstract Notifies the delegate that the scripting object for a page is available.  This is called
+        before the page is loaded.  It may be useful to allow delegates to bind native objects to the window.
+        @param webView The webView sending the message.
+        @param windowScriptObject The WebScriptObject for the window in the scripting environment.
+        - (void)webView:(WebView *)webView windowScriptObjectAvailable:(WebScriptObject *)windowScriptObject;
+    */
+    [local] HRESULT windowScriptObjectAvailable([in] IWebView* webView, [in] JSContextRef context, [in] JSObjectRef windowScriptObject);
+
+    [local] HRESULT didClearWindowObject([in] IWebView* webView, [in] JSContextRef context, [in] JSObjectRef windowScriptObject, [in] IWebFrame* frame);
+}