include/exdisp.idl

   1 /*
   2  * Defines the COM interfaces and APIs related to the IE Web browser
   3  *
   4  * Copyright (C) 2001 John R. Sheets (for CodeWeavers)
   5  * Copyright (C) 2003 Alexandre Julliard
   6  * Copyright (C) 2004 Jacek Caban
   7  *
   8  * This library is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU Lesser General Public
  10  * License as published by the Free Software Foundation; either
  11  * version 2.1 of the License, or (at your option) any later version.
  12  *
  13  * This library is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * Lesser General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU Lesser General Public
  19  * License along with this library; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  21  */
  22
  23 import "ocidl.idl";
  24 import "docobj.idl";
  25
  26 #include <olectl.h>
  27 #include <exdispid.h>
  28
  29 #ifndef __WIDL__
  30 #define threading(model)
  31 #define progid(str)
  32 #define vi_progid(str)
  33 #endif
  34
  35 cpp_quote("#ifdef WINE_NO_UNICODE_MACROS")
  36 cpp_quote("#undef FindText")
  37 cpp_quote("#endif")
  38
  39 /*****************************************************************************
  40  * SHDocVw library
  41  */
  42 [
  43     uuid(EAB22AC0-30C1-11CF-A7EB-0000C05BAE0B),
  44     version(1.1),
  45     helpstring("Microsoft Internet Controls")
  46 ]
  47 library SHDocVw
  48 {
  49
  50 importlib("stdole2.tlb");
  51
  52
  53 /*****************************************************************************
  54  * IWebBrowser interface
  55  */
  56 [
  57     object,
  58     oleautomation,
  59     uuid(eab22ac1-30c1-11cf-a7eb-0000c05bae0b),
  60     hidden,
  61     dual
  62 ]
  63 interface IWebBrowser : IDispatch
  64 {
  65     typedef enum BrowserNavConstants
  66     {
  67         navOpenInNewWindow          = 0x00000001,
  68         navNoHistory                = 0x00000002,
  69         navNoReadFromCache          = 0x00000004,
  70         navNoWriteToCache           = 0x00000008,
  71         navAllowAutosearch          = 0x00000010,
  72         navBrowserBar               = 0x00000020,
  73         navHyperlink                = 0x00000040,
  74         navEnforceRestricted        = 0x00000080,
  75         navNewWindowsManaged        = 0x00000100,
  76         navUntrustedForDownload     = 0x00000200,
  77         navTrustedForActiveX        = 0x00000400,
  78         navOpenInNewTab             = 0x00000800,
  79         navOpenInBackgroundTab      = 0x00001000,
  80         navKeepWordWheelText        = 0x00002000,
  81         navVirtualTab               = 0x00004000,
  82         navBlockRedirectsXDomain    = 0x00008000,
  83         navOpenNewForegroundTab     = 0x00010000,
  84         navTravelLogScreenshot      = 0x00020000,
  85         navDeferUnload              = 0x00040000,
  86         navSpeculative              = 0x00080000,
  87         navSuggestNewWindow         = 0x00100000,
  88         navSuggestNewTab            = 0x00200000,
  89         navReserved1                = 0x00400000,
  90         navHomepageNavigate         = 0x00800000,
  91         navRefresh                  = 0x01000000,
  92         navHostNavigation           = 0x02000000,
  93         navReserved2                = 0x04000000,
  94         navReserved3                = 0x08000000,
  95         navReserved4                = 0x10000000,
  96     } BrowserNavConstants;
  97
  98     typedef enum RefreshConstants
  99     {
 100         REFRESH_NORMAL     = 0,
 101         REFRESH_IFEXPIRED  = 1,
 102         REFRESH_COMPLETELY = 3
 103     } RefreshConstants;
 104
 105     [id(100)] HRESULT GoBack();
 106     [id(101)] HRESULT GoForward();
 107     [id(102)] HRESULT GoHome();
 108     [id(103)] HRESULT GoSearch();
 109
 110     [id(104)]
 111     HRESULT Navigate(
 112         [in] BSTR URL,
 113         [in, optional] VARIANT *Flags,
 114         [in, optional] VARIANT *TargetFrameName,
 115         [in, optional] VARIANT *PostData,
 116         [in, optional] VARIANT *Headers);
 117
 118     [id(DISPID_REFRESH)] HRESULT Refresh();
 119     [id(105)] HRESULT Refresh2([in, optional] VARIANT *Level);
 120     [id(106)] HRESULT Stop();
 121     [id(200), propget] HRESULT Application([out, retval] IDispatch** ppDisp);
 122     [id(201), propget] HRESULT Parent([out, retval] IDispatch** ppDisp);
 123     [id(202), propget] HRESULT Container([out, retval] IDispatch** ppDisp);
 124     [id(203), propget] HRESULT Document([out, retval] IDispatch** ppDisp);
 125     [id(204), propget] HRESULT TopLevelContainer([out, retval] VARIANT_BOOL* pBool);
 126     [id(205), propget] HRESULT Type([out, retval] BSTR* Type);
 127     [id(206), propget] HRESULT Left([out, retval] long *pl);
 128     [id(206), propput] HRESULT Left([in] long Left);
 129     [id(207), propget] HRESULT Top([out, retval] long *pl);
 130     [id(207), propput] HRESULT Top([in] long Top);
 131     [id(208), propget] HRESULT Width([out, retval] long *pl);
 132     [id(208), propput] HRESULT Width([in] long Width);
 133     [id(209), propget] HRESULT Height([out, retval] long *pl);
 134     [id(209), propput] HRESULT Height([in] long Height);
 135     [id(210), propget] HRESULT LocationName([out, retval] BSTR *LocationName);
 136     [id(211), propget] HRESULT LocationURL([out, retval] BSTR *LocationURL);
 137     [id(212), propget] HRESULT Busy([out, retval] VARIANT_BOOL *pBool);
 138 }
 139
 140 /*****************************************************************************
 141  * DWebBrowserEvents dispinterface
 142  */
 143 [
 144     uuid(eab22ac2-30c1-11CF-a7eb-0000C05bae0b),
 145     hidden
 146 ]
 147 dispinterface DWebBrowserEvents
 148 {
 149     properties:
 150     methods:
 151     [id(DISPID_BEFORENAVIGATE)]
 152     void BeforeNavigate(
 153         [in] BSTR URL,
 154         long Flags,
 155         BSTR TargetFrameName,
 156         VARIANT *PostData,
 157         BSTR Headers,
 158         [in, out] VARIANT_BOOL *Cancel);
 159
 160     [id(DISPID_NAVIGATECOMPLETE)]
 161     void NavigateComplete([in] BSTR URL);
 162
 163     [id(DISPID_STATUSTEXTCHANGE)]
 164     void StatusTextChange([in] BSTR Text);
 165
 166     [id(DISPID_PROGRESSCHANGE)]
 167     void ProgressChange([in] long Progress, [in] long ProgressMax);
 168
 169     [id(DISPID_DOWNLOADCOMPLETE)]
 170     void DownloadComplete();
 171
 172     [id(DISPID_COMMANDSTATECHANGE)]
 173     void CommandStateChange([in] long Command, [in]VARIANT_BOOL Enable);
 174
 175     [id(DISPID_DOWNLOADBEGIN)]
 176     void DownloadBegin();
 177
 178     [id(DISPID_NEWWINDOW)]
 179     void NewWindow(
 180         [in] BSTR URL,
 181         [in] long Flags,
 182         [in] BSTR TargetFrameName,
 183         [in] VARIANT *PostData,
 184         [in] BSTR Headers,
 185         [in,out] VARIANT_BOOL *Processed);
 186
 187     [id(DISPID_TITLECHANGE)]
 188     void TitleChange([in] BSTR Text);
 189
 190     [id(DISPID_FRAMEBEFORENAVIGATE)]
 191     void FrameBeforeNavigate(
 192         [in] BSTR URL,
 193         long Flags,
 194         BSTR TargetFrameName,
 195         VARIANT *PostData,
 196         BSTR Headers,
 197         [in, out]VARIANT_BOOL *Cancel);
 198
 199     [id(DISPID_FRAMENAVIGATECOMPLETE)]
 200     void FrameNavigateComplete([in] BSTR URL);
 201
 202     [id(DISPID_FRAMENEWWINDOW)]
 203     void FrameNewWindow(
 204         [in] BSTR URL,
 205         [in] long Flags,
 206         [in] BSTR TargetFrameName,
 207         [in] VARIANT *PostData,
 208         [in] BSTR Headers,
 209         [in,out] VARIANT_BOOL *Processed);
 210
 211     [id(DISPID_QUIT)]
 212     void Quit([in, out] VARIANT_BOOL *Cancel);
 213
 214     [id(DISPID_WINDOWMOVE)]
 215     void WindowMove();
 216
 217     [id(DISPID_WINDOWRESIZE)]
 218     void WindowResize();
 219
 220     [id(DISPID_WINDOWACTIVATE)]
 221     void WindowActivate();
 222
 223     [id(DISPID_PROPERTYCHANGE)]
 224     void PropertyChange([in] BSTR Property);
 225 }
 226
 227 typedef
 228 [
 229     uuid(34a226e0-df30-11cf-89a9-00a0c9054129)
 230 ]
 231 enum CommandStateChangeConstants {
 232     CSC_UPDATECOMMANDS  = -1,
 233     CSC_NAVIGATEFORWARD = 1,
 234     CSC_NAVIGATEBACK    = 2
 235 } CommandStateChangeConstants;
 236
 237 /*****************************************************************************
 238  * IWebBrowserApp interface
 239  */
 240 [
 241     object,
 242     oleautomation,
 243     uuid(0002df05-0000-0000-c000-000000000046),
 244     hidden,
 245     dual
 246 ]
 247 interface IWebBrowserApp : IWebBrowser
 248 {
 249     [id(300)] HRESULT Quit();
 250     [id(301)] HRESULT ClientToWindow([in,out] int* pcx, [in,out] int* pcy);
 251     [id(302)] HRESULT PutProperty([in] BSTR Property, [in] VARIANT vtValue);
 252     [id(303)] HRESULT GetProperty([in] BSTR Property, [out, retval] VARIANT *pvtValue);
 253     [id(DISPID_VALUE), propget] HRESULT Name([out, retval] BSTR* Name);
 254     [id(DISPID_HWND), propget] HRESULT HWND([out, retval] SHANDLE_PTR *pHWND);
 255     [id(400), propget] HRESULT FullName([out, retval] BSTR* FullName);
 256     [id(401), propget] HRESULT Path([out, retval] BSTR* Path);
 257     [id(402), propget] HRESULT Visible([out, retval] VARIANT_BOOL* pBool);
 258     [id(402), propput] HRESULT Visible([in] VARIANT_BOOL Value);
 259     [id(403), propget] HRESULT StatusBar([out, retval] VARIANT_BOOL* pBool);
 260     [id(403), propput] HRESULT StatusBar([in] VARIANT_BOOL Value);
 261     [id(404), propget] HRESULT StatusText([out, retval] BSTR *StatusText);
 262     [id(404), propput] HRESULT StatusText([in] BSTR StatusText);
 263     [id(405), propget] HRESULT ToolBar([out, retval] int * Value);
 264     [id(405), propput] HRESULT ToolBar([in] int Value);
 265     [id(406), propget] HRESULT MenuBar([out, retval] VARIANT_BOOL *Value);
 266     [id(406), propput] HRESULT MenuBar([in] VARIANT_BOOL Value);
 267     [id(407), propget] HRESULT FullScreen([out, retval] VARIANT_BOOL *pbFullScreen);
 268     [id(407), propput] HRESULT FullScreen([in] VARIANT_BOOL bFullScreen);
 269 }
 270
 271 /*****************************************************************************
 272  * IWebBrowser2 interface
 273  */
 274 [
 275     object,
 276     oleautomation,
 277     uuid(d30c1661-cdaf-11d0-8a3e-00c04fc9e26e),
 278     hidden,
 279     dual
 280 ]
 281 interface IWebBrowser2 : IWebBrowserApp
 282 {
 283     [id(500)] HRESULT Navigate2(
 284         [in] VARIANT *URL,
 285         [in, optional] VARIANT *Flags,
 286         [in, optional] VARIANT *TargetFrameName,
 287         [in, optional] VARIANT *PostData,
 288         [in, optional] VARIANT *Headers);
 289
 290     [id(501)] HRESULT QueryStatusWB(
 291         [in] OLECMDID cmdID,
 292         [out, retval] OLECMDF *pcmdf);
 293
 294     [id(502)] HRESULT ExecWB(
 295         [in] OLECMDID cmdID,
 296         [in] OLECMDEXECOPT cmdexecopt,
 297         [in, optional] VARIANT *pvaIn,
 298         [out, in, optional] VARIANT *pvaOut);
 299
 300     [id(503)] HRESULT ShowBrowserBar(
 301         [in] VARIANT *pvaClsid,
 302         [in, optional] VARIANT *pvarShow,
 303         [in, optional] VARIANT *pvarSize);
 304
 305     [id(DISPID_READYSTATE), propget, bindable]
 306     HRESULT ReadyState([out, retval] READYSTATE *plReadyState);
 307
 308     [id(550), propget] HRESULT Offline([out, retval] VARIANT_BOOL *pbOffline);
 309     [id(550), propput] HRESULT Offline([in] VARIANT_BOOL bOffline);
 310     [id(551), propget] HRESULT Silent([out, retval] VARIANT_BOOL *pbSilent);
 311     [id(551), propput] HRESULT Silent([in] VARIANT_BOOL bSilent);
 312     [id(552), propget] HRESULT RegisterAsBrowser([out, retval] VARIANT_BOOL *pbRegister);
 313     [id(552), propput] HRESULT RegisterAsBrowser([in] VARIANT_BOOL bRegister);
 314     [id(553), propget] HRESULT RegisterAsDropTarget([out, retval] VARIANT_BOOL *pbRegister);
 315     [id(553), propput] HRESULT RegisterAsDropTarget([in] VARIANT_BOOL bRegister);
 316     [id(554), propget] HRESULT TheaterMode([out, retval] VARIANT_BOOL *pbRegister);
 317     [id(554), propput] HRESULT TheaterMode([in] VARIANT_BOOL bRegister);
 318     [id(555), propget] HRESULT AddressBar([out, retval] VARIANT_BOOL *Value);
 319     [id(555), propput] HRESULT AddressBar([in] VARIANT_BOOL Value);
 320     [id(556), propget] HRESULT Resizable([out, retval] VARIANT_BOOL *Value);
 321     [id(556), propput] HRESULT Resizable([in] VARIANT_BOOL Value);
 322 }
 323
 324 typedef
 325 [
 326     uuid(65507be0-91a8-11d3-a845-009027220e6d)
 327 ]
 328 enum SecureLockIconConstants {
 329     secureLockIconUnsecure          = 0,
 330     secureLockIconMixed             = 1,
 331     secureLockIconSecureUnknownBits = 2,
 332     secureLockIconSecure40Bit       = 3,
 333     secureLockIconSecure56Bit       = 4,
 334     secureLockIconSecureFortezza    = 5,
 335     secureLockIconSecure128Bit      = 6
 336 } SecureLockIconConstants;
 337
 338 /*****************************************************************************
 339  * DWebBrowserEvents2 dispinterface
 340  */
 341 [
 342     uuid(34a715a0-6587-11d0-924a-0020afc7ac4d),
 343     hidden
 344 ]
 345 dispinterface DWebBrowserEvents2
 346 {
 347     properties:
 348     methods:
 349     [id(DISPID_STATUSTEXTCHANGE)]
 350     void StatusTextChange([in] BSTR Text);
 351
 352     [id(DISPID_PROGRESSCHANGE)]
 353     void ProgressChange([in] long Progress, [in] long ProgressMax);
 354
 355     [id(DISPID_COMMANDSTATECHANGE)]
 356     void CommandStateChange([in] long Command, [in] VARIANT_BOOL Enable);
 357
 358     [id(DISPID_DOWNLOADBEGIN)]
 359     void DownloadBegin();
 360
 361     [id(DISPID_DOWNLOADCOMPLETE)]
 362     void DownloadComplete();
 363
 364     [id(DISPID_TITLECHANGE)]
 365     void TitleChange([in] BSTR Text);
 366
 367     [id(DISPID_PROPERTYCHANGE)]
 368     void PropertyChange([in] BSTR szProperty);
 369
 370     [id(DISPID_BEFORENAVIGATE2)]
 371     void BeforeNavigate2(
 372         [in] IDispatch *pDisp,
 373         [in] VARIANT *URL,
 374         [in] VARIANT *Flags,
 375         [in] VARIANT *TargetFrameName,
 376         [in] VARIANT *PostData,
 377         [in] VARIANT *Headers,
 378         [in, out] VARIANT_BOOL *Cancel);
 379
 380     [id(DISPID_NEWWINDOW2)]
 381     void NewWindow2([in, out] IDispatch **ppDisp, [in, out] VARIANT_BOOL *Cancel);
 382
 383     [id(DISPID_NAVIGATECOMPLETE2)]
 384     void NavigateComplete2([in] IDispatch *pDisp, [in] VARIANT *URL);
 385
 386     [id(DISPID_DOCUMENTCOMPLETE)]
 387     void DocumentComplete([in] IDispatch *pDisp, [in] VARIANT *URL);
 388
 389     [id(DISPID_ONQUIT)]
 390     void OnQuit();
 391
 392     [id(DISPID_ONVISIBLE)]
 393     void OnVisible([in] VARIANT_BOOL Visible);
 394
 395     [id(DISPID_ONTOOLBAR)]
 396     void OnToolBar([in] VARIANT_BOOL ToolBar);
 397
 398     [id(DISPID_ONMENUBAR)]
 399     void OnMenuBar([in] VARIANT_BOOL MenuBar);
 400
 401     [id(DISPID_ONSTATUSBAR)]
 402     void OnStatusBar([in] VARIANT_BOOL StatusBar);
 403
 404     [id(DISPID_ONFULLSCREEN)]
 405     void OnFullScreen([in] VARIANT_BOOL FullScreen);
 406
 407     [id(DISPID_ONTHEATERMODE)]
 408     void OnTheaterMode([in] VARIANT_BOOL TheaterMode);
 409
 410     [id(DISPID_WINDOWSETRESIZABLE)]
 411     void WindowSetResizable([in] VARIANT_BOOL Resizable);
 412
 413     [id(DISPID_WINDOWSETLEFT)]
 414     void WindowSetLeft([in] long Left);
 415
 416     [id(DISPID_WINDOWSETTOP)]
 417     void WindowSetTop([in] long Top);
 418
 419     [id(DISPID_WINDOWSETWIDTH)]
 420     void WindowSetWidth([in] long Width);
 421
 422     [id(DISPID_WINDOWSETHEIGHT)]
 423     void WindowSetHeight([in] long Height);
 424
 425     [id(DISPID_WINDOWCLOSING)]
 426     void WindowClosing(
 427             [in] VARIANT_BOOL IsChildWindow,
 428             [in, out] VARIANT_BOOL *Cancel);
 429
 430     [id(DISPID_CLIENTTOHOSTWINDOW)]
 431     void ClientToHostWindow(
 432             [in, out] long *CX,
 433             [in, out] long *CY);
 434
 435     [id(DISPID_SETSECURELOCKICON)]
 436     void SetSecureLockIcon([in] long SecureLockIcon);
 437
 438     [id(DISPID_FILEDOWNLOAD)]
 439     void FileDownload(
 440             [in] VARIANT_BOOL ActiveDocument,
 441             [in, out] VARIANT_BOOL *Cancel);
 442
 443     [id(DISPID_NAVIGATEERROR)]
 444     void NavigateError(
 445             [in] IDispatch *pDisp,
 446             [in] VARIANT *URL,
 447             [in] VARIANT *Frame,
 448             [in] VARIANT *StatusCode,
 449             [in, out] VARIANT_BOOL *Cancel);
 450
 451     [id(DISPID_PRINTTEMPLATEINSTANTIATION)]
 452     void PrintTemplateInstantiation([in] IDispatch *pDisp);
 453
 454     [id(DISPID_PRINTTEMPLATETEARDOWN)]
 455     void PrintTemplateTeardown([in] IDispatch *pDisp);
 456
 457     [id(DISPID_UPDATEPAGESTATUS)]
 458     void UpdatePageStatus(
 459             [in] IDispatch *pDisp,
 460             [in] VARIANT *nPage,
 461             [in] VARIANT *fDone);
 462
 463     [id(DISPID_PRIVACYIMPACTEDSTATECHANGE)]
 464     void PrivacyImpactedStateChange([in] VARIANT_BOOL bImpacted);
 465
 466     [id(DISPID_NEWWINDOW3)]
 467     void NewWindow3(
 468             [in, out] IDispatch **ppDisp,
 469             [in, out] VARIANT_BOOL *Cancel,
 470             [in] DWORD dwFlags,
 471             [in] BSTR bstrUrlContext,
 472             [in] BSTR bstrUrl);
 473
 474     [id(DISPID_SETPHISHINGFILTERSTATUS)]
 475     void SetPhishingFilterStatus([in] long PhishingFilterStatus);
 476
 477     [id(DISPID_WINDOWSTATECHANGED)]
 478     void WindowStateChanged(
 479             [in] DWORD dwWindowStateFlags,
 480             [in] DWORD dwValidFlagsMask);
 481
 482     [id(DISPID_NEWPROCESS)]
 483     void NewProcess(
 484             [in] long lCauseFlag,
 485             [in] IDispatch *pWB2,
 486             [in, out] VARIANT_BOOL *Cancel);
 487
 488     [id(DISPID_THIRDPARTYURLBLOCKED)]
 489     void ThirdPartyUrlBlocked(
 490             [in] VARIANT *URL,
 491             [in] DWORD dwCount);
 492
 493     [id(DISPID_REDIRECTXDOMAINBLOCKED)]
 494     void RedirectXDomainBlocked(
 495             [in] IDispatch *pDisp,
 496             [in] VARIANT *StartURL,
 497             [in] VARIANT *RedirectURL,
 498             [in] VARIANT *Frame,
 499             [in] VARIANT *StatusCode);
 500
 501     [id(DISPID_BEFORESCRIPTEXECUTE)]
 502     void BeforeScriptExecute([in] IDispatch *pDispWindow);
 503
 504     [id(DISPID_WEBWORKERSTARTED)]
 505     void WebWorkerStarted(
 506             [in] DWORD dwUniqueID,
 507             [in] BSTR bstrWorkerLabel);
 508
 509     [id(DISPID_WEBWORKERFINISHED)]
 510     void WebWorkerFinished([in] DWORD dwUniqueID);
 511 }
 512
 513 [
 514     helpstring("Microsoft Web Browser Version 1"),
 515     threading(apartment),
 516     progid("Shell.Explorer.1"),
 517     vi_progid("Shell.Explorer"),
 518     uuid(eab22ac3-30c1-11cf-a7eb-0000c05bae0b),
 519     control
 520 ]
 521 coclass WebBrowser_V1
 522 {
 523     interface IWebBrowser2;
 524     [default] interface IWebBrowser;
 525     [source] dispinterface DWebBrowserEvents2;
 526     [default, source] dispinterface DWebBrowserEvents;
 527 }
 528
 529 [
 530     helpstring("Microsoft Web Browser"),
 531     threading(apartment),
 532     progid("Shell.Explorer.2"),
 533     vi_progid("Shell.Explorer"),
 534     uuid(8856f961-340a-11d0-a96b-00c04fd705a2),
 535     control
 536 ]
 537 coclass WebBrowser
 538 {
 539     [default] interface IWebBrowser2;
 540     interface IWebBrowser;
 541     [default, source] dispinterface DWebBrowserEvents2;
 542     [source] dispinterface DWebBrowserEvents;
 543 }
 544
 545 [
 546     helpstring("Internet Explorer(Ver 1.0)"),
 547     progid("InternetExplorer.Application.1"),
 548     vi_progid("InternetExplorer.Application"),
 549     uuid(0002df01-0000-0000-c000-000000000046)
 550 ]
 551 coclass InternetExplorer
 552 {
 553     [default] interface IWebBrowser2;
 554               interface IWebBrowserApp;
 555     [default, source] dispinterface DWebBrowserEvents2;
 556     [source]          dispinterface DWebBrowserEvents;
 557 }
 558
 559 [
 560     uuid(C08AFD90-F2A1-11D1-8455-00A0C91F3880),
 561     hidden
 562 ]
 563 coclass ShellBrowserWindow
 564 {
 565     [default] interface IWebBrowser2;
 566     interface IWebBrowserApp;
 567     [default, source] dispinterface DWebBrowserEvents2;
 568     [source] dispinterface DWebBrowserEvents;
 569 }
 570
 571 typedef
 572 [
 573     uuid(f41e6981-28e5-11d0-82b4-00a0c90c29c5)
 574 ]
 575 enum ShellWindowTypeConstants {
 576     SWC_EXPLORER = 0,
 577     SWC_BROWSER  = 1,
 578     SWC_3RDPARTY = 2,
 579     SWC_CALLBACK = 4,
 580     SWC_DESKTOP  = 8
 581 } ShellWindowTypeConstants;
 582
 583 typedef
 584 [
 585     uuid(7716a370-38Ca-11d0-a48B-00a0c90a8f39)
 586 ]
 587 enum ShellWindowFindWindowOptions {
 588     SWFO_NEEDDISPATCH   = 1,
 589     SWFO_INCLUDEPENDING = 2,
 590     SWFO_COOKIEPASSED   = 4
 591 } ShellWindowFindWindowOptions;
 592
 593 [
 594     uuid(FE4106E0-399A-11D0-A48C-00A0C90A8F39)
 595 ]
 596 dispinterface DShellWindowsEvents {
 597     properties:
 598     methods:
 599     [id(DISPID_WINDOWREGISTERED)]
 600     void WindowRegistered([in] long lCookie);
 601
 602     [id(DISPID_WINDOWREVOKED)]
 603     void WindowRevoked([in] long lCookie);
 604 }
 605
 606 [
 607     object,
 608     oleautomation,
 609     uuid(85cb6900-4d95-11cf-960c-0080c7f4ee85),
 610     dual
 611 ]
 612 interface IShellWindows : IDispatch
 613 {
 614     [propget] HRESULT Count([out, retval] long *Count);
 615
 616     [id(DISPID_VALUE)]
 617     HRESULT Item(
 618             [in, optional] VARIANT index,
 619             [out, retval] IDispatch **Folder);
 620
 621     [id(DISPID_NEWENUM)]
 622     HRESULT _NewEnum([out, retval] IUnknown **ppunk);
 623
 624     [hidden] HRESULT Register(
 625             [in] IDispatch *pid,
 626             [in] long hWnd,
 627             [in] int swClass,
 628             [out] long *plCookie);
 629
 630     [hidden] HRESULT RegisterPending(
 631             [in] long lThreadId,
 632             [in] VARIANT *pvarloc,
 633             [in] VARIANT *pvarlocRoot,
 634             [in] int swClass,
 635             [out] long *plCookie);
 636
 637     [hidden] HRESULT Revoke([in] long lCookie);
 638     [hidden] HRESULT OnNavigate([in] long lCookie, [in] VARIANT *pvarLoc);
 639     [hidden] HRESULT OnActivated([in] long lCookie, [in] VARIANT_BOOL fActive);
 640     [hidden] HRESULT FindWindowSW(
 641             [in] VARIANT *pvarLoc,
 642             [in] VARIANT *pvarLocRoot,
 643             [in] int swClass,
 644             [out] long *phwnd,
 645             [in] int swfwOptions,
 646             [out, retval] IDispatch **ppdispOut);
 647
 648     [hidden] HRESULT OnCreated([in] long lCookie, [in] IUnknown *punk);
 649     [hidden] HRESULT ProcessAttachDetach([in] VARIANT_BOOL fAttach);
 650 }
 651
 652 [
 653     threading(apartment),
 654     uuid(9ba05972-f6a8-11cf-a442-00a0c90a8f39)
 655 ]
 656 coclass ShellWindows
 657 {
 658     [default] interface IShellWindows;
 659     [default, source] dispinterface DShellWindowsEvents;
 660 }
 661
 662 [
 663     odl,
 664     uuid(729fe2f8-1ea8-11d1-8f85-00C04fc2fbe1),
 665     dual,
 666     oleautomation
 667 ]
 668 interface IShellUIHelper : IDispatch {
 669     [id(1), hidden] HRESULT ResetFirstBootMode();
 670     [id(2), hidden] HRESULT ResetSafeMode();
 671     [id(3), hidden] HRESULT RefreshOfflineDesktop();
 672
 673     [id(4)] HRESULT AddFavorite(
 674             [in] BSTR URL,
 675             [in, optional] VARIANT* Title);
 676
 677     [id(5)] HRESULT AddChannel([in] BSTR URL);
 678
 679     [id(6)] HRESULT AddDesktopComponent(
 680             [in] BSTR URL,
 681             [in] BSTR Type,
 682             [in, optional] VARIANT *Left,
 683             [in, optional] VARIANT *Top,
 684             [in, optional] VARIANT *Width,
 685             [in, optional] VARIANT *Height);
 686
 687     [id(7)] HRESULT IsSubscribed(
 688             [in] BSTR URL,
 689             [out, retval] VARIANT_BOOL *pBool);
 690
 691     [id(8)] HRESULT NavigateAndFind(
 692             [in] BSTR URL,
 693             [in] BSTR strQuery,
 694             [in] VARIANT *varTargetFrame);
 695
 696     [id(9)] HRESULT ImportExportFavorites(
 697             [in] VARIANT_BOOL fImport,
 698             [in] BSTR strImpExpPath);
 699
 700     [id(10)] HRESULT AutoCompleteSaveForm([in, optional] VARIANT *Form);
 701
 702     [id(11)] HRESULT AutoScan(
 703             [in] BSTR strSearch,
 704             [in] BSTR strFailureUrl,
 705             [in, optional] VARIANT *pvarTargetFrame);
 706
 707     [id(12), hidden] HRESULT AutoCompleteAttach([in, optional] VARIANT *Reserved);
 708
 709     [id(13)] HRESULT ShowBrowserUI(
 710             [in] BSTR bstrName,
 711             [in] VARIANT *pvarIn,
 712             [out, retval] VARIANT *pvarOut);
 713 }
 714
 715 [
 716     uuid(a7fe6eda-1932-4281-b881-87b31b8bc52c),
 717     oleautomation,
 718     dual
 719 ]
 720 interface IShellUIHelper2 : IShellUIHelper {
 721     [id(DISPID_ADDSEARCHPROVIDER)]
 722     HRESULT AddSearchProvider([in] BSTR URL);
 723
 724     [id(DISPID_RUNONCESHOWN)]
 725     HRESULT RunOnceShown();
 726
 727     [id(DISPID_SKIPRUNONCE)]
 728     HRESULT SkipRunOnce();
 729
 730     [id(DISPID_CUSTOMIZESETTINGS)] HRESULT CustomizeSettings(
 731         [in] VARIANT_BOOL fSQM,
 732         [in] VARIANT_BOOL fPhishing,
 733         [in] BSTR bstrLocale);
 734
 735     [id(DISPID_SQMENABLED)]
 736     HRESULT SqmEnabled([out, retval] VARIANT_BOOL *pfEnabled);
 737
 738     [id(DISPID_PHISHINGENABLED)]
 739     HRESULT PhishingEnabled([out, retval] VARIANT_BOOL *pfEnabled);
 740
 741     [id(DISPID_BRANDIMAGEURI)]
 742     HRESULT BrandImageUri([out, retval] BSTR *pbstrUri);
 743
 744     [id(DISPID_SKIPTABSWELCOME)]
 745     HRESULT SkipTabsWelcome();
 746
 747     [id(DISPID_DIAGNOSECONNECTION)]
 748     HRESULT DiagnoseConnection();
 749
 750     [id(DISPID_CUSTOMIZECLEARTYPE)]
 751     HRESULT CustomizeClearType([in] VARIANT_BOOL fSet);
 752
 753     [id(DISPID_ISSEARCHPROVIDERINSTALLED)]
 754     HRESULT IsSearchProviderInstalled(
 755         [in] BSTR URL,
 756         [out, retval] DWORD *pdwResult);
 757
 758     [id(DISPID_ISSEARCHMIGRATED)]
 759     HRESULT IsSearchMigrated([out, retval] VARIANT_BOOL *pfMigrated);
 760
 761     [id(DISPID_DEFAULTSEARCHPROVIDER)]
 762     HRESULT DefaultSearchProvider([out, retval] BSTR *pbstrName);
 763
 764     [id(DISPID_RUNONCEREQUIREDSETTINGSCOMPLETE)]
 765     HRESULT RunOnceRequiredSettingsComplete([in] VARIANT_BOOL fComplete);
 766
 767     [id(DISPID_RUNONCEHASSHOWN)]
 768     HRESULT RunOnceHasShown([out, retval] VARIANT_BOOL *pfShown);
 769
 770     [id(DISPID_SEARCHGUIDEURL)]
 771     HRESULT SearchGuideUrl([out, retval] BSTR *pbstrUrl);
 772 }
 773
 774 [
 775     helpstring("Microsoft Shell UI Helper"),
 776     threading(apartment),
 777     progid("Shell.UIHelper.1"),
 778     vi_progid("Shell.UIHelper"),
 779     uuid(64ab4bb7-111e-11d1-8f79-00c04fc2fbe1)
 780 ]
 781 coclass ShellUIHelper {
 782     [default] interface IShellUIHelper2;
 783 }
 784
 785 [
 786     uuid(55136806-b2de-11d1-b9f2-00a0c98bc547)
 787 ]
 788 dispinterface DShellNameSpaceEvents {
 789     properties:
 790     methods:
 791     [id(1)] void FavoritesSelectionChange(
 792             [in] long cItems,
 793             [in] long hItem,
 794             [in] BSTR strName,
 795             [in] BSTR strUrl,
 796             [in] long cVisits,
 797             [in] BSTR strDate,
 798             [in] long fAvailableOffline);
 799
 800     [id(2)] void SelectionChange();
 801     [id(3)] void DoubleClick();
 802     [id(4)] void Initialized();
 803 }
 804
 805 [
 806     odl,
 807     uuid(55136804-b2de-11d1-b9f2-00a0c98bc547),
 808     hidden,
 809     dual,
 810     oleautomation
 811 ]
 812 interface IShellFavoritesNameSpace : IDispatch {
 813     [id(1)] HRESULT MoveSelectionUp();
 814     [id(2)] HRESULT MoveSelectionDown();
 815     [id(3)] HRESULT ResetSort();
 816     [id(4)] HRESULT NewFolder();
 817     [id(5)] HRESULT Synchronize();
 818     [id(6)] HRESULT Import();
 819     [id(7)] HRESULT Export();
 820     [id(8)] HRESULT InvokeContextMenuCommand([in] BSTR strCommand);
 821     [id(9)] HRESULT MoveSelectionTo();
 822     [id(10), propget] HRESULT SubscriptionsEnabled([out, retval] VARIANT_BOOL *pBool);
 823     [id(11)] HRESULT CreateSubscriptionForSelection([out, retval] VARIANT_BOOL *pBool);
 824     [id(12)] HRESULT DeleteSubscriptionForSelection([out, retval] VARIANT_BOOL *pBool);
 825     [id(13)] HRESULT SetRoot([in] BSTR bstrFullPath);
 826 }
 827
 828 [
 829     odl,
 830     uuid(e572d3c9-37be-4ae2-825d-d521763e3108),
 831     hidden,
 832     dual,
 833     oleautomation
 834 ]
 835 interface IShellNameSpace : IShellFavoritesNameSpace {
 836     [id(14), propget] HRESULT EnumOptions([out, retval] long* pgrfEnumFlags);
 837     [id(14), propput] HRESULT EnumOptions([in] long pgrfEnumFlags);
 838
 839     [id(15), propget] HRESULT SelectedItem([out, retval] IDispatch **pItem);
 840     [id(15), propput] HRESULT SelectedItem([in] IDispatch *pItem);
 841
 842     [id(16), propget] HRESULT Root([out, retval] VARIANT *pvar);
 843     [id(16), propput] HRESULT Root([in] VARIANT pvar);
 844
 845     [id(17), propget] HRESULT Depth([out, retval] int *piDepth);
 846     [id(17), propput] HRESULT Depth([in] int piDepth);
 847
 848     [id(18), propget] HRESULT Mode([out, retval] unsigned int *puMode);
 849     [id(18), propput] HRESULT Mode([in] unsigned int puMode);
 850
 851     [id(19), propget] HRESULT Flags([out, retval] unsigned long *pdwFlags);
 852     [id(19), propput] HRESULT Flags([in] unsigned long pdwFlags);
 853
 854     [id(20), propput] HRESULT TVFlags([in] unsigned long dwFlags);
 855     [id(20), propget] HRESULT TVFlags([out, retval] unsigned long *dwFlags);
 856
 857     [id(21), propget] HRESULT Columns([out, retval] BSTR *bstrColumns);
 858     [id(21), propput] HRESULT Columns([in] BSTR bstrColumns);
 859
 860     [id(22), propget] HRESULT CountViewTypes([out, retval] int *piTypes);
 861
 862     [id(23)] HRESULT SetViewType([in] int iType);
 863     [id(24)] HRESULT SelectedItems([out, retval] IDispatch **ppid);
 864     [id(25)] HRESULT Expand([in] VARIANT var,  int iDepth);
 865     [id(26)] HRESULT UnselectAll();
 866 }
 867
 868 [
 869     helpstring("Shell Name Space"),
 870     threading(apartment),
 871     progid("ShellNameSpace.ShellNameSpace.1"),
 872     vi_progid("ShellNameSpace.ShellNameSpace"),
 873     uuid(2f2f1f96-2bc1-4b1c-be28-ea3774f4676a)
 874 ]
 875 coclass ShellShellNameSpace {
 876     [default] interface IShellNameSpace;
 877     [default, source] dispinterface DShellNameSpaceEvents;
 878 }
 879
 880 [
 881     helpstring("Shell Name Space"),
 882     threading(apartment),
 883     progid("ShellNameSpace.ShellNameSpace.1"),
 884     vi_progid("ShellNameSpace.ShellNameSpace"),
 885     uuid(55136805-b2de-11d1-b9f2-00a0c98bc547)
 886 ]
 887 coclass ShellNameSpace {
 888     [default] interface IShellNameSpace;
 889     [default, source] dispinterface DShellNameSpaceEvents;
 890 }
 891
 892 [
 893     odl,
 894     uuid(f3470f24-15fd-11d2-bb2e-00805ff7efca),
 895     hidden,
 896     dual,
 897     oleautomation
 898 ]
 899 interface IScriptErrorList : IDispatch {
 900     [id(10)] HRESULT advanceError();
 901     [id(11)] HRESULT retreatError();
 902     [id(12)] HRESULT canAdvanceError([out, retval] long *pfCanAdvance);
 903     [id(13)] HRESULT canRetreatError([out, retval] long *pfCanRetreat);
 904     [id(14)] HRESULT getErrorLine([out, retval] long *plLine);
 905     [id(15)] HRESULT getErrorChar([out, retval] long *plChar);
 906     [id(16)] HRESULT getErrorCode([out, retval] long *plCode);
 907     [id(17)] HRESULT getErrorMsg([out, retval] BSTR *pstr);
 908     [id(18)] HRESULT getErrorUrl([out, retval] BSTR *pstr);
 909     [id(23)] HRESULT getAlwaysShowLockState([out, retval] long *pfAlwaysShowLocked);
 910     [id(19)] HRESULT getDetailsPaneOpen([out, retval] long *pfDetailsPaneOpen);
 911     [id(20)] HRESULT setDetailsPaneOpen(long fDetailsPaneOpen);
 912     [id(21)] HRESULT getPerErrorDisplay([out, retval] long *pfPerErrorDisplay);
 913     [id(22)] HRESULT setPerErrorDisplay(long fPerErrorDisplay);
 914 }
 915
 916 [
 917     uuid(efd01300-160f-11d2-bb2e-00805ff7efca),
 918     hidden,
 919     noncreatable
 920 ]
 921 coclass CScriptErrorList {
 922     [default] interface IScriptErrorList;
 923 }
 924
 925 [
 926     odl,
 927     uuid(ba9239a4-3dd5-11d2-bf8b-00c04fb93661),
 928     hidden,
 929     dual,
 930     oleautomation
 931 ]
 932 interface ISearch : IDispatch {
 933     [propget] HRESULT Title([out, retval] BSTR *pbstrTitle);
 934     [propget] HRESULT Id([out, retval] BSTR *pbstrId);
 935     [propget] HRESULT URL([out, retval] BSTR *pbstrUrl);
 936 }
 937
 938 [
 939     odl,
 940     uuid(47c922a2-3dd5-11d2-bf8b-00c04fb93661),
 941     hidden,
 942     dual,
 943     oleautomation
 944 ]
 945 interface ISearches : IDispatch {
 946     [propget] HRESULT Count([out, retval] long *plCount);
 947     [propget] HRESULT Default([out, retval] BSTR *pbstrDefault);
 948
 949     HRESULT Item(
 950             [in, optional] VARIANT index,
 951             [out, retval] ISearch **ppid);
 952
 953     [id(DISPID_NEWENUM)]
 954     HRESULT _NewEnum([out, retval] IUnknown **ppunk);
 955 }
 956
 957 [
 958     odl,
 959     uuid(72423e8f-8011-11d2-be79-00a0c9a83da1),
 960     hidden,
 961     dual,
 962     oleautomation
 963 ]
 964 interface ISearchAssistantOC : IDispatch {
 965     [id(1)] HRESULT AddNextMenuItem([in] BSTR bstrText, [in] long idItem);
 966     [id(2)] HRESULT SetDefaultSearchUrl([in] BSTR bstrUrl);
 967     [id(3)] HRESULT NavigateToDefaultSearch();
 968
 969     [id(4)] HRESULT IsRestricted(
 970             [in] BSTR bstrGuid,
 971             [out, retval] VARIANT_BOOL *pVal);
 972
 973     [id(5), propget] HRESULT ShellFeaturesEnabled([out, retval] VARIANT_BOOL *pVal);
 974     [id(6), propget] HRESULT SearchAssistantDefault([out, retval] VARIANT_BOOL *pVal);
 975     [id(7), propget] HRESULT Searches([out, retval] ISearches **ppid);
 976     [id(8), propget] HRESULT InWebFolder([out, retval] VARIANT_BOOL *pVal);
 977
 978     [id(9)] HRESULT PutProperty(
 979             [in] VARIANT_BOOL bPerLocale,
 980             [in] BSTR bstrName,
 981             [in] BSTR bstrValue);
 982
 983     [id(10)] HRESULT GetProperty(
 984             [in] VARIANT_BOOL bPerLocale,
 985             [in] BSTR bstrName,
 986             [out, retval] BSTR *pbstrValue);
 987
 988     [id(11), propput] HRESULT EventHandled([in] VARIANT_BOOL rhs);
 989     [id(12)] HRESULT ResetNextMenu();
 990     [id(13)] HRESULT FindOnWeb();
 991     [id(14)] HRESULT FindFilesOrFolders();
 992     [id(15)] HRESULT FindComputer();
 993     [id(16)] HRESULT FindPrinter();
 994     [id(17)] HRESULT FindPeople();
 995
 996     [id(18)] HRESULT GetSearchAssistantURL(
 997             [in] VARIANT_BOOL bSubstitute,
 998             [in] VARIANT_BOOL bCustomize,
 999             [out, retval] BSTR *pbstrValue);
1000
1001     [id(19)] HRESULT NotifySearchSettingsChanged();
1002
1003     [id(20), propput] HRESULT ASProvider([in] BSTR pProvider);
1004     [id(20), propget] HRESULT ASProvider([out, retval] BSTR *pProvider);
1005
1006     [id(21), propput] HRESULT ASSetting([in] int pSetting);
1007     [id(21), propget] HRESULT ASSetting([out, retval] int *pSetting);
1008
1009     [id(22)] HRESULT NETDetectNextNavigate();
1010     [id(23)] HRESULT PutFindText([in] BSTR FindText);
1011     [id(24), propget] HRESULT Version([out, retval] int *pVersion);
1012
1013     [id(25)] HRESULT EncodeString(
1014             [in] BSTR bstrValue,
1015             [in] BSTR bstrCharSet,
1016             [in] VARIANT_BOOL bUseUTF8,
1017             [out, retval] BSTR* pbstrResult);
1018 }
1019
1020 [
1021     odl,
1022     uuid(72423e8f-8011-11d2-be79-00a0c9a83da2),
1023     hidden,
1024     dual,
1025     oleautomation
1026 ]
1027 interface ISearchAssistantOC2 : ISearchAssistantOC {
1028     [id(26), propget] HRESULT ShowFindPrinter([out, retval] VARIANT_BOOL *pbShowFindPrinter);
1029 }
1030
1031 [
1032     odl,
1033     uuid(72423e8f-8011-11d2-be79-00a0c9a83da3),
1034     hidden,
1035     dual,
1036     oleautomation
1037 ]
1038 interface ISearchAssistantOC3 : ISearchAssistantOC2 {
1039     [id(27), propget] HRESULT SearchCompanionAvailable([out, retval] VARIANT_BOOL *pbAvailable);
1040
1041     [id(28), propput] HRESULT UseSearchCompanion([in] VARIANT_BOOL pbUseSC);
1042     [id(28), propget] HRESULT UseSearchCompanion([out, retval] VARIANT_BOOL *pbUseSC);
1043 }
1044
1045 [
1046     uuid(1611fdda-445b-11d2-85de-00C04fa35c89),
1047     hidden
1048 ]
1049 dispinterface _SearchAssistantEvents {
1050     properties:
1051     methods:
1052     [id(1)] void OnNextMenuSelect([in] long idItem);
1053     [id(2)] void OnNewSearch();
1054 }
1055
1056 [
1057     helpstring("SearchAssistantOC"),
1058     threading(apartment),
1059     progid("SearchAssistantOC.SearchAssistantOC.1"),
1060     vi_progid("SearchAssistantOC.SearchAssistantOC"),
1061     uuid(2e71fd0f-aab1-42c0-9146-6d2c4edcf07d),
1062     hidden
1063 ]
1064 coclass ShellSearchAssistantOC {
1065     [default] interface ISearchAssistantOC3;
1066     [default, source] dispinterface _SearchAssistantEvents;
1067 }
1068
1069 [
1070     threading(apartment),
1071     progid("SearchAssistantOC.SearchAssistantOC.1"),
1072     vi_progid("SearchAssistantOC.SearchAssistantOC"),
1073     uuid(b45ff030-4447-11d2-85de-00C04fa35c89),
1074     hidden
1075 ]
1076 coclass SearchAssistantOC {
1077     [default] interface ISearchAssistantOC3;
1078     [default, source] dispinterface _SearchAssistantEvents;
1079 }
1080
1081 } /* library */