include/shldisp.idl

   1 /*
   2  * COM interfaces for shell objects
   3  *
   4  * Copyright (C) 2004 Maxime Bellengé
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 import "ocidl.idl";
  22
  23 #include <shdispid.h>
  24
  25 cpp_quote("#ifdef WINE_NO_UNICODE_MACROS")
  26 cpp_quote("#undef ShellExecute")
  27 cpp_quote("#endif")
  28
  29 /*****************************************************************************
  30  * IEnumACString interface
  31  */
  32 [
  33     local,
  34     object,
  35     uuid(8e74c210-cf9d-4eaf-a403-7356428f0a5a),
  36     pointer_default(unique)
  37 ]
  38 interface IEnumACString : IEnumString
  39 {
  40     typedef IEnumACString *PENUMACSTRING, *LPENUMACSTRING;
  41
  42     typedef enum _tagACENUMOPTION
  43     {
  44         ACEO_NONE            = 0x00000000,
  45         ACEO_MOSTRECENTFIRST = 0x00000001,
  46         ACEO_FIRSTUNUSED     = 0x00010000,
  47     } ACENUMOPTION;
  48
  49     HRESULT NextItem( [out] LPWSTR pszUrl,
  50                       [in] ULONG cchMax,
  51                       [out] ULONG *pulSortIndex);
  52
  53     HRESULT SetEnumOptions( [in] DWORD dwOptions );
  54
  55     HRESULT GetEnumOptions( [out] DWORD *pdwOptions );
  56 }
  57
  58 /*****************************************************************************
  59  * IAutoComplete interface
  60  */
  61 [
  62     local,
  63     object,
  64     uuid(00bb2762-6a77-11d0-a535-00c04fd7d062),
  65     pointer_default(unique)
  66 ]
  67 interface IAutoComplete : IUnknown
  68 {
  69     typedef IAutoComplete *LPAUTOCOMPLETE;
  70
  71     HRESULT Init( [in] HWND hwndEdit,
  72                   [in] IUnknown *punkACL,
  73                   [in] LPCOLESTR pwszRegKeyPath,
  74                   [in] LPCOLESTR pwszQuickComplete);
  75
  76     HRESULT Enable( [in] BOOL fEnable );
  77 }
  78
  79 /*****************************************************************************
  80  * IAutoComplete2 interface
  81  */
  82 [
  83     local,
  84     object,
  85     uuid(eac04bc0-3791-11d2-bb95-0060977b464c),
  86     pointer_default(unique)
  87 ]
  88 interface IAutoComplete2 : IAutoComplete
  89 {
  90     typedef IAutoComplete2 *LPAUTOCOMPLETE2;
  91
  92     typedef enum _tagAUTOCOMPLETEOPTIONS
  93         {
  94             ACO_NONE           = 0x00,      /* No AutoComplete */
  95             ACO_AUTOSUGGEST    = 0x01,      /* enable autosuggest dropdown */
  96             ACO_AUTOAPPEND     = 0x02,      /* enable autoappend */
  97             ACO_SEARCH         = 0x04,      /* add search entry to completion list */
  98             ACO_FILTERPREFIXES = 0x08,      /* don't match common prefixes (www., http://, etc) */
  99             ACO_USETAB         = 0x10,      /* use tab to select autosuggest entries */
 100             ACO_UPDOWNKEYDROPSLIST = 0x20,  /* up/down arrow key invokes autosuggest dropdown (if enabled) */
 101             ACO_RTLREADING     = 0x40,      /* enable RTL reading order for dropdown */
 102         } AUTOCOMPLETEOPTIONS;
 103
 104     HRESULT SetOptions( [in] DWORD dwFlag);
 105
 106     HRESULT GetOptions( [out] DWORD *pdwFlag);
 107 }
 108
 109 [
 110     uuid(50a7e9b0-70ef-11d1-b75a-00a0c90564fe),
 111     version(1.0)
 112 ]
 113 library Shell32
 114 {
 115
 116 importlib("stdole2.tlb");
 117
 118 [
 119     object,
 120     oleautomation,
 121     uuid(9ba05970-f6a8-11cf-a442-00a0c90a8f39),
 122     pointer_default(unique)
 123 ]
 124 interface IFolderViewOC : IDispatch
 125 {
 126     HRESULT SetFolderView( [in] IDispatch *pdisp );
 127 }
 128
 129 [
 130     uuid(62112aa2-ebe4-11cf-a5fb-0020afe7292d)
 131 ]
 132 dispinterface DShellFolderViewEvents
 133 {
 134     properties:
 135     methods:
 136     [id(DISPID_SELECTIONCHANGED)]
 137     void SelectionChanged();
 138
 139     [id(DISPID_FILELISTENUMDONE)]
 140     void EnumDone();
 141
 142     [id(DISPID_VERBINVOKED)]
 143     VARIANT_BOOL VerbInvoked();
 144
 145     [id(DISPID_DEFAULTVERBINVOKED)]
 146     VARIANT_BOOL DefaultVerbInvoked();
 147
 148     [id(DISPID_BEGINDRAG)]
 149     VARIANT_BOOL BeginDrag();
 150 }
 151
 152 [
 153     uuid(9ba05971-f6a8-11cf-a442-00a0c90a8f39),
 154     hidden
 155 ]
 156 coclass ShellFolderViewOC
 157 {
 158     [default]         interface     IFolderViewOC;
 159     [default, source] dispinterface DShellFolderViewEvents;
 160 }
 161
 162 interface FolderItem;
 163 interface FolderItems;
 164 interface FolderItemVerb;
 165 interface FolderItemVerbs;
 166
 167 /*****************************************************************************
 168  * Folder interface
 169  */
 170 [
 171     object,
 172     uuid(bbcbde60-c3ff-11ce-8350-444553540000),
 173     oleautomation,
 174     dual
 175 ]
 176 interface Folder : IDispatch
 177 {
 178     [propget, id(DISPID_VALUE)]
 179     HRESULT Title( [out, retval] BSTR *pbs );
 180
 181     [propget]
 182     HRESULT Application( [out, retval] IDispatch **ppid );
 183
 184     [propget]
 185     HRESULT Parent( [out, retval] IDispatch **ppid );
 186
 187     [propget]
 188     HRESULT ParentFolder( [out, retval] Folder **ppsf );
 189
 190     HRESULT Items( [out, retval] FolderItems **ppid );
 191
 192     HRESULT ParseName( [in] BSTR bName, [out, retval] FolderItem **ppid );
 193
 194     HRESULT NewFolder( [in] BSTR bName, [in, optional] VARIANT vOptions );
 195
 196     HRESULT MoveHere( [in] VARIANT vItem, [in, optional] VARIANT vOptions );
 197
 198     HRESULT CopyHere( [in] VARIANT vItem, [in, optional] VARIANT vOptions );
 199
 200     HRESULT GetDetailsOf( [in] VARIANT vItem,
 201         [in] int iColumn,
 202         [out, retval] BSTR *pbs );
 203 }
 204
 205 /*****************************************************************************
 206  * Folder2 interface
 207  */
 208 [
 209     object,
 210     uuid(f0d2d8ef-3890-11d2-bf8b-00c04fb93661),
 211     oleautomation,
 212     dual
 213 ]
 214 interface Folder2 : Folder
 215 {
 216     [propget]
 217     HRESULT Self( [out, retval] FolderItem **ppfi );
 218
 219     [propget]
 220     HRESULT OfflineStatus( [out, retval] LONG *pul );
 221
 222     HRESULT Synchronize();
 223
 224     [propget, id(1)]
 225     HRESULT HaveToShowWebViewBarricade(
 226         [out, retval] VARIANT_BOOL *pbHaveToShowWebViewBarricade );
 227
 228     HRESULT DismissedWebViewBarricade();
 229 }
 230
 231 /*****************************************************************************
 232  * Folder3 interface
 233  */
 234 [
 235     object,
 236     uuid(a7ae5f64-c4d7-4d7f-9307-4d24ee54b841),
 237     oleautomation,
 238     dual
 239 ]
 240 interface Folder3 : Folder2
 241 {
 242     [propget, id(2)]
 243     HRESULT ShowWebViewBarricade(
 244         [out, retval] VARIANT_BOOL *pbShowWebViewBarricade );
 245
 246     [propput, id(2)]
 247     HRESULT ShowWebViewBarricade( [in] VARIANT_BOOL bShowWebViewBarricade );
 248 }
 249
 250 /*****************************************************************************
 251  * FolderItem interface
 252  */
 253 [
 254     object,
 255     uuid(fac32c80-cbe4-11ce-8350-444553540000),
 256     oleautomation,
 257     dual
 258 ]
 259 interface FolderItem : IDispatch
 260 {
 261     typedef FolderItem *LPFOLDERITEM;
 262
 263     [propget]
 264     HRESULT Application( [out, retval] IDispatch **ppid );
 265
 266     [propget]
 267     HRESULT Parent( [out, retval] IDispatch **ppid );
 268
 269     [propget, id(DISPID_VALUE)]
 270     HRESULT Name( [out, retval] BSTR *pbs );
 271
 272     [propput, id(DISPID_VALUE)]
 273     HRESULT Name( [in] BSTR bs );
 274
 275     [propget]
 276     HRESULT Path( [out, retval] BSTR *pbs );
 277
 278     [propget]
 279     HRESULT GetLink( [out, retval] IDispatch **ppid );
 280
 281     [propget]
 282     HRESULT GetFolder( [out, retval] IDispatch **ppid );
 283
 284     [propget]
 285     HRESULT IsLink( [out, retval] VARIANT_BOOL *pb );
 286
 287     [propget]
 288     HRESULT IsFolder( [out, retval] VARIANT_BOOL *pb );
 289
 290     [propget]
 291     HRESULT IsFileSystem( [out, retval] VARIANT_BOOL *pb );
 292
 293     [propget]
 294     HRESULT IsBrowsable( [out, retval] VARIANT_BOOL *pb );
 295
 296     [propget]
 297     HRESULT ModifyDate( [out, retval] DATE *pdt );
 298
 299     [propput]
 300     HRESULT ModifyDate( [in] DATE dt );
 301
 302     [propget]
 303     HRESULT Size( [out, retval] LONG *pul );
 304
 305     [propget]
 306     HRESULT Type( [out, retval] BSTR *pbs );
 307
 308     HRESULT Verbs( [out, retval] FolderItemVerbs **ppfic );
 309
 310     HRESULT InvokeVerb( [in, optional] VARIANT vVerb );
 311 }
 312
 313 [
 314     object,
 315     uuid(edc817aa-92b8-11d1-b075-00c04fc33aa5),
 316     oleautomation,
 317     dual
 318 ]
 319 interface FolderItem2 : FolderItem
 320 {
 321     HRESULT InvokeVerbEx([in, optional] VARIANT verb, [in, optional] VARIANT args);
 322     HRESULT ExtendedProperty([in] BSTR propname, [out, retval] VARIANT *ret);
 323 }
 324
 325 /*****************************************************************************
 326  * FolderItems interface
 327  */
 328 [
 329     object,
 330     uuid(744129e0-cbe5-11ce-8350-444553540000),
 331     oleautomation,
 332     dual
 333 ]
 334 interface FolderItems : IDispatch
 335 {
 336     [propget]
 337     HRESULT Count( [out, retval] long *plCount );
 338
 339     [propget]
 340     HRESULT Application( [out, retval] IDispatch **ppid );
 341
 342     [propget]
 343     HRESULT Parent( [out, retval] IDispatch **ppid );
 344
 345     HRESULT Item( [in, optional] VARIANT index,
 346         [out, retval] FolderItem **ppid );
 347
 348     [id(DISPID_NEWENUM)]
 349     HRESULT _NewEnum( [out, retval] IUnknown **ppunk );
 350 }
 351
 352 /*****************************************************************************
 353  * FolderItemVerb interface
 354  */
 355 [
 356     object,
 357     uuid(08ec3e00-50b0-11cf-960c-0080c7f4ee85),
 358     oleautomation,
 359     dual
 360 ]
 361 interface FolderItemVerb : IDispatch
 362 {
 363     [propget]
 364     HRESULT Application( [out, retval] IDispatch **ppid );
 365
 366     [propget]
 367     HRESULT Parent( [out, retval] IDispatch **ppid );
 368
 369     [propget, id(DISPID_VALUE)]
 370     HRESULT Name( [out, retval] BSTR *pbs );
 371
 372     HRESULT DoIt();
 373 }
 374
 375 /*****************************************************************************
 376  * FolderItemVerbs interface
 377  */
 378 [
 379     object,
 380     uuid(1f8352c0-50b0-11cf-960c-0080c7f4ee85),
 381     oleautomation,
 382     dual
 383 ]
 384 interface FolderItemVerbs : IDispatch
 385 {
 386     [propget]
 387     HRESULT Count( [out, retval] long *plCount );
 388
 389     [propget]
 390     HRESULT Application( [out, retval] IDispatch **ppid );
 391
 392     [propget]
 393     HRESULT Parent( [out, retval] IDispatch **ppid );
 394
 395     HRESULT Item( [in, optional] VARIANT index,
 396         [out, retval] FolderItemVerb **ppid );
 397
 398     [id(DISPID_NEWENUM)]
 399     HRESULT _NewEnum( [out, retval] IUnknown **ppunk );
 400 }
 401
 402 /*****************************************************************************
 403  * IShellDispatch interface
 404  */
 405 [
 406     object,
 407     uuid(d8f015c0-c278-11ce-a49e-444553540000),
 408     oleautomation,
 409     hidden,
 410     dual
 411 ]
 412 interface IShellDispatch : IDispatch
 413 {
 414     [propget]
 415     HRESULT Application( [out, retval] IDispatch **ppid );
 416
 417     [propget]
 418     HRESULT Parent( [out, retval] IDispatch **ppid );
 419
 420     HRESULT NameSpace( [in] VARIANT vDir, [out, retval] Folder **ppsdf );
 421
 422     HRESULT BrowseForFolder( [in] long Hwnd,
 423         [in] BSTR Title,
 424         [in] long Options,
 425         [in, optional] VARIANT RootFolder,
 426         [out, retval] Folder **ppsdf );
 427
 428     HRESULT Windows( [out, retval] IDispatch **ppid );
 429
 430     HRESULT Open( [in] VARIANT vDir );
 431
 432     HRESULT Explore( [in] VARIANT vDir );
 433
 434     HRESULT MinimizeAll();
 435
 436     HRESULT UndoMinimizeALL();
 437
 438     HRESULT FileRun();
 439
 440     HRESULT CascadeWindows();
 441
 442     HRESULT TileVertically();
 443
 444     HRESULT TileHorizontally();
 445
 446     HRESULT ShutdownWindows();
 447
 448     HRESULT Suspend();
 449
 450     HRESULT EjectPC();
 451
 452     HRESULT SetTime();
 453
 454     HRESULT TrayProperties();
 455
 456     HRESULT Help();
 457
 458     HRESULT FindFiles();
 459
 460     HRESULT FindComputer();
 461
 462     HRESULT RefreshMenu();
 463
 464     HRESULT ControlPanelItem( [in] BSTR szDir );
 465 }
 466
 467 [
 468     object,
 469     uuid(a4c6892c-3ba9-11d2-9dea-00c04fb16162),
 470     oleautomation,
 471     hidden,
 472     dual
 473 ]
 474 interface IShellDispatch2 : IShellDispatch
 475 {
 476     HRESULT IsRestricted([in] BSTR group, [in] BSTR restriction, [out, retval] long *value);
 477     HRESULT ShellExecute([in] BSTR file, [in, optional] VARIANT args, [in, optional] VARIANT dir,
 478         [in, optional] VARIANT op, [in, optional] VARIANT show);
 479     HRESULT FindPrinter([in, optional] BSTR name, [in, optional] BSTR location, [in, optional] BSTR model);
 480     HRESULT GetSystemInformation([in] BSTR name, [out, retval] VARIANT *ret);
 481     HRESULT ServiceStart([in] BSTR service, [in] VARIANT persistent, [out, retval] VARIANT *ret);
 482     HRESULT ServiceStop([in] BSTR service, [in] VARIANT persistent, [out, retval] VARIANT *ret);
 483     HRESULT IsServiceRunning([in] BSTR service, [out, retval] VARIANT *running);
 484     HRESULT CanStartStopService([in] BSTR service, [out, retval] VARIANT *ret);
 485     HRESULT ShowBrowserBar([in] BSTR clsid, [in] VARIANT show, [out, retval] VARIANT *ret);
 486 }
 487
 488 [
 489     object,
 490     uuid(177160ca-bb5a-411c-841d-bd38facdeaa0),
 491     oleautomation,
 492     hidden,
 493     dual
 494 ]
 495 interface IShellDispatch3 : IShellDispatch2
 496 {
 497     HRESULT AddToRecent([in] VARIANT file, [in, optional] BSTR category);
 498 }
 499
 500 [
 501     object,
 502     uuid(efd84b2d-4bcf-4298-be25-eb542a59fbda),
 503     oleautomation,
 504     hidden,
 505     dual
 506 ]
 507 interface IShellDispatch4 : IShellDispatch3
 508 {
 509     HRESULT WindowsSecurity();
 510     HRESULT ToggleDesktop();
 511     HRESULT ExplorerPolicy([in] BSTR policy, [out, retval] VARIANT *value);
 512     HRESULT GetSetting([in] long setting, [out,retval] VARIANT_BOOL *result);
 513 }
 514
 515 [
 516     object,
 517     uuid(866738b9-6cf2-4de8-8767-f794ebe74f4e),
 518     oleautomation,
 519     hidden,
 520     dual
 521 ]
 522 interface IShellDispatch5 : IShellDispatch4
 523 {
 524     HRESULT WindowSwitcher();
 525 }
 526
 527 [
 528     uuid(13709620-c279-11ce-a49e-444553540000)
 529 ]
 530 coclass Shell
 531 {
 532     [default] interface IShellDispatch2;
 533 }
 534
 535 [
 536     uuid(0a89a860-d7b1-11ce-8350-444553540000),
 537     hidden
 538 ]
 539 coclass ShellDispatchInproc
 540 {
 541     interface IUnknown;
 542 }
 543
 544 typedef
 545 [
 546     uuid(ca31ea20-48d0-11cf-8350-444553540000)
 547 ]
 548 enum ShellSpecialFolderConstants {
 549     ssfDESKTOP          = 0x00,
 550     ssfPROGRAMS         = 0x02,
 551     ssfCONTROLS         = 0x03,
 552     ssfPRINTERS         = 0x04,
 553     ssfPERSONAL         = 0x05,
 554     ssfFAVORITES        = 0x06,
 555     ssfSTARTUP          = 0x07,
 556     ssfRECENT           = 0x08,
 557     ssfSENDTO           = 0x09,
 558     ssfBITBUCKET        = 0x0a,
 559     ssfSTARTMENU        = 0x0b,
 560     ssfDESKTOPDIRECTORY = 0x10,
 561     ssfDRIVES           = 0x11,
 562     ssfNETWORK          = 0x12,
 563     ssfNETHOOD          = 0x13,
 564     ssfFONTS            = 0x14,
 565     ssfTEMPLATES        = 0x15,
 566     ssfCOMMONSTARTMENU  = 0x16,
 567     ssfCOMMONPROGRAMS   = 0x17,
 568     ssfCOMMONSTARTUP    = 0x18,
 569     ssfCOMMONDESKTOPDIR = 0x19,
 570     ssfAPPDATA          = 0x1a,
 571     ssfPRINTHOOD        = 0x1b,
 572     ssfLOCALAPPDATA     = 0x1c,
 573     ssfALTSTARTUP       = 0x1d,
 574     ssfCOMMONALTSTARTUP = 0x1e,
 575     ssfCOMMONFAVORITES  = 0x1f,
 576     ssfINTERNETCACHE    = 0x20,
 577     ssfCOOKIES          = 0x21,
 578     ssfHISTORY          = 0x22,
 579     ssfCOMMONAPPDATA    = 0x23,
 580     ssfWINDOWS          = 0x24,
 581     ssfSYSTEM           = 0x25,
 582     ssfPROGRAMFILES     = 0x26,
 583     ssfMYPICTURES       = 0x27,
 584     ssfPROFILE          = 0x28,
 585     ssfSYSTEMx86        = 0x29,
 586     ssfPROGRAMFILESx86  = 0x30
 587 } ShellSpecialFolderConstants;
 588
 589 } /* library Shell32 */
 590
 591 /*****************************************************************************
 592  * IAsyncOperation interface
 593  */
 594 [
 595     uuid(3d8b0590-f691-11d2-8ea9-006097df5bd4),
 596     object,
 597 ]
 598
 599 interface IAsyncOperation : IUnknown
 600 {
 601     typedef [unique] IAsyncOperation *LPASYNCOPERATION;
 602
 603     HRESULT SetAsyncMode([in] BOOL fDoOpAsync);
 604
 605     HRESULT GetAsyncMode([out] BOOL *pfIsOpAsync);
 606
 607     HRESULT StartOperation([in, unique, optional] IBindCtx *pbcReserved);
 608
 609     HRESULT InOperation([out] BOOL *pfInAsyncOp);
 610
 611     HRESULT EndOperation(
 612             [in] HRESULT hResult,
 613             [in, unique] IBindCtx *pbcReserved,
 614             [in] DWORD dwEffects);
 615 }