initial import
[vuplus_webkit] / Source / WebKit / win / Interfaces / IWebView.idl
1 /*
2  * Copyright (C) 2006, 2007, 2008 Apple Inc.  All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
24  */
25
26 cpp_quote("/* identifiers for commands that can be called by the webview's frame */")
27 cpp_quote("enum WebViewCmd { Cut = 100, Copy, Paste, ForwardDelete, SelectAll, Undo, Redo };")
28
29 cpp_quote("#define WebViewProgressStartedNotification TEXT(\"WebProgressStartedNotification\")")
30 cpp_quote("#define WebViewProgressEstimateChangedNotification TEXT(\"WebProgressEstimateChangedNotification\")")
31 cpp_quote("#define WebViewProgressFinishedNotification TEXT(\"WebProgressFinishedNotification\")")
32 cpp_quote("#define WebViewDidChangeSelectionNotification TEXT(\"WebViewDidChangeSelectionNotification\")")
33
34 #ifndef DO_NO_IMPORTS
35 import "oaidl.idl";
36 import "ocidl.idl";
37 import "IWebUIDelegate.idl";
38 import "IWebURLResponse.idl";
39 import "IWebResourceLoadDelegate.idl";
40 import "IWebDownload.idl";
41 import "IWebFrameLoadDelegate.idl";
42 import "IWebPolicyDelegate.idl";
43 import "IWebBackForwardList.idl";
44 import "IWebHistoryItem.idl";
45 import "IWebPreferences.idl";
46 import "DOMCSS.idl";
47 import "IWebUndoManager.idl";
48 import "IWebEditingDelegate.idl";
49 import "DOMRange.idl";
50 #endif
51
52 interface IDOMCSSStyleDeclaration;
53 interface IDOMDocument;
54 interface IDOMElement;
55 interface IDOMNode;
56 interface IDOMRange;
57
58 interface IWebArchive;
59 interface IWebBackForwardList;
60 interface IWebDataSource;
61 interface IWebFrame;
62 interface IWebFrameView;
63 interface IWebHistoryItem;
64 interface IWebPreferences;
65 interface IWebScriptObject;
66
67 interface IWebUIDelegate;
68 interface IWebResourceLoadDelegate;
69 interface IWebDownloadDelegate;
70 interface IWebEditingDelegate;
71 interface IWebFrameLoadDelegate;
72 interface IWebPolicyDelegate;
73 interface IWebDocumentView;
74 interface IWebDocumentRepresentation;
75 interface IWebUndoManager;
76
77 /* These are the keys for the WebElementPropertyBag */
78 const LPCOLESTR WebElementDOMNodeKey = L"WebElementDOMNodeKey";
79 const LPCOLESTR WebElementFrameKey = L"WebElementFrameKey";
80 const LPCOLESTR WebElementImageAltStringKey = L"WebElementImageAltStringKey";
81 const LPCOLESTR WebElementImageKey = L"WebElementImageKey";
82 const LPCOLESTR WebElementImageRectKey = L"WebElementImageRectKey";
83 const LPCOLESTR WebElementImageURLKey = L"WebElementImageURLKey";
84 const LPCOLESTR WebElementIsSelectedKey = L"WebElementIsSelectedKey";
85 const LPCOLESTR WebElementMediaURLKey = L"WebElementMediaURLKey";
86 const LPCOLESTR WebElementSpellingToolTipKey = L"WebElementSpellingToolTipKey";
87 const LPCOLESTR WebElementTitleKey = L"WebElementTitleKey";
88 const LPCOLESTR WebElementLinkURLKey = L"WebElementLinkURLKey";
89 const LPCOLESTR WebElementLinkTargetFrameKey = L"WebElementLinkTargetFrameKey";
90 const LPCOLESTR WebElementLinkTitleKey = L"WebElementLinkTitleKey";
91 const LPCOLESTR WebElementLinkLabelKey = L"WebElementLinkLabelKey";
92 const LPCOLESTR WebElementIsContentEditableKey = L"WebElementIsContentEditableKey";
93
94 /*!
95     @class IEnumTextMatches
96 */
97 [
98     object,
99     oleautomation,
100     uuid(C0CDE63A-5ED1-453f-B937-93B1A61AD3B3),
101     pointer_default(unique)
102 ]
103 interface IEnumTextMatches : IUnknown
104 {
105     HRESULT Next(ULONG celt, RECT* rect, ULONG* pceltFetched);
106     HRESULT Skip(ULONG celt);
107     HRESULT Reset(void);
108     HRESULT Clone(IEnumTextMatches** ppenum);
109 };
110
111 /*!
112     @class WebView
113     WebView manages the interaction between WebFrameViews and WebDataSources.  Modification
114     of the policies and behavior of the WebKit is largely managed by WebViews and their
115     delegates.
116     
117     <p>
118     Typical usage:
119     </p>
120     <pre>
121     WebView *webView;
122     WebFrame *mainFrame;
123     
124     webView  = [[WebView alloc] initWithFrame: NSMakeRect (0,0,640,480)];
125     mainFrame = [webView mainFrame];
126     [mainFrame loadRequest:request];
127     </pre>
128     
129     WebViews have the following delegates:  WebUIDelegate, WebResourceLoadDelegate,
130     WebFrameLoadDelegate, and WebPolicyDelegate.
131     
132     WebKit depends on the WebView's WebUIDelegate for all window
133     related management, including opening new windows and controlling the user interface
134     elements in those windows.
135     
136     WebResourceLoadDelegate is used to monitor the progress of resources as they are
137     loaded.  This delegate may be used to present users with a progress monitor.
138     
139     The WebFrameLoadDelegate receives messages when the URL in a WebFrame is
140     changed.
141     
142     WebView's WebPolicyDelegate can make determinations about how
143     content should be handled, based on the resource's URL and MIME type.
144
145     @interface WebView : NSView
146 */
147 [
148     object,
149     oleautomation,
150     hidden,
151     uuid(174BBEFD-058E-49c7-91DF-6F110AA4AC28),
152     pointer_default(unique)
153 ]
154 interface IWebView : IUnknown
155 {
156     /*!
157         @method canShowMIMEType:
158         @abstract Checks if the WebKit can show content of a certain MIME type.
159         @param MIMEType The MIME type to check.
160         @result YES if the WebKit can show content with MIMEtype.
161         + (BOOL)canShowMIMEType:(NSString *)MIMEType;
162     */
163     HRESULT canShowMIMEType([in] BSTR mimeType, [out, retval] BOOL* canShow);
164
165     /*!
166         @method canShowMIMETypeAsHTML:
167         @abstract Checks if the the MIME type is a type that the WebKit will interpret as HTML.
168         @param MIMEType The MIME type to check.
169         @result YES if the MIMEtype in an HTML type.
170         + (BOOL)canShowMIMETypeAsHTML:(NSString *)MIMEType;
171     */
172     HRESULT canShowMIMETypeAsHTML([in] BSTR mimeType, [out, retval] BOOL* canShow);
173
174     /*!
175         @method MIMETypesShownAsHTML
176         @result Returns an array of NSStrings that describe the MIME types
177         WebKit will attempt to render as HTML.
178         + (NSArray *)MIMETypesShownAsHTML;
179     */
180     HRESULT MIMETypesShownAsHTML([out, retval] IEnumVARIANT** enumVariant);
181
182     /*!
183         @method setMIMETypesShownAsHTML:
184         @discussion Sets the array of NSString MIME types that WebKit will
185         attempt to render as HTML.  Typically you will retrieve the built-in
186         array using MIMETypesShownAsHTML and add additional MIME types to that
187         array.
188         + (void)setMIMETypesShownAsHTML:(NSArray *)MIMETypes;
189     */
190     HRESULT setMIMETypesShownAsHTML([in, size_is(cMimeTypes)] BSTR* mimeTypes, [in] int cMimeTypes);
191
192     /*!
193         @method URLFromPasteboard:
194         @abstract Returns a URL from a pasteboard
195         @param pasteboard The pasteboard with a URL
196         @result A URL if the pasteboard has one. Nil if it does not.
197         @discussion This method differs than NSURL's URLFromPasteboard method in that it tries multiple pasteboard types
198         including NSURLPboardType to find a URL on the pasteboard.
199         + (NSURL *)URLFromPasteboard:(NSPasteboard *)pasteboard;
200     */
201     HRESULT URLFromPasteboard([in] IDataObject* pasteboard, [out, retval] BSTR* url);
202
203     /*!
204         @method URLTitleFromPasteboard:
205         @abstract Returns a URL title from a pasteboard
206         @param pasteboard The pasteboard with a URL title
207         @result A URL title if the pasteboard has one. Nil if it does not.
208         @discussion This method returns a title that refers a URL on the pasteboard. An example of this is the link label
209         which is the text inside the anchor tag.
210         + (NSString *)URLTitleFromPasteboard:(NSPasteboard *)pasteboard;
211     */
212     HRESULT URLTitleFromPasteboard([in] IDataObject* pasteboard, [out, retval] BSTR* urlTitle);
213
214     /*!
215         @method initWithFrame:frameName:groupName:
216         @abstract The designated initializer for WebView.
217         @discussion Initialize a WebView with the supplied parameters. This method will 
218         create a main WebFrame with the view. Passing a top level frame name is useful if you
219         handle a targetted frame navigation that would normally open a window in some other 
220         way that still ends up creating a new WebView.
221         @param frame The frame used to create the view.
222         @param frameName The name to use for the top level frame. May be nil.
223         @param groupName The name of the webView set to which this webView will be added.  May be nil.
224         @result Returns an initialized WebView.
225         - (id)initWithFrame:(NSRect)frame frameName:(NSString *)frameName groupName:(NSString *)groupName;
226     */
227     HRESULT initWithFrame([in] RECT frame, [in] BSTR frameName, [in] BSTR groupName);
228
229     /*!
230         @method setUIDelegate:
231         @abstract Set the WebView's WebUIDelegate.
232         @param delegate The WebUIDelegate to set as the delegate.
233         - (void)setUIDelegate:(id)delegate;
234     */
235     HRESULT setUIDelegate([in] IWebUIDelegate* d);
236
237     /*!
238         @method UIDelegate
239         @abstract Return the WebView's WebUIDelegate.
240         @result The WebView's WebUIDelegate.
241         - (id)UIDelegate;
242     */
243     HRESULT uiDelegate([retval, out] IWebUIDelegate** d);
244
245     /*!
246         @method setResourceLoadDelegate:
247         @abstract Set the WebView's WebResourceLoadDelegate load delegate.
248         @param delegate The WebResourceLoadDelegate to set as the load delegate.
249         - (void)setResourceLoadDelegate:(id)delegate;
250     */
251     HRESULT setResourceLoadDelegate([in] IWebResourceLoadDelegate* d);
252
253     /*!
254         @method resourceLoadDelegate
255         @result Return the WebView's WebResourceLoadDelegate.
256         - (id)resourceLoadDelegate;
257     */    
258     HRESULT resourceLoadDelegate([retval, out] IWebResourceLoadDelegate** d);
259
260     /*!
261         @method setDownloadDelegate:
262         @abstract Set the WebView's WebDownloadDelegate.
263         @discussion The download delegate is retained by WebDownload when any downloads are in progress.
264         @param delegate The WebDownloadDelegate to set as the download delegate.
265         - (void)setDownloadDelegate:(id)delegate;
266     */
267     HRESULT setDownloadDelegate([in] IWebDownloadDelegate* d);
268
269     /*!
270         @method downloadDelegate
271         @abstract Return the WebView's WebDownloadDelegate.
272         @result The WebView's WebDownloadDelegate.
273         - (id)downloadDelegate;
274     */    
275     HRESULT downloadDelegate([retval, out] IWebDownloadDelegate** d);
276
277     /*!
278         @method setFrameLoadDelegate:
279         @abstract Set the WebView's WebFrameLoadDelegate delegate.
280         @param delegate The WebFrameLoadDelegate to set as the delegate.
281         - (void)setFrameLoadDelegate:(id)delegate;
282     */
283     HRESULT setFrameLoadDelegate([in] IWebFrameLoadDelegate* d);
284
285     /*!
286         @method frameLoadDelegate
287         @abstract Return the WebView's WebFrameLoadDelegate delegate.
288         @result The WebView's WebFrameLoadDelegate delegate.
289         - (id)frameLoadDelegate;
290     */    
291     HRESULT frameLoadDelegate([retval, out] IWebFrameLoadDelegate** d);
292
293     /*!
294         @method setPolicyDelegate:
295         @abstract Set the WebView's WebPolicyDelegate delegate.
296         @param delegate The WebPolicyDelegate to set as the delegate.
297         - (void)setPolicyDelegate:(id)delegate;
298     */    
299     HRESULT setPolicyDelegate([in] IWebPolicyDelegate* d);
300
301     /*!
302         @method policyDelegate
303         @abstract Return the WebView's WebPolicyDelegate.
304         @result The WebView's WebPolicyDelegate.
305         - (id)policyDelegate;
306     */    
307     HRESULT policyDelegate([retval, out] IWebPolicyDelegate** d);
308
309     /*!
310         @method mainFrame
311         @abstract Return the top level frame.  
312         @discussion Note that even document that are not framesets will have a
313         mainFrame.
314         @result The main frame.
315         - (WebFrame *)mainFrame;
316     */    
317     HRESULT mainFrame([retval, out] IWebFrame** frame);
318
319     /*!
320         @method focusedFrame
321     @abstract Return the frame that has the current focus.  
322     */
323     HRESULT focusedFrame([retval, out] IWebFrame** frame);
324
325     /*!
326         @method backForwardList
327         @result The backforward list for this webView.
328         - (WebBackForwardList *)backForwardList;
329     */    
330     HRESULT backForwardList([retval, out] IWebBackForwardList** list);
331
332     /*!
333         @method setMaintainsBackForwardList:
334         @abstract Enable or disable the use of a backforward list for this webView.
335         @param flag Turns use of the back forward list on or off
336         - (void)setMaintainsBackForwardList:(BOOL)flag;
337     */    
338     HRESULT setMaintainsBackForwardList([in] BOOL flag);
339
340     /*!
341         @method goBack
342         @abstract Go back to the previous URL in the backforward list.
343         @result YES if able to go back in the backforward list, NO otherwise.
344         - (BOOL)goBack;
345     */
346     HRESULT goBack([out, retval] BOOL* succeeded);
347
348     /*!
349         @method goForward
350         @abstract Go forward to the next URL in the backforward list.
351         @result YES if able to go forward in the backforward list, NO otherwise.
352         - (BOOL)goForward;
353     */    
354     HRESULT goForward([out, retval] BOOL* succeeded);
355
356     /*!
357         @method goToBackForwardItem:
358         @abstract Go back or forward to an item in the backforward list.
359         @result YES if able to go to the item, NO otherwise.
360         - (BOOL)goToBackForwardItem:(WebHistoryItem *)item;
361     */    
362     HRESULT goToBackForwardItem([in] IWebHistoryItem* item, [out, retval] BOOL* succeeded);
363
364     /*!
365         @method setTextSizeMultiplier:
366         @abstract Change the size of the text rendering in views managed by this webView.
367         @param multiplier A fractional percentage value, 1.0 is 100%.
368         - (void)setTextSizeMultiplier:(float)multiplier;
369     */
370     HRESULT setTextSizeMultiplier([in] float multiplier);
371
372     /*!
373         @method textSizeMultiplier
374         @result The text size multipler.
375         - (float)textSizeMultiplier;
376     */    
377     HRESULT textSizeMultiplier([out, retval] float* multiplier);
378
379     /*!
380         @method setApplicationNameForUserAgent:
381         @abstract Set the application name. 
382         @discussion This name will be used in user-agent strings
383         that are chosen for best results in rendering web pages.
384         @param applicationName The application name
385         - (void)setApplicationNameForUserAgent:(NSString *)applicationName;
386     */
387     HRESULT setApplicationNameForUserAgent([in] BSTR applicationName);
388
389     /*!
390         @method applicationNameForUserAgent
391         @result The name of the application as used in the user-agent string.
392         - (NSString *)applicationNameForUserAgent;
393     */
394     HRESULT applicationNameForUserAgent([out, retval] BSTR* applicationName);
395
396     /*!
397         @method setCustomUserAgent:
398         @abstract Set the user agent. 
399         @discussion Setting this means that the webView should use this user-agent string
400         instead of constructing a user-agent string for each URL. Setting it to nil
401         causes the webView to construct the user-agent string for each URL
402         for best results rendering web pages.
403         @param userAgentString The user agent description
404         - (void)setCustomUserAgent:(NSString *)userAgentString;
405     */
406     HRESULT setCustomUserAgent([in] BSTR userAgentString);
407
408     /*!
409         @method customUserAgent
410         @result The custom user-agent string or nil if no custom user-agent string has been set.
411         - (NSString *)customUserAgent;
412     */
413     HRESULT customUserAgent([out, retval] BSTR* userAgentString);
414
415     /*!
416         @method userAgentForURL:
417         @abstract Get the appropriate user-agent string for a particular URL.
418         @param URL The URL.
419         @result The user-agent string for the supplied URL.
420         - (NSString *)userAgentForURL:(NSURL *)URL;
421     */
422     HRESULT userAgentForURL([in] BSTR url, [out, retval] BSTR* userAgent);
423
424     /*!
425         @method supportsTextEncoding
426         @abstract Find out if the current web page supports text encodings.
427         @result YES if the document view of the current web page can
428         support different text encodings.
429         - (BOOL)supportsTextEncoding;
430     */
431     HRESULT supportsTextEncoding([out, retval] BOOL* supports);
432
433     /*!
434         @method setCustomTextEncodingName:
435         @discussion Make the page display with a different text encoding; stops any load in progress.
436         The text encoding passed in overrides the normal text encoding smarts including
437         what's specified in a web page's header or HTTP response.
438         The text encoding automatically goes back to the default when the top level frame
439         changes to a new location.
440         Setting the text encoding name to nil makes the webView use default encoding rules.
441         @param encoding The text encoding name to use to display a page or nil.
442         - (void)setCustomTextEncodingName:(NSString *)encodingName;
443     */
444     HRESULT setCustomTextEncodingName([in] BSTR encodingName);
445
446     /*!
447         @method customTextEncodingName
448         @result The custom text encoding name or nil if no custom text encoding name has been set.
449         - (NSString *)customTextEncodingName;
450     */
451     HRESULT customTextEncodingName([out, retval] BSTR* encodingName);
452
453     /*!
454         @method setMediaStyle:
455         @discussion Set the media style for the WebView.  The mediaStyle will override the normal value
456         of the CSS media property.  Setting the value to nil will restore the normal value.
457         @param mediaStyle The value to use for the CSS media property.
458         - (void)setMediaStyle:(NSString *)mediaStyle;
459     */
460     HRESULT setMediaStyle([in] BSTR media);
461
462     /*!
463         @method mediaStyle
464         @result mediaStyle The value to use for the CSS media property, as set by setMediaStyle:.  It
465         will be nil unless set by that method.
466         - (NSString *)mediaStyle;
467     */
468     HRESULT mediaStyle([out, retval] BSTR* media);
469
470     /*!
471         @method stringByEvaluatingJavaScriptFromString:
472         @param script The text of the JavaScript.
473         @result The result of the script, converted to a string, or nil for failure.
474         - (NSString *)stringByEvaluatingJavaScriptFromString:(NSString *)script;
475     */
476     HRESULT stringByEvaluatingJavaScriptFromString([in] BSTR script, [out, retval] BSTR* result);
477
478     /*!
479         @method windowScriptObject
480         @discussion windowScriptObject return a WebScriptObject that represents the
481         window object from the script environment.
482         @result Returns the window object from the script environment.
483         - (WebScriptObject *)windowScriptObject;
484     */
485     HRESULT windowScriptObject([out, retval] IWebScriptObject** webScriptObject);
486
487     /*!
488         @method setPreferences:
489         @param preferences The preferences to use for the webView.
490         @abstract Override the standard setting for the webView. 
491         - (void)setPreferences: (WebPreferences *)prefs;
492     */
493     HRESULT setPreferences([in] IWebPreferences* prefs);
494
495     /*!
496         @method preferences
497         @result Returns the preferences used by this webView.
498         @discussion This method will return [WebPreferences standardPreferences] if no
499         other instance of WebPreferences has been set.
500         - (WebPreferences *)preferences;
501     */
502     HRESULT preferences([out, retval] IWebPreferences** prefs);
503
504     /*!
505         @method setPreferencesIdentifier:
506         @param anIdentifier The string to use a prefix for storing values for this WebView in the user
507         defaults database.
508         @discussion If the WebPreferences for this WebView are stored in the user defaults database, the
509         string set in this method will be used a key prefix.
510         - (void)setPreferencesIdentifier:(NSString *)anIdentifier;
511     */
512     HRESULT setPreferencesIdentifier([in] BSTR anIdentifier);
513
514     /*!
515         @method preferencesIdentifier
516         @result Returns the WebPreferences key prefix.
517         - (NSString *)preferencesIdentifier;
518     */
519     HRESULT preferencesIdentifier([out, retval] BSTR* anIdentifier);
520
521     /*!
522         @method setHostWindow:
523         @param hostWindow The host window for the web view.
524         @discussion Parts of WebKit (such as plug-ins and JavaScript) depend on a window to function
525         properly. Set a host window so these parts continue to function even when the web view is
526         not in an actual window.
527         - (void)setHostWindow:(NSWindow *)hostWindow;
528     */
529     HRESULT setHostWindow([in] OLE_HANDLE window);
530
531     /*!
532         @method hostWindow
533         @result The host window for the web view.
534         - (NSWindow *)hostWindow;
535     */
536     HRESULT hostWindow([out, retval] OLE_HANDLE* window);
537
538     /*!
539         @method searchFor:direction:caseSensitive:
540         @abstract Searches a document view for a string and highlights the string if it is found.
541         Starts the search from the current selection.  Will search across all frames.
542         @param string The string to search for.
543         @param forward YES to search forward, NO to seach backwards.
544         @param caseFlag YES to for case-sensitive search, NO for case-insensitive search.
545         @result YES if found, NO if not found.
546         - (BOOL)searchFor:(NSString *)string direction:(BOOL)forward caseSensitive:(BOOL)caseFlag wrap:(BOOL)wrapFlag;
547     */
548     HRESULT searchFor([in] BSTR str, [in] BOOL forward, [in] BOOL caseFlag, [in] BOOL wrapFlag, [out, retval] BOOL* found);
549
550     /*!
551         @method registerViewClass:representationClass:forMIMEType:
552         @discussion Register classes that implement WebDocumentView and WebDocumentRepresentation respectively.
553         A document class may register for a primary MIME type by excluding
554         a subtype, i.e. "video/" will match the document class with
555         all video types.  More specific matching takes precedence
556         over general matching.
557         @param viewClass The WebDocumentView class to use to render data for a given MIME type.
558         @param representationClass The WebDocumentRepresentation class to use to represent data of the given MIME type.
559         @param MIMEType The MIME type to represent with an object of the given class.
560         + (void)registerViewClass:(Class)viewClass representationClass:(Class)representationClass forMIMEType:(NSString *)MIMEType;
561     */
562     HRESULT registerViewClass([in] IWebDocumentView* view, [in] IWebDocumentRepresentation* representation, [in] BSTR forMIMEType);
563
564     /*!
565         @method setGroupName:
566         @param groupName The name of the group for this WebView.
567         @discussion JavaScript may access named frames within the same group. 
568         - (void)setGroupName:(NSString *)groupName;
569     */
570     HRESULT setGroupName([in] BSTR groupName);
571
572     /*!
573         @method groupName
574         @discussion The group name for this WebView.
575         - (NSString *)groupName;
576     */
577     HRESULT groupName([out, retval] BSTR* groupName);
578
579     /*!
580         @method estimatedProgress
581         @discussion An estimate of the percent complete for a document load.  This
582         value will range from 0 to 1.0 and, once a load completes, will remain at 1.0 
583         until a new load starts, at which point it will be reset to 0.  The value is an
584         estimate based on the total number of bytes expected to be received
585         for a document, including all it's possible subresources.  For more accurate progress
586         indication it is recommended that you implement a WebFrameLoadDelegate and a
587         WebResourceLoadDelegate.
588         - (double)estimatedProgress;
589     */
590     HRESULT estimatedProgress([out, retval] double* estimatedProgress);
591
592     /*!
593         @method isLoading
594         @discussion Returns YES if there are any pending loads.
595         - (BOOL)isLoading;
596     */
597     HRESULT isLoading([out, retval] BOOL* isLoading);
598
599     /*!
600         @method elementAtPoint:
601         @param point A point in the coordinates of the WebView
602         @result An element dictionary describing the point
603         - (NSDictionary *)elementAtPoint:(NSPoint)point;
604     */
605     HRESULT elementAtPoint([in] LPPOINT point, [out, retval] IPropertyBag** elementDictionary);
606
607     /*!
608         @method pasteboardTypesForSelection
609         @abstract Returns the pasteboard types that WebView can use for the current selection
610         - (NSArray *)pasteboardTypesForSelection;
611     */
612     HRESULT pasteboardTypesForSelection([out, retval] IEnumVARIANT** enumVariant);
613
614     /*!
615         @method writeSelectionWithPasteboardTypes:toPasteboard:
616         @abstract Writes the current selection to the pasteboard
617         @param types The types that WebView will write to the pasteboard
618         @param pasteboard The pasteboard to write to
619         - (void)writeSelectionWithPasteboardTypes:(NSArray *)types toPasteboard:(NSPasteboard *)pasteboard;
620     */
621     HRESULT writeSelectionWithPasteboardTypes([in, size_is(cTypes)] BSTR* types, [in] int cTypes, [in] IDataObject* pasteboard);
622
623     /*!
624         @method pasteboardTypesForElement:
625         @abstract Returns the pasteboard types that WebView can use for an element
626         @param element The element
627         - (NSArray *)pasteboardTypesForElement:(NSDictionary *)element;
628     */
629     HRESULT pasteboardTypesForElement([in] IPropertyBag* elementDictionary, [out, retval] IEnumVARIANT** enumVariant);
630
631     /*!
632         @method writeElement:withPasteboardTypes:toPasteboard:
633         @abstract Writes an element to the pasteboard
634         @param element The element to write to the pasteboard
635         @param types The types that WebView will write to the pasteboard
636         @param pasteboard The pasteboard to write to
637         - (void)writeElement:(NSDictionary *)element withPasteboardTypes:(NSArray *)types toPasteboard:(NSPasteboard *)pasteboard;
638     */
639     HRESULT writeElement([in] IPropertyBag* elementDictionary, [in, size_is(cWithPasteboardTypes)] BSTR* withPasteboardTypes, [in] int cWithPasteboardTypes, [in] IDataObject* pasteboard);
640
641     /*!
642         @method selectedText
643         @abstract Returns the selection as a string
644     */
645     HRESULT selectedText([out, retval] BSTR* text);
646
647     /*!
648         @method centerSelectionInVisibleArea
649         @abstract Centers the selected text in the WebView
650         - (void)centerSelectionInVisibleArea:(id)sender;
651     */
652     HRESULT centerSelectionInVisibleArea([in] IUnknown* sender);
653
654     /*!
655         @method moveDragCaretToPoint:
656         @param point A point in the coordinates of the WebView
657         @discussion This method moves the caret that shows where something being dragged will be dropped. It may cause the WebView to scroll
658         to make the new position of the drag caret visible.
659         - (void)moveDragCaretToPoint:(NSPoint)point;
660     */
661     HRESULT moveDragCaretToPoint([in] LPPOINT point);
662
663     /*!
664         @method removeDragCaret
665         @abstract Removes the drag caret from the WebView
666         - (void)removeDragCaret;
667     */
668     HRESULT removeDragCaret();
669
670     /*!
671         @method setDrawsBackground:
672         @param drawsBackround YES to cause the receiver to draw a default white background, NO otherwise.
673         @abstract Sets whether the receiver draws a default white background when the loaded page has no background specified.
674         - (void)setDrawsBackground:(BOOL)drawsBackround;
675     */
676     HRESULT setDrawsBackground([in] BOOL drawsBackground);
677
678     /*!
679         @method drawsBackground
680         @result Returns YES if the receiver draws a default white background, NO otherwise.
681         - (BOOL)drawsBackground;
682     */
683     HRESULT drawsBackground([out, retval] BOOL* drawsBackground);
684
685     /*!
686         @method setMainFrameURL:
687         @param URLString The URL to load in the mainFrame.
688         - (void)setMainFrameURL:(NSString *)URLString;
689     */
690     HRESULT setMainFrameURL([in] BSTR urlString);
691
692     /*!
693         @method mainFrameURL
694         @result Returns the main frame's current URL.
695         - (NSString *)mainFrameURL;
696     */
697     HRESULT mainFrameURL([out, retval] BSTR* urlString);
698
699     /*!
700         @method mainFrameDocument
701         @result Returns the main frame's DOMDocument.
702         - (DOMDocument *)mainFrameDocument;
703     */
704     HRESULT mainFrameDocument([out, retval] IDOMDocument** document);
705
706     /*!
707         @method mainFrameTitle
708         @result Returns the main frame's title if any, otherwise an empty string.
709         - (NSString *)mainFrameTitle;
710     */
711     HRESULT mainFrameTitle([out, retval] BSTR* title);
712
713     /*!
714         @method mainFrameIcon
715         @discussion The methods returns the site icon for the current page loaded in the mainFrame.
716         @result Returns the main frame's icon if any, otherwise nil.
717         - (NSImage *)mainFrameIcon;
718     */
719     HRESULT mainFrameIcon([out, retval] OLE_HANDLE* hBitmap);
720
721     /*!
722         @method registerURLSchemeAsLocal
723         @discussion Adds the scheme to the list of schemes to be treated as local.
724         @param scheme The scheme to register.
725         + (void)registerURLSchemeAsLocal:(NSString *)scheme;
726     */
727     HRESULT registerURLSchemeAsLocal([in] BSTR scheme);
728
729     /*!
730         @method close
731         @abstract Closes the receiver, unloading its web page and canceling any pending loads.
732         Once the receiver has closed, it will no longer respond to requests or fire delegate methods.
733         (However, the -close method itself may fire delegate methods.)
734         @discussion A garbage collected application is required to call close when the receiver is no longer needed.
735         The close method will be called automatically when the window or hostWindow closes and shouldCloseWithWindow returns YES.
736         A non-garbage collected application can still call close, providing a convenient way to prevent receiver
737         from doing any more loading and firing any future delegate methods.
738     */
739     HRESULT close();
740 }
741
742 /*
743     @interface WebView (WebIBActions) <NSUserInterfaceValidations>
744 */
745 [
746     object,
747     oleautomation,
748     uuid(8F0E3A30-B924-44f8-990A-1AE61ED6C632),
749     pointer_default(unique)
750 ]
751 interface IWebIBActions : IUnknown
752 {
753     /*
754         - (IBAction)takeStringURLFrom:(id)sender;
755     */
756     HRESULT takeStringURLFrom([in] IUnknown* sender);
757
758     /*
759         - (IBAction)stopLoading:(id)sender;
760     */
761     HRESULT stopLoading([in] IUnknown* sender);
762
763     /*
764         - (IBAction)reload:(id)sender;
765     */
766     HRESULT reload([in] IUnknown* sender);
767
768     /*
769         - (BOOL)canGoBack;
770     */
771     HRESULT canGoBack([in] IUnknown* sender, [out, retval] BOOL* result);
772
773     /*
774         - (IBAction)goBack:(id)sender;
775     */
776     HRESULT goBack([in] IUnknown* sender);
777
778     /*
779         - (BOOL)canGoForward;
780     */
781     HRESULT canGoForward([in] IUnknown* sender, [out, retval] BOOL* result);
782
783     /*
784         - (IBAction)goForward:(id)sender;
785     */
786     HRESULT goForward([in] IUnknown* sender);
787
788     /*
789         - (BOOL)canMakeTextLarger;
790     */
791     HRESULT canMakeTextLarger([in] IUnknown* sender, [out, retval] BOOL* result);
792
793     /*
794         - (IBAction)makeTextLarger:(id)sender;
795     */
796     HRESULT makeTextLarger([in] IUnknown* sender);
797
798     /*
799         - (BOOL)canMakeTextSmaller;
800     */
801     HRESULT canMakeTextSmaller([in] IUnknown* sender, [out, retval] BOOL* result);
802
803     /*
804         - (IBAction)makeTextSmaller:(id)sender;
805     */
806     HRESULT makeTextSmaller([in] IUnknown* sender);
807
808     /*
809         - (BOOL)canMakeTextStandardSize;
810     */
811     HRESULT canMakeTextStandardSize([in] IUnknown* sender, [out, retval] BOOL* result);
812
813     /*
814         - (IBAction)makeTextStandardSize:(id)sender;
815     */
816     HRESULT makeTextStandardSize([in] IUnknown* sender);
817
818     /*
819         - (IBAction)toggleContinuousSpellChecking:(id)sender;
820     */
821     HRESULT toggleContinuousSpellChecking([in] IUnknown* sender);
822
823     /*
824         - (IBAction)toggleSmartInsertDelete:(id)sender;
825     */
826     HRESULT toggleSmartInsertDelete([in] IUnknown* sender);
827
828     /*
829         - (void)toggleGrammarChecking:(id)sender
830     */
831     HRESULT toggleGrammarChecking([in] IUnknown* sender);
832
833        /*!
834         @method setPageSizeMultiplier:
835         @abstract Set a zoom factor for all views managed by this webView.
836         @param multiplier A fractional percentage value, 1.0 is 100%.
837         - (void)setPageSizeMultiplier:(float)multiplier;
838     */
839     HRESULT setPageSizeMultiplier([in] float multiplier);
840
841     /*!
842         @method pageSizeMultiplier
843         @result The page size multipler.
844         - (float)pageSizeMultiplier;
845     */    
846     HRESULT pageSizeMultiplier([out, retval] float* multiplier);
847
848     /*
849         - (BOOL)canZoomPageIn;
850     */
851     HRESULT canZoomPageIn([in] IUnknown* sender, [out, retval] BOOL* result);
852
853     /*
854         - (IBAction)zoomPageIn:(id)sender;
855     */
856     HRESULT zoomPageIn([in] IUnknown* sender);
857
858     /*
859         - (BOOL)canZoomPageOut;
860     */
861     HRESULT canZoomPageOut([in] IUnknown* sender, [out, retval] BOOL* result);
862
863     /*
864         - (IBAction)zoomPageOut:(id)sender;
865     */
866     HRESULT zoomPageOut([in] IUnknown* sender);
867
868     /*
869         - (BOOL)canResetPageZoom;
870     */
871     HRESULT canResetPageZoom([in] IUnknown* sender, [out, retval] BOOL* result);
872
873     /*
874         - (IBAction)resetPageZoom:(id)sender;
875     */
876     HRESULT resetPageZoom([in] IUnknown* sender);
877
878     /*
879         - (IBAction)reloadFromOrigin:(id)sender;
880     */
881     HRESULT reloadFromOrigin([in] IUnknown* sender);
882 }
883
884 /*
885     @interface WebView (WebViewCSS)
886 */
887 [
888     object,
889     oleautomation,
890     uuid(ADF68A8C-336F-405c-A053-3D11A9D5B092),
891     pointer_default(unique)
892 ]
893 interface IWebViewCSS : IUnknown
894 {
895     /*
896         - (DOMCSSStyleDeclaration *)computedStyleForElement:(DOMElement *)element pseudoElement:(NSString *)pseudoElement;
897     */
898     HRESULT computedStyleForElement([in] IDOMElement* element, [in] BSTR pseudoElement, [out, retval] IDOMCSSStyleDeclaration** style);
899 }
900
901 /*
902     @interface WebView (WebViewEditing)
903 */
904 [
905     object,
906     oleautomation,
907     uuid(07BDAC9A-19A1-4086-864D-BAD9E0F00D5C),
908     pointer_default(unique)
909 ]
910 interface IWebViewEditing : IUnknown
911 {
912     /*
913         - (DOMRange *)editableDOMRangeForPoint:(NSPoint)point;
914     */
915     HRESULT editableDOMRangeForPoint([in] LPPOINT point, [out, retval] IDOMRange** range);
916
917     /*
918         - (void)setSelectedDOMRange:(DOMRange *)range affinity:(NSSelectionAffinity)selectionAffinity;
919     */
920     HRESULT setSelectedDOMRange([in] IDOMRange* range, [in] WebSelectionAffinity affinity);
921
922     /*
923         - (DOMRange *)selectedDOMRange;
924     */
925     HRESULT selectedDOMRange([out, retval] IDOMRange** range);
926
927     /*
928         - (NSSelectionAffinity)selectionAffinity;
929     */
930     HRESULT selectionAffinity([out, retval] [out, retval] WebSelectionAffinity* affinity);
931
932     /*
933         - (void)setEditable:(BOOL)flag;
934     */
935     HRESULT setEditable([in] BOOL flag);
936
937     /*
938         - (BOOL)isEditable;
939     */
940     HRESULT isEditable([out, retval] BOOL* isEditable);
941
942     /*
943         - (void)setTypingStyle:(DOMCSSStyleDeclaration *)style;
944     */
945     HRESULT setTypingStyle([in] IDOMCSSStyleDeclaration* style);
946
947     /*
948         - (DOMCSSStyleDeclaration *)typingStyle;
949     */
950     HRESULT typingStyle([out, retval] IDOMCSSStyleDeclaration** style);
951
952     /*
953         - (void)setSmartInsertDeleteEnabled:(BOOL)flag;
954     */
955     HRESULT setSmartInsertDeleteEnabled([in] BOOL flag);
956
957     /*
958         - (BOOL)smartInsertDeleteEnabled;
959     */
960     HRESULT smartInsertDeleteEnabled([out, retval] BOOL* enabled);
961
962     /*
963         - (void)setContinuousSpellCheckingEnabled:(BOOL)flag;
964     */
965     HRESULT setContinuousSpellCheckingEnabled([in] BOOL flag);
966
967     /*
968         - (BOOL)isContinuousSpellCheckingEnabled;
969     */
970     HRESULT isContinuousSpellCheckingEnabled([out, retval] BOOL* enabled);
971
972     /*
973         - (WebNSInt)spellCheckerDocumentTag;
974     */
975     HRESULT spellCheckerDocumentTag([out, retval] int* tag);
976
977     /*
978         - (NSUndoManager *)undoManager;
979     */
980     HRESULT undoManager([out, retval] IWebUndoManager** manager);
981
982     /*
983         - (void)setEditingDelegate:(id)delegate;
984     */
985     HRESULT setEditingDelegate([in] IWebEditingDelegate* d);
986
987     /*
988         - (id)editingDelegate;
989     */
990     HRESULT editingDelegate([out, retval] IWebEditingDelegate** d);
991
992     /*
993         - (DOMCSSStyleDeclaration *)styleDeclarationWithText:(NSString *)text;
994     */
995     HRESULT styleDeclarationWithText([in] BSTR text, [out, retval] IDOMCSSStyleDeclaration** style);
996
997     /*
998         - (BOOL)hasSelectedRange;
999     */
1000     HRESULT hasSelectedRange([out, retval] BOOL* hasSelectedRange);
1001
1002     /*
1003         - (BOOL)cutEnabled;
1004     */
1005     HRESULT cutEnabled([out, retval] BOOL* enabled);
1006
1007     /*
1008         - (BOOL)copyEnabled;
1009     */
1010     HRESULT copyEnabled([out, retval] BOOL* enabled);
1011
1012     /*
1013         - (BOOL)pasteEnabled;
1014     */
1015     HRESULT pasteEnabled([out, retval] BOOL* enabled);
1016
1017     /*
1018         - (BOOL)deleteEnabled;
1019     */
1020     HRESULT deleteEnabled([out, retval] BOOL* enabled);
1021
1022     /*
1023         - (BOOL)editingEnabled;
1024     */
1025     HRESULT editingEnabled([out, retval] BOOL* enabled);
1026
1027     /*
1028         - (BOOL)isGrammarCheckingEnabled
1029     */
1030     HRESULT isGrammarCheckingEnabled([out, retval] BOOL* enabled);
1031
1032     /*
1033         - (void)setGrammarCheckingEnabled:(BOOL)flag
1034     */
1035     HRESULT setGrammarCheckingEnabled(BOOL enabled);
1036
1037     /*
1038         - (void)setSelectTrailingWhitespaceEnabled:(BOOL)flag;
1039     */
1040     HRESULT setSelectTrailingWhitespaceEnabled([in] BOOL flag);
1041
1042     /*
1043         - (BOOL)selectTrailingWhitespaceEnabled;
1044     */
1045     HRESULT isSelectTrailingWhitespaceEnabled([out, retval] BOOL* enabled);
1046 }
1047
1048 /*
1049     @interface WebView (WebViewUndoableEditing)
1050 */
1051 [
1052     object,
1053     oleautomation,
1054     uuid(639E7121-13C8-4a12-BC18-6E1F3D68F3C3),
1055     pointer_default(unique)
1056 ]
1057 interface IWebViewUndoableEditing : IUnknown
1058 {
1059     /*
1060         - (void)replaceSelectionWithNode:(DOMNode *)node; 
1061     */
1062     HRESULT replaceSelectionWithNode([in] IDOMNode* node);
1063
1064     /*
1065         - (void)replaceSelectionWithText:(NSString *)text;    
1066     */
1067     HRESULT replaceSelectionWithText([in] BSTR text);
1068
1069     /*
1070         - (void)replaceSelectionWithMarkupString:(NSString *)markupString;
1071     */
1072     HRESULT replaceSelectionWithMarkupString([in] BSTR markupString);
1073
1074     /*
1075         - (void)replaceSelectionWithArchive:(WebArchive *)archive;
1076     */
1077     HRESULT replaceSelectionWithArchive([in] IWebArchive* archive);
1078
1079     /*
1080         - (void)deleteSelection;    
1081     */
1082     HRESULT deleteSelection();
1083
1084     /*
1085         - (void)clearSelection;    
1086     */
1087     HRESULT clearSelection();
1088
1089     /*
1090         - (void)applyStyle:(DOMCSSStyleDeclaration *)style;
1091     */
1092     HRESULT applyStyle([in] IDOMCSSStyleDeclaration* style);
1093 }
1094
1095 /*
1096     @interface WebView (WebViewEditingActions)
1097 */
1098 [
1099     object,
1100     oleautomation,
1101     uuid(7E066C42-8E81-4778-888D-D6CC93E27D4C),
1102     pointer_default(unique)
1103 ]
1104 interface IWebViewEditingActions : IUnknown
1105 {
1106     /*
1107         - (void)copy:(id)sender;
1108     */
1109     HRESULT copy([in] IUnknown* sender);
1110
1111     /*
1112         - (void)cut:(id)sender;
1113     */
1114     HRESULT cut([in] IUnknown* sender);
1115
1116     /*
1117         - (void)paste:(id)sender;
1118     */
1119     HRESULT paste([in] IUnknown* sender);
1120
1121     /*
1122         - (void)copyURL:(id)sender;
1123     */
1124     HRESULT copyURL([in] BSTR url);
1125
1126     /*
1127         - (void)copyFont:(id)sender;
1128     */
1129     HRESULT copyFont([in] IUnknown* sender);
1130
1131     /*
1132         - (void)pasteFont:(id)sender;
1133     */
1134     HRESULT pasteFont([in] IUnknown* sender);
1135
1136     /*
1137         - (void)delete:(id)sender;
1138     */
1139     HRESULT delete_([in] IUnknown* sender);
1140
1141     /*
1142         - (void)pasteAsPlainText:(id)sender;
1143     */
1144     HRESULT pasteAsPlainText([in] IUnknown* sender);
1145
1146     /*
1147         - (void)pasteAsRichText:(id)sender;
1148     */
1149     HRESULT pasteAsRichText([in] IUnknown* sender);
1150
1151
1152     /*
1153         - (void)changeFont:(id)sender;
1154     */
1155     HRESULT changeFont([in] IUnknown* sender);
1156
1157     /*
1158         - (void)changeAttributes:(id)sender;
1159     */
1160     HRESULT changeAttributes([in] IUnknown* sender);
1161
1162     /*
1163         - (void)changeDocumentBackgroundColor:(id)sender;
1164     */
1165     HRESULT changeDocumentBackgroundColor([in] IUnknown* sender);
1166
1167     /*
1168         - (void)changeColor:(id)sender;
1169     */
1170     HRESULT changeColor([in] IUnknown* sender);
1171
1172
1173     /*
1174         - (void)alignCenter:(id)sender;
1175     */
1176     HRESULT alignCenter([in] IUnknown* sender);
1177
1178     /*
1179         - (void)alignJustified:(id)sender;
1180     */
1181     HRESULT alignJustified([in] IUnknown* sender);
1182
1183     /*
1184         - (void)alignLeft:(id)sender;
1185     */
1186     HRESULT alignLeft([in] IUnknown* sender);
1187
1188     /*
1189         - (void)alignRight:(id)sender;
1190     */
1191     HRESULT alignRight([in] IUnknown* sender);
1192
1193
1194     /*
1195         - (void)checkSpelling:(id)sender;
1196     */
1197     HRESULT checkSpelling([in] IUnknown* sender);
1198
1199     /*
1200         - (void)showGuessPanel:(id)sender;
1201     */
1202     HRESULT showGuessPanel([in] IUnknown* sender);
1203
1204     /*
1205         - (void)performFindPanelAction:(id)sender;
1206     */
1207     HRESULT performFindPanelAction([in] IUnknown* sender);
1208
1209
1210     /*
1211         - (void)startSpeaking:(id)sender;
1212     */
1213     HRESULT startSpeaking([in] IUnknown* sender);
1214
1215     /*
1216         - (void)stopSpeaking:(id)sender;
1217     */
1218     HRESULT stopSpeaking([in] IUnknown* sender);
1219 }
1220
1221
1222