home *** CD-ROM | disk | FTP | other *** search
/ ...taking it to the Macs! / ...taking it to the Macs!.iso / Extras / ActiveX Mac SDK / ActiveX SDK / Headers / OLE2.H < prev    next >
Encoding:
C/C++ Source or Header  |  1996-09-02  |  54.7 KB  |  1,631 lines  |  [TEXT/????]
  1. /*****************************************************************************\
  2. *                                                                             *
  3. * ole2.h -         Main OLE2 header; includes all subcomponents                  *
  4. *                                                                             *
  5. *               OLE Version 2.0                                               *
  6. *                                                                             *
  7. *               Copyright (c) 1992-1994, Microsoft Corp. All rights reserved. *
  8. *                                                                             *
  9. \*****************************************************************************/
  10.  
  11.  
  12. #if !defined(__OLE2__) && !defined(_OLE2_H_)
  13. #define __OLE2__
  14. #define _OLE2_H_
  15.  
  16.  
  17. #ifdef WLM
  18. #include "macname1.h"
  19. #define WINGS
  20.  
  21. #endif // WLM
  22.  
  23.  
  24. #if !defined(__MACPUB__)
  25. #include <macpub.h>
  26. #endif
  27.  
  28.  
  29. /****** Standard Object Definitions *****************************************/
  30.  
  31. #ifndef __COMPOBJ__
  32. #include <compobj.h>
  33. #endif
  34.  
  35.  
  36. // *************** FACILITY_ITF scodes common to all interfaces ************
  37. //
  38. // By convention, OLE interfaces divide the FACILITY_ITF range of errors
  39. // into nonoverlapping subranges.  If an interface returns a FACILITY_ITF 
  40. // scode, it must be from the range associated with that interface or from
  41. // the shared range: OLE_E_FIRST...OLE_E_LAST.
  42. //
  43.  
  44. // error codes
  45.  
  46. #define OLE_E_OLEVERB               (OLE_E_FIRST)
  47. // invalid OLEVERB structure  
  48.  
  49. #define OLE_E_ADVF                  (OLE_E_FIRST+1)
  50. // invalid advise flags
  51.  
  52. #define OLE_E_ENUM_NOMORE           (OLE_E_FIRST+2)
  53. // you can't enuemrate any more, because the associated data is missing
  54.  
  55. #define OLE_E_ADVISENOTSUPPORTED    (OLE_E_FIRST+3)
  56. // this implementation doesn't take advises
  57.  
  58. #define OLE_E_NOCONNECTION          (OLE_E_FIRST+4)
  59. // there is no connection for this connection id
  60.  
  61. #define OLE_E_NOTRUNNING            (OLE_E_FIRST+5)
  62. // need run the object to perform this operation
  63.  
  64. #define OLE_E_NOCACHE               (OLE_E_FIRST+6)
  65. // there is no cache to operate on
  66.  
  67. #define OLE_E_BLANK                 (OLE_E_FIRST+7)
  68. // Uninitialized object
  69.  
  70. #define OLE_E_CLASSDIFF             (OLE_E_FIRST+8)
  71. // linked object's source class has changed 
  72.  
  73. #define OLE_E_CANT_GETMONIKER       (OLE_E_FIRST+9)
  74. // not able to get the moniker of the object
  75.  
  76. #define OLE_E_CANT_BINDTOSOURCE     (OLE_E_FIRST+10)
  77. // not able to bind to the source
  78.  
  79. #define OLE_E_STATIC                (OLE_E_FIRST+11)
  80. // object is static, operation not allowed
  81.  
  82. #define OLE_E_PROMPTSAVECANCELLED   (OLE_E_FIRST+12)
  83. // user cancelled out of save dialog
  84.  
  85. #define OLE_E_INVALIDRECT            (OLE_E_FIRST+13)
  86. // invalid rectangle 
  87.  
  88. #define OLE_E_WRONGCOMPOBJ          (OLE_E_FIRST+14)
  89. // compobj.dll is too old for the ole2.dll initialized
  90.  
  91. #define OLE_E_INVALIDHWND           (OLE_E_FIRST+15)
  92. // invalid window handle
  93.  
  94. #define OLE_E_NOT_INPLACEACTIVE     (OLE_E_FIRST+16)
  95. // object is not in any of the inplace active states  
  96.  
  97. #define OLE_E_CANTCONVERT            (OLE_E_FIRST+17)
  98. // not able to convert the object 
  99.  
  100. #define OLE_E_NOSTORAGE                (OLE_E_FIRST+18)
  101. // not able to perform the operation because object is not given storage yet.
  102.  
  103. typedef enum {
  104.     OLE_E_NOEXTENSION    = OLE_E_NOSTORAGE +1,    // no extension at startup
  105.     OLE_E_VERSEXTENSION,                        // extension has wrong version #
  106.     OLE_E_IPBUSY,                                // cannot get inplace resource
  107.     OLE_E_NOT_FRONT_PROCESS,                    // inplace container unexpectedly in background
  108.     OLE_E_WRONG_MENU,                            // holemenu != prev holemenu
  109.     OLE_E_MENU_NOT_PATCHED,                        // menubar is not hashed
  110.     OLE_E_MENUID_NOT_HASHED,                    // id was never hashed
  111.     OLE_E_foo
  112. } inplace_errors;
  113.  
  114.  
  115.  
  116.  
  117. #define DVGEN_E_FIRST               (OLE_E_FIRST+100)
  118.  
  119. #define DV_E_FORMATETC              (DVGEN_E_FIRST)
  120. // invalid FORMATETC structure
  121.  
  122. #define DV_E_DVTARGETDEVICE         (DVGEN_E_FIRST+1)
  123. // invalid DVTARGETDEVICE structure
  124.  
  125. #define DV_E_STGMEDIUM              (DVGEN_E_FIRST+2)
  126. // invalid STDGMEDIUM structure
  127.  
  128. #define DV_E_STATDATA               (DVGEN_E_FIRST+3)
  129. // invalid STATDATA structure
  130.  
  131. #define DV_E_LINDEX                 (DVGEN_E_FIRST+4)
  132. // invalid lindex
  133.  
  134. #define DV_E_TYMED                  (DVGEN_E_FIRST+5)
  135. // invalid tymed
  136.  
  137. #define DV_E_CLIPFORMAT             (DVGEN_E_FIRST+6)
  138. // invalid clipboard format
  139.  
  140. #define DV_E_DVASPECT               (DVGEN_E_FIRST+7)
  141. // invalid aspect(s) 
  142.  
  143. #define DV_E_DVTARGETDEVICE_SIZE    (DVGEN_E_FIRST+8)
  144. // tdSize paramter of the DVTARGETDEVICE structure is invalid
  145.  
  146. #define DV_E_NOIVIEWOBJECT          (DVGEN_E_FIRST+9)
  147. // object doesn't support IViewObject interface
  148.  
  149.  
  150. // Success codes
  151.  
  152. #define OLE_S_USEREG                (OLE_S_FIRST)
  153. // use the reg database to provide the requested info
  154.  
  155. #define OLE_S_STATIC                (OLE_S_FIRST+1)
  156. // success, but static 
  157.  
  158. #define OLE_S_MAC_CLIPFORMAT        (OLE_S_FIRST+2)
  159. // macintosh clipboard format
  160.  
  161. #define OLE_S_WIN_CLIPFORMAT        (OLE_S_FIRST+3)
  162. // macintosh clipboard format
  163.  
  164. //*************************** Interface or API specific scodes *************
  165.  
  166. // Errors for OleConvertOLESTREAMToIStorage and OleConvertIStorageToOLESTREAM
  167.  
  168. // OLESTREAM Get method failed
  169. #define CONVERT10_E_OLESTREAM_GET       (CONVERT10_E_FIRST + 0)
  170.  
  171. // OLESTREAM Put method failed
  172. #define CONVERT10_E_OLESTREAM_PUT       (CONVERT10_E_FIRST + 1)
  173.  
  174. // Contents of the OLESTREAM not in correct format
  175. #define CONVERT10_E_OLESTREAM_FMT       (CONVERT10_E_FIRST + 2)
  176.  
  177. // There was in an error in a Windows GDI call while converting the bitmap
  178. // to a DIB.
  179. #define CONVERT10_E_OLESTREAM_BITMAP_TO_DIB (CONVERT10_E_FIRST + 3)
  180.  
  181. // Contents of the IStorage not in correct format
  182. #define CONVERT10_E_STG_FMT             (CONVERT10_E_FIRST + 4)
  183.  
  184. // Contents of IStorage is missing one of the standard streams ("\1CompObj", 
  185. // "\1Ole", "\2OlePres000").  This may be the storage for a DLL object, or a
  186. // class that does not use the def handler.
  187. #define CONVERT10_E_STG_NO_STD_STREAM   (CONVERT10_E_FIRST + 5)
  188.  
  189. // There was in an error in a Windows GDI call while converting the DIB
  190. // to a bitmap.
  191. #define CONVERT10_E_STG_DIB_TO_BITMAP   (CONVERT10_E_FIRST + 6)
  192.  
  193.  
  194. // Returned by either API, this scode indicates that the original object
  195. //  had no presentation, therefore the converted object does not either.
  196. #define CONVERT10_S_NO_PRESENTATION     (CONVERT10_S_FIRST + 0)
  197.  
  198.  
  199. // Errors for Clipboard functions
  200.  
  201. // OpenClipboard Failed
  202. #define CLIPBRD_E_CANT_OPEN     (CLIPBRD_E_FIRST + 0)
  203.  
  204. // EmptyClipboard Failed
  205. #define CLIPBRD_E_CANT_EMPTY        (CLIPBRD_E_FIRST + 1)
  206.  
  207. // SetClipboard Failed
  208. #define CLIPBRD_E_CANT_SET          (CLIPBRD_E_FIRST + 2)
  209.  
  210. // Data on clipboard is invalid
  211. #define CLIPBRD_E_BAD_DATA          (CLIPBRD_E_FIRST + 3)
  212.  
  213. // CloseClipboard Failed
  214. #define CLIPBRD_E_CANT_CLOSE        (CLIPBRD_E_FIRST + 4)
  215.  
  216.  
  217. /****** OLE value types *****************************************************/
  218.  
  219. /* rendering options */
  220. typedef enum tagOLERENDER
  221. {
  222.     OLERENDER_NONE   = 0, 
  223.     OLERENDER_DRAW   = 1, 
  224.     OLERENDER_FORMAT = 2,
  225.     OLERENDER_ASIS   = 3
  226.  
  227.     ,OLERENDER_FORCELONG    =    2147483647
  228. } OLERENDER;
  229. typedef  OLERENDER * LPOLERENDER;
  230.  
  231. // OLE verb; returned by IEnumOLEVERB
  232. typedef struct FARSTRUCT tagOLEVERB
  233. {
  234.     long    lVerb;
  235.     char *   lpszVerbName;
  236.     unsigned long   fuFlags;
  237.     unsigned long grfAttribs;
  238. } OLEVERB, * LPOLEVERB;
  239.  
  240.  
  241. // Bitwise verb attributes used in OLEVERB.grfAttribs
  242. typedef enum tagOLEVERBATTRIB // bitwise
  243. {
  244.     OLEVERBATTRIB_NEVERDIRTIES = 1,
  245.     OLEVERBATTRIB_ONCONTAINERMENU = 2
  246.  
  247.     ,OLEVERBATTRIB_FORCELONG    =    2147483647
  248. } OLEVERBATTRIB;
  249.  
  250.  
  251. // IOleObject::GetUserType optons; determines which form of the string to use
  252. typedef enum tagUSERCLASSTYPE
  253. {
  254.     USERCLASSTYPE_FULL = 1,
  255.     USERCLASSTYPE_SHORT= 2,
  256.     USERCLASSTYPE_APPNAME= 3
  257.     ,USERCLASSTYPE_FORCELONG    =    2147483647
  258. } USERCLASSTYPE;
  259.  
  260.  
  261. // bits returned from IOleObject::GetMistStatus
  262. typedef enum tagOLEMISC // bitwise
  263. {
  264.     OLEMISC_RECOMPOSEONRESIZE = 1,
  265.     OLEMISC_ONLYICONIC        = 2,
  266.     OLEMISC_INSERTNOTREPLACE  = 4,
  267.     OLEMISC_STATIC            = 8,
  268.     OLEMISC_CANTLINKINSIDE    = 16,
  269.     OLEMISC_CANLINKBYOLE1       = 32,
  270.     OLEMISC_ISLINKOBJECT        = 64,
  271.     OLEMISC_INSIDEOUT           = 128,
  272.     OLEMISC_ACTIVATEWHENVISIBLE = 256       
  273.     ,OLEMISC_FORCELONG    =    2147483647
  274. } OLEMISC;
  275.  
  276.  
  277. // IOleObject::Close options
  278. typedef enum tagOLECLOSE
  279. {
  280.     OLECLOSE_SAVEIFDIRTY = 0,
  281.     OLECLOSE_NOSAVE      = 1,
  282.     OLECLOSE_PROMPTSAVE  = 2
  283.     ,OLECLOSE_FORCELONG    =    2147483647
  284. } OLECLOSE;
  285.  
  286.  
  287. // IOleObject::GetMoniker and IOleClientSite::GetMoniker options; determines
  288. // if and how monikers should be assigned.
  289. typedef enum tagOLEGETMONIKER
  290. {
  291.     OLEGETMONIKER_ONLYIFTHERE=1,
  292.     OLEGETMONIKER_FORCEASSIGN=2,
  293.     OLEGETMONIKER_UNASSIGN=3,
  294.     OLEGETMONIKER_TEMPFORUSER=4 
  295.     ,OLEGETMONIKER_FORCELONG    =    2147483647
  296. } OLEGETMONIKER;
  297.  
  298.  
  299. // IOleObject::GetMoniker, IOleObject::SetMoniker and 
  300. // IOleClientSite::GetMoniker options; determines which moniker to use
  301. typedef enum tagOLEWHICHMK
  302. {
  303.     OLEWHICHMK_CONTAINER=1,
  304.     OLEWHICHMK_OBJREL=2,
  305.     OLEWHICHMK_OBJFULL=3
  306.     ,OLEWHICHMK_FORCELONG    =    2147483647
  307. } OLEWHICHMK;
  308.  
  309.  
  310.  
  311. #ifndef _WINDEF_
  312.  
  313. typedef struct FARSTRUCT tagSIZEL
  314. {
  315.     long cx;
  316.     long cy;
  317. } SIZEL;
  318.  
  319. typedef struct FARSTRUCT tagRECTL
  320. {
  321.     long    left;
  322.     long    top;
  323.     long    right;
  324.     long    bottom;
  325. } RECTL;
  326.  
  327. typedef struct FARSTRUCT tagPOINTL {
  328.     long x;
  329.     long y;
  330. } POINTL;
  331.  
  332. #endif
  333.  
  334. typedef SIZEL * LPSIZEL;
  335. typedef RECTL * LPRECTL;
  336.  
  337.  
  338.  
  339. #ifndef LPCRECT
  340. typedef const Rect * LPCRECT;
  341. #endif
  342.  
  343. #ifndef LPCRECTL
  344. typedef const RECTL * LPCRECTL;
  345. #endif
  346.  
  347. // for OleCreateEmbeddingHelper flags; roles in low word; options in high word
  348. #define EMBDHLP_INPROC_HANDLER   0x0000L // role is handler; implementation is 
  349.                                          // default handler; pCF can be NULL
  350. #define EMBDHLP_INPROC_SERVER    0x0001L // role is server; pCF can't be NULL
  351.  
  352. #define EMBDHLP_CREATENOW    0x00000000L // create using pCF immediately; if pCF
  353.                                          // is NULL, uses std remoting handler
  354. #define EMBDHLP_DELAYCREATE  0x00010000L // delayed create; must supply pCF
  355.  
  356.  
  357. // NOTE: OleCreateEmbeddingHelper(clsid, pUnkOuter, 
  358. //         EMBDHLP_INPROC_HANDLER | EMBDHLP_CREATENOW, NULL, riid, lplpObj) 
  359. // is the same as OleCreateDefaultHandler(clsid, pUnkOuter, riid, lplpObj);
  360. // i.e., the embedding helper is the default handler in various roles.
  361.  
  362.  
  363. /***** OLE 1.0 OLESTREAM declarations *************************************/
  364.  
  365. typedef struct _OLESTREAM *  LPOLESTREAM;
  366.  
  367. typedef struct _OLESTREAMVTBL
  368. {
  369. #ifndef _MSC_VER
  370.     pascal unsigned long (* Get)(LPOLESTREAM, void *, unsigned long);
  371.     pascal unsigned long (* Put)(LPOLESTREAM, const void *, unsigned long);
  372. #else
  373.     unsigned long ( __pascal * Get)(LPOLESTREAM, void *, unsigned long);
  374.     unsigned long ( __pascal * Put)(LPOLESTREAM, const void *, unsigned long);
  375. #endif
  376. } OLESTREAMVTBL;
  377. typedef  OLESTREAMVTBL *  LPOLESTREAMVTBL;
  378.  
  379. typedef struct _OLESTREAM
  380. {
  381.     LPOLESTREAMVTBL lpstbl;
  382. } OLESTREAM;
  383.  
  384.  
  385. /****** Clipboard Data structures *****************************************/
  386.  
  387. typedef struct tagOBJECTDESCRIPTOR
  388. {
  389.     unsigned long    cbSize;             // Size of structure in bytes
  390.     CLSID            clsid;                // CLSID of data being transferred
  391.     unsigned long    dwDrawAspect;          // Display aspect of the object
  392.                                         //     normally DVASPECT_CONTENT or ICON.
  393.                                         //     dwDrawAspect will be 0 (which is NOT
  394.                                         //     DVASPECT_CONTENT) if the copier or 
  395.                                         //     dragsource didn't draw the object to 
  396.                                         //     begin with.
  397.     SIZEL            sizel;               // size of the object in HIMETRIC
  398.                                         //    sizel is opt.: will be (0,0) for apps
  399.                                         //    which don't draw the object being
  400.                                         //    transferred
  401.     unsigned long    dwOutline;            // Offset from beginning of structure to
  402.                                         //    Region describing outline of object
  403.                                         //    Like sizel, this is only defined for
  404.                                         //    drawable objects, else it is zero.
  405.                                         //      To turn this data at this offset into
  406.                                         //      a region handle, allocate a handle
  407.                                         //    the size of the first word of the region data
  408.                                         //      and then copy those n bytes into the handle
  409.                                         //      (including the first word)
  410.                                         //            char *p = ((char*) pOD) + pOD->dwOutline; // ptr to region data
  411.                                         //            short size = *(short *) p;
  412.                                         //            h = NewHandle(size);
  413.                                         //            BlockMove(p, *h, size);
  414.     POINTL           pointl;                // Offset in HIMETRIC units from the
  415.                                         //    upper-left corner of the obj where the
  416.                                         //    mouse went down for the drag.
  417.                                         //    NOTE: y coordinates increase downward.
  418.                                         //          x coordinates increase to right
  419.                                         //    pointl is opt.; it is only meaningful 
  420.                                         //    if object is transfered via drag/drop.
  421.                                          //    (0, 0) if mouse position is unspecified
  422.                                         //    (eg. when obj transfered via clipboard)
  423.     unsigned long    dwStatus;             // Misc. status flags for object. Flags are 
  424.                                          //    defined by OLEMISC enum. these flags 
  425.                                         //    are as would be returned
  426.                                          //    by IOleObject::GetMiscStatus.
  427.     unsigned long    dwFullUserTypeName;    // Offset from beginning of structure to 
  428.                                         //    null-terminated string that specifies 
  429.                                         //    Full User Type Name of the object. 
  430.                                         //    0 indicates string not present.
  431.     unsigned long    dwSrcOfCopy;           // Offset from beginning of structure to 
  432.                                         //    null-terminated string that specifies
  433.                                         //    source of the transfer. 
  434.                                         //    dwSrcOfCOpy is normally implemented as 
  435.                                         //    the display name of the temp-for-user 
  436.                                         //    moniker which identifies the source of 
  437.                                         //    the data. 
  438.                                         //    0 indicates string not present.
  439.                                         //    NOTE: moniker assignment is NOT forced.
  440.                                         //    see IOleObject::GetMoniker(
  441.                                         //                OLEGETMONIKER_TEMPFORUSER)
  442.     unsigned long    dwExtra;            // must be null
  443.  /* variable sized string data may appear here */
  444.  
  445. } OBJECTDESCRIPTOR,  *POBJECTDESCRIPTOR,   *LPOBJECTDESCRIPTOR,
  446.   LINKSRCDESCRIPTOR, *PLINKSRCDESCRIPTOR,  *LPLINKSRCDESCRIPTOR;
  447.  
  448.  
  449.  
  450. /* verbs */
  451. #define OLEIVERB_PRIMARY     (0L)
  452. #define OLEIVERB_SHOW        (-1L)
  453. #define OLEIVERB_OPEN        (-2L)
  454. #define OLEIVERB_HIDE        (-3L)
  455. #define OLEIVERB_UIACTIVATE         (-4L)
  456. #define OLEIVERB_INPLACEACTIVATE    (-5L)
  457. #define OLEIVERB_DISCARDUNDOSTATE   (-6L)
  458.  
  459.  
  460. //      forward type declarations
  461. #if defined(__cplusplus)
  462. interface IOleClientSite;
  463. interface IOleContainer;
  464. interface IOleObject;
  465. #else 
  466. //typedef interface IOleClientSite IOleClientSite;
  467. //typedef interface IOleContainer IOleContainer;
  468. //typedef interface IOleObject IOleObject;
  469. #endif
  470.  
  471. typedef   interface IOleObject * LPOLEOBJECT, ** LPLPOLEOBJECT;
  472. typedef   interface IOleClientSite * LPOLECLIENTSITE, ** LPLPOLECLIENTSITE;
  473. typedef   interface IOleContainer * LPOLECONTAINER, ** LPLPOLECONTAINER;
  474.  
  475.  
  476. /****** OLE GUIDs *********************************************************/
  477.  
  478. #ifndef INITGUID
  479. #include "oleguid.h"
  480. #endif
  481.  
  482.  
  483. /****** Other Major Interfaces ********************************************/
  484.  
  485. #ifndef __DVOBJ__
  486. #include <dvobj.h>
  487. #endif
  488.  
  489. #ifndef __STORAGE__
  490. #include <storage.h>
  491. #endif
  492.  
  493.  
  494.  
  495. /****** IDrop??? Interfaces ********************************************/
  496.  
  497.  
  498.  
  499. #define DROPEFFECT_NONE     0
  500. #define DROPEFFECT_COPY     1
  501. #define DROPEFFECT_MOVE     2
  502. #define DROPEFFECT_LINK     4
  503. #define DROPEFFECT_SCROLL   0x80000000
  504.  
  505. // default inset-width of the hot zone, in pixels
  506. #define DD_DEFSCROLLINSET 15
  507.  
  508. // default delay before scrolling, in ticks (sixtieths of a second)
  509. // Better is to use GetDblTime()
  510. #define DD_DEFSCROLLDELAY        10
  511.  
  512. // default scroll interval, in ticks
  513. #define DD_DEFSCROLLINTERVAL    2
  514.  
  515. // default delay before dragging should start, in ticks
  516. #define DD_DEFDRAGDELAY         10
  517.  
  518. // default minimum distance (radius) before dragging should start, in pixels
  519. #define DD_DEFDRAGMINDIST        2
  520.  
  521.  
  522.  
  523. /* Dragdrop specific error codes */
  524.  
  525. #define    DRAGDROP_E_NOTREGISTERED        (DRAGDROP_E_FIRST)
  526. // trying to revoke a drop target that has not been registered 
  527.  
  528. #define    DRAGDROP_E_ALREADYREGISTERED    (DRAGDROP_E_FIRST+1)
  529. // this window has already been registered as a drop target
  530.  
  531. #define DRAGDROP_E_INVALIDHWND            (DRAGDROP_E_FIRST+2)
  532. // invalid Handle
  533.  
  534.  
  535. #define DRAGDROP_S_DROP                 (DRAGDROP_S_FIRST + 0)
  536. // successful drop took place 
  537.  
  538. #define DRAGDROP_S_CANCEL               (DRAGDROP_S_FIRST + 1)
  539. // drag-drop operation canceled
  540.  
  541. #define DRAGDROP_S_USEDEFAULTCURSORS    (DRAGDROP_S_FIRST + 2)
  542. // use the default cursor
  543.  
  544.  
  545. #undef INTERFACE
  546. #define INTERFACE   IDropTarget
  547.  
  548.  
  549. DECLARE_INTERFACE_(IDropTarget, IUnknown)
  550. {
  551.     BEGIN_INTERFACE
  552.     // *** IUnknown methods ***
  553.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  554.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  555.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  556.  
  557.     // *** IDropTarget methods ***
  558.     STDMETHOD(DragEnter) (THIS_ LPDATAOBJECT pDataObj, 
  559.                 unsigned long grfKeyState, POINTL pt, 
  560.                 unsigned long    * pdwEffect) PURE;
  561.     STDMETHOD(DragOver) (THIS_ unsigned long grfKeyState, POINTL pt, unsigned long    * pdwEffect) PURE;
  562.     STDMETHOD(DragLeave) (THIS) PURE;
  563.     STDMETHOD(Drop) (THIS_ LPDATAOBJECT pDataObj, unsigned long grfKeyState, POINTL pt, unsigned long    * pdwEffect) PURE;
  564. };
  565. typedef         IDropTarget * LPDROPTARGET, ** LPLPDROPTARGET;
  566.  
  567.  
  568.  
  569. #undef INTERFACE
  570. #define INTERFACE   IDropSource
  571.  
  572. DECLARE_INTERFACE_(IDropSource, IUnknown)
  573. {
  574.     BEGIN_INTERFACE
  575.     // *** IUnknown methods ***
  576.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  577.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  578.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  579.  
  580.     // *** IDropSource methods ***
  581.     STDMETHOD(QueryContinueDrag) (THIS_ unsigned long fEscapePressed, unsigned long grfKeyState) PURE;
  582.     STDMETHOD(GiveFeedback) (THIS_ unsigned long dwEffect) PURE;
  583. };
  584. typedef         IDropSource * LPDROPSOURCE, ** LPLPDROPSOURCE;
  585.  
  586.  
  587.  
  588. /****** IPersist??? Interfaces ********************************************/
  589.  
  590.  
  591. #undef INTERFACE
  592. #define INTERFACE   IPersist
  593.  
  594. DECLARE_INTERFACE_(IPersist, IUnknown)
  595. {
  596.     BEGIN_INTERFACE
  597.     // *** IUnknown methods ***
  598.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  599.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  600.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  601.  
  602.     // *** IPersist methods ***
  603.     STDMETHOD(GetClassID) (THIS_ LPCLSID lpClassID) PURE;
  604. };
  605. typedef            IPersist * LPPERSIST, ** LPLPPERSIST;
  606.  
  607.  
  608.  
  609. #undef INTERFACE
  610. #define INTERFACE   IPersistStorage
  611.  
  612. DECLARE_INTERFACE_(IPersistStorage, IPersist)
  613. {
  614.     BEGIN_INTERFACE
  615.     // *** IUnknown methods ***
  616.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  617.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  618.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  619.  
  620.     // *** IPersist methods ***
  621.     STDMETHOD(GetClassID) (THIS_ LPCLSID lpClassID) PURE;
  622.  
  623.     // *** IPersistStorage methods ***
  624.     STDMETHOD(IsDirty) (THIS) PURE;
  625.     STDMETHOD(InitNew) (THIS_ LPSTORAGE pStg) PURE;
  626.     STDMETHOD(Load) (THIS_ LPSTORAGE pStg) PURE;
  627.     STDMETHOD(Save) (THIS_ LPSTORAGE pStgSave, unsigned long fSameAsLoad) PURE;
  628.     STDMETHOD(SaveCompleted) (THIS_ LPSTORAGE pStgNew) PURE;
  629.     STDMETHOD(HandsOffStorage) (THIS) PURE; 
  630. };
  631. typedef         IPersistStorage * LPPERSISTSTORAGE, ** LPLPPERSISTSTORAGE;
  632.  
  633.  
  634.  
  635. #undef INTERFACE
  636. #define INTERFACE   IPersistStream
  637.  
  638. DECLARE_INTERFACE_(IPersistStream, IPersist)
  639. {
  640.     BEGIN_INTERFACE
  641.     // *** IUnknown methods ***
  642.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  643.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  644.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  645.  
  646.     // *** IPersist methods ***
  647.     STDMETHOD(GetClassID) (THIS_ LPCLSID lpClassID) PURE;
  648.  
  649.     // *** IPersistStream methods ***
  650.     STDMETHOD(IsDirty) (THIS) PURE;
  651.     STDMETHOD(Load) (THIS_ LPSTREAM pStm) PURE;
  652.     STDMETHOD(Save) (THIS_ LPSTREAM pStm,
  653.                     unsigned long fClearDirty) PURE;
  654.     STDMETHOD(GetSizeMax) (THIS_ ULARGE_INTEGER  * pcbSize) PURE;
  655. };
  656. typedef          IPersistStream * LPPERSISTSTREAM, ** LPLPPERSISTSTREAM;
  657.  
  658.  
  659.  
  660. #undef INTERFACE
  661. #define INTERFACE   IPersistFile
  662.  
  663. DECLARE_INTERFACE_(IPersistFile, IPersist)
  664. {
  665.     BEGIN_INTERFACE
  666.     // *** IUnknown methods ***
  667.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  668.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  669.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  670.     
  671.     // *** IPersist methods ***
  672.     STDMETHOD(GetClassID) (THIS_ LPCLSID lpClassID) PURE;
  673.     
  674.     // *** IPersistFile methods ***
  675.     STDMETHOD(IsDirty) (THIS) PURE;
  676.     STDMETHOD(Load) (THIS_ const char * lpszFileName, unsigned long grfMode) PURE;
  677.     STDMETHOD(Save) (THIS_ const char * lpszFileName, unsigned long fRemember) PURE;
  678.     STDMETHOD(SaveCompleted) (THIS_ const char * lpszFileName) PURE;
  679.     STDMETHOD(GetCurFile) (THIS_ char *  * lplpszFileName) PURE;
  680.  
  681.      STDMETHOD(LoadFSP) (THIS_ const FSSpec *pFSSpec, unsigned long grfMode) PURE;
  682.     STDMETHOD(SaveFSP) (THIS_ const FSSpec *pFSSpec, unsigned long fRemember) PURE;
  683.     STDMETHOD(SaveCompletedFSP) (THIS_ const FSSpec *pFSSpec) PURE;
  684.     STDMETHOD(GetCurFSP) (THIS_ FSSpec *pFSSpec) PURE; 
  685. };
  686. typedef            IPersistFile * LPPERSISTFILE, ** LPLPPERSISTFILE;
  687.  
  688.   
  689. /****** Moniker Object Interfaces ******************************************/
  690.  
  691. #ifndef __MONIKER__
  692. #include <moniker.h>
  693. #endif
  694.  
  695.  
  696. /****** OLE Object Interfaces ******************************************/
  697.   
  698.  
  699. #undef  INTERFACE
  700. #define INTERFACE   IEnumOLEVERB
  701.  
  702. DECLARE_INTERFACE_(IEnumOLEVERB, IUnknown)
  703. {
  704.     BEGIN_INTERFACE
  705.     // *** IUnknown methods ***
  706.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  707.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  708.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  709.  
  710.     // *** IEnumOLEVERB methods ***
  711.     STDMETHOD(Next) (THIS_ unsigned long celt, LPOLEVERB rgelt, unsigned long * pceltFetched) PURE;
  712.     STDMETHOD(Skip) (THIS_ unsigned long celt) PURE;
  713.     STDMETHOD(Reset) (THIS) PURE;
  714.     STDMETHOD(Clone) (THIS_ IEnumOLEVERB * * ppenm) PURE;
  715. };
  716. typedef         IEnumOLEVERB * LPENUMOLEVERB, ** LPLPENUMOLEVERB;
  717.  
  718.  
  719.  
  720.  
  721. #undef  INTERFACE
  722. #define INTERFACE   IOleObject
  723.  
  724. #define OLEOBJ_E_NOVERBS                (OLEOBJ_E_FIRST + 0)
  725.  
  726. #define OLEOBJ_E_INVALIDVERB            (OLEOBJ_E_FIRST + 1)
  727.  
  728. #define OLEOBJ_S_INVALIDVERB            (OLEOBJ_S_FIRST + 0)
  729.  
  730. #define OLEOBJ_S_CANNOT_DOVERB_NOW      (OLEOBJ_S_FIRST + 1)
  731. // verb number is valid but verb cannot be done now, for instance
  732. // hiding a link or hiding a visible OLE 1.0 server
  733.  
  734. #define OLEOBJ_S_INVALIDHWND            (OLEOBJ_S_FIRST + 2)
  735. // invalid hwnd passed
  736.  
  737.  
  738. DECLARE_INTERFACE_(IOleObject, IUnknown)
  739. {
  740.     BEGIN_INTERFACE
  741.     // *** IUnknown methods ***
  742.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  743.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  744.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  745.  
  746.     // *** IOleObject methods ***
  747.     STDMETHOD(SetClientSite) (THIS_ LPOLECLIENTSITE pClientSite) PURE;
  748.     STDMETHOD(GetClientSite) (THIS_ LPLPOLECLIENTSITE ppClientSite) PURE;
  749.     STDMETHOD(SetHostNames) (THIS_ const char * szContainerApp, const char * szContainerObj) PURE;
  750.     STDMETHOD(Close) (THIS_ unsigned long dwSaveOption) PURE;
  751.     STDMETHOD(SetMoniker) (THIS_ unsigned long dwWhichMoniker, LPMONIKER pmk) PURE;
  752.     STDMETHOD(GetMoniker) (THIS_ unsigned long dwAssign, unsigned long dwWhichMoniker, 
  753.                 LPLPMONIKER ppmk) PURE;
  754.     STDMETHOD(InitFromData) (THIS_ LPDATAOBJECT pDataObject,
  755.                 unsigned long fCreation,
  756.                 unsigned long dwReserved) PURE;
  757.     STDMETHOD(GetClipboardData) (THIS_ unsigned long dwReserved, 
  758.                 LPLPDATAOBJECT ppDataObject) PURE;
  759.     STDMETHOD(DoVerb) (THIS_ long iVerb,
  760.                 EventRecord * pEvt, 
  761.                 LPOLECLIENTSITE pActiveSite, 
  762.                 long lindex,
  763.                 WindowPtr pWndParent,
  764.                 LPCRECT lprcPosRect) PURE;
  765.     STDMETHOD(EnumVerbs) (THIS_ LPLPENUMOLEVERB ppenumOleVerb) PURE;
  766.     STDMETHOD(Update) (THIS) PURE;
  767.     STDMETHOD(IsUpToDate) (THIS) PURE;
  768.     STDMETHOD(GetUserClassID) (THIS_ CLSID * pClsid) PURE;
  769.     STDMETHOD(GetUserType) (THIS_ unsigned long dwFormOfType, char * * pszUserType) PURE;
  770.     STDMETHOD(SetExtent) (THIS_ unsigned long dwDrawAspect, LPSIZEL lpsizel) PURE;
  771.     STDMETHOD(GetExtent) (THIS_ unsigned long dwDrawAspect, LPSIZEL lpsizel) PURE;
  772.     STDMETHOD(Advise)(THIS_ LPADVISESINK pAdvSink, unsigned long * pdwConnection) PURE;
  773.     STDMETHOD(Unadvise)(THIS_ unsigned long dwConnection) PURE;
  774.     STDMETHOD(EnumAdvise) (THIS_ LPLPENUMSTATDATA ppenumAdvise) PURE;
  775.     STDMETHOD(GetMiscStatus) (THIS_ unsigned long dwAspect, unsigned long * pdwStatus) PURE;
  776.     STDMETHOD(SetColorScheme) (THIS_ LPOLECOLORSCHEME lpColorScheme) PURE;
  777. };
  778. // MAC Think C support
  779. //typedef      IOleObject * LPOLEOBJECT, ** LPLPOLEOBJECT;
  780.  
  781.  
  782.  
  783. #undef  INTERFACE
  784. #define INTERFACE   IOleClientSite
  785.  
  786. DECLARE_INTERFACE_(IOleClientSite, IUnknown)
  787. {
  788.     BEGIN_INTERFACE
  789.     // *** IUnknown methods ***
  790.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  791.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  792.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  793.  
  794.     // *** IOleClientSite methods ***
  795.     STDMETHOD(SaveObject) (THIS) PURE;
  796.     STDMETHOD(GetMoniker) (THIS_ unsigned long dwAssign, unsigned long dwWhichMoniker, 
  797.                 LPLPMONIKER ppmk) PURE;
  798.     STDMETHOD(GetContainer) (THIS_ LPLPOLECONTAINER ppContainer) PURE;   
  799.     STDMETHOD(ShowObject) (THIS) PURE;  
  800.     STDMETHOD(OnShowWindow) (THIS_ unsigned long fShow) PURE;    
  801.     STDMETHOD(RequestNewObjectLayout) (THIS) PURE;      
  802. };
  803. // MAC Think C support
  804. //typedef      IOleClientSite * LPOLECLIENTSITE, ** LPLPOLECLIENTSITE;
  805.  
  806. /****** OLE Runnable Object Interface **********************************/
  807.  
  808. #undef  INTERFACE
  809. #define INTERFACE    IRunnableObject
  810.  
  811. DECLARE_INTERFACE_(IRunnableObject, IUnknown)
  812. {
  813.     BEGIN_INTERFACE
  814.     // *** IUnknown methods ***
  815.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  816.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  817.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  818.  
  819.     // *** IRunnableObject methods ***
  820.     STDMETHOD(GetRunningClass) (THIS_ LPCLSID lpClsid) PURE;
  821.     STDMETHOD(Run) (THIS_ LPBINDCTX pbc) PURE;
  822.     STDMETHOD_(unsigned long, IsRunning) (THIS) PURE;
  823.     STDMETHOD(LockRunning)(THIS_ unsigned long fLock, unsigned long fLastUnlockCloses) PURE;
  824.     STDMETHOD(SetContainedObject)(THIS_ unsigned long fContained) PURE;
  825. };
  826. typedef      IRunnableObject * LPRUNNABLEOBJECT, ** LPLPRUNNABLEOBJECT;
  827.  
  828.  
  829. /****** OLE Container Interfaces ***************************************/
  830.  
  831.  
  832. #undef  INTERFACE
  833. #define INTERFACE   IParseDisplayName
  834.  
  835. DECLARE_INTERFACE_(IParseDisplayName, IUnknown)
  836. {
  837.     BEGIN_INTERFACE
  838.     // *** IUnknown methods ***
  839.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  840.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  841.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  842.  
  843.     // *** IParseDisplayName method ***
  844.     STDMETHOD(ParseDisplayName) (THIS_ LPBC pbc, char * lpszDisplayName,
  845.         unsigned long * pchEaten, LPLPMONIKER ppmkOut) PURE;
  846. };
  847. typedef       IParseDisplayName * LPPARSEDISPLAYNAME, ** LPLPPARSEDISPLAYNAME;
  848.  
  849.  
  850. #undef  INTERFACE
  851. #define INTERFACE   IOleContainer
  852.  
  853. DECLARE_INTERFACE_(IOleContainer, IParseDisplayName)
  854. { 
  855.     BEGIN_INTERFACE
  856.     // *** IUnknown methods ***
  857.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  858.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  859.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  860.  
  861.     // *** IParseDisplayName method ***
  862.     STDMETHOD(ParseDisplayName) (THIS_ LPBC pbc, char * lpszDisplayName,
  863.         unsigned long * pchEaten, LPLPMONIKER ppmkOut) PURE;
  864.  
  865.     // *** IOleContainer methods ***
  866.     STDMETHOD(EnumObjects) ( THIS_ unsigned long grfFlags, LPLPENUMUNKNOWN ppenumUnknown) PURE;
  867.     STDMETHOD(LockContainer) (THIS_ unsigned long fLock) PURE;   
  868. };
  869. //typedef IOleContainer * LPOLECONTAINER, ** LPLPOLECONTAINER;
  870.  
  871.  
  872. typedef enum tagBINDSPEED
  873. {
  874.     BINDSPEED_INDEFINITE    = 1,
  875.     BINDSPEED_MODERATE      = 2,
  876.     BINDSPEED_IMMEDIATE     = 3
  877.     ,BINDSPEED_FORCELONG    =    2147483647
  878. } BINDSPEED;
  879.  
  880. typedef enum tagOLECONTF
  881. {
  882.     OLECONTF_EMBEDDINGS        =  1,
  883.     OLECONTF_LINKS             =  2,
  884.     OLECONTF_OTHERS         =  4,
  885.     OLECONTF_ONLYUSER         =  8,
  886.     OLECONTF_ONLYIFRUNNING     = 16
  887.     ,OLECONTF_FORCELONG    =    2147483647
  888. } OLECONTF;
  889.  
  890.  
  891. #undef  INTERFACE
  892. #define INTERFACE   IOleItemContainer
  893.  
  894. DECLARE_INTERFACE_(IOleItemContainer, IOleContainer)
  895. { 
  896.     BEGIN_INTERFACE
  897.     // *** IUnknown methods ***
  898.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  899.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  900.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  901.  
  902.     // *** IParseDisplayName method ***
  903.     STDMETHOD(ParseDisplayName) (THIS_ LPBC pbc, char * lpszDisplayName,
  904.         unsigned long * pchEaten, LPLPMONIKER ppmkOut) PURE;
  905.  
  906.     // *** IOleContainer methods ***
  907.     STDMETHOD(EnumObjects) (THIS_ unsigned long grfFlags, LPLPENUMUNKNOWN ppenumUnknown) PURE;
  908.     STDMETHOD(LockContainer) (THIS_ unsigned long fLock) PURE;   
  909.     
  910.     // *** IOleItemContainer methods ***
  911.     STDMETHOD(GetObject) (THIS_ char * lpszItem, unsigned long dwSpeedNeeded,
  912.         LPBINDCTX pbc, REFIID riid, void * * ppvObject) PURE;
  913.     STDMETHOD(GetObjectStorage) (THIS_ char * lpszItem, LPBINDCTX pbc,
  914.         REFIID riid, void * * ppvStorage) PURE;
  915.     STDMETHOD(IsRunning) (THIS_ char * lpszItem) PURE;
  916. };
  917. typedef       IOleItemContainer * LPOLEITEMCONTAINER, ** LPLPOLEITEMCONTAINER;
  918.  
  919.  
  920. /****** OLE Advise Holder Interface ***************************************/
  921.  
  922.  
  923. #undef  INTERFACE
  924. #define INTERFACE   IOleAdviseHolder
  925.  
  926. DECLARE_INTERFACE_(IOleAdviseHolder, IUnknown)
  927. { 
  928.     BEGIN_INTERFACE
  929.     // *** IUnknown methods ***
  930.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppv) PURE;
  931.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  932.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  933.  
  934.     // *** IOleAdviseHolder methods ***
  935.     STDMETHOD(Advise)(THIS_ LPADVISESINK pAdvise, unsigned long * pdwConnection) PURE;
  936.     STDMETHOD(Unadvise)(THIS_ unsigned long dwConnection) PURE;
  937.     STDMETHOD(EnumAdvise)(THIS_ LPLPENUMSTATDATA ppenumAdvise) PURE;
  938.  
  939.     STDMETHOD(SendOnRename)(THIS_ LPMONIKER pmk) PURE;
  940.     STDMETHOD(SendOnSave)(THIS) PURE;
  941.     STDMETHOD(SendOnClose)(THIS) PURE;
  942. };
  943. typedef      IOleAdviseHolder * LPOLEADVISEHOLDER, ** LPLPOLEADVISEHOLDER;
  944.  
  945.  
  946. /****** OLE Link Interface ************************************************/
  947.  
  948. /* Link update options */
  949. typedef enum tagOLEUPDATE
  950. {
  951.     OLEUPDATE_ALWAYS=1,
  952.     OLEUPDATE_ONCALL=3
  953.     ,OLEUPDATE_FORCELONG    =    2147483647
  954. } OLEUPDATE;
  955. typedef  OLEUPDATE * LPOLEUPDATE;
  956.  
  957.  
  958. // for IOleLink::BindToSource
  959. typedef enum tagOLELINKBIND
  960. {
  961.     OLELINKBIND_EVENIFCLASSDIFF = 1
  962.     ,OLELINKBIND_FORCELONG    =    2147483647
  963. } OLELINKBIND;
  964.  
  965.  
  966. #undef  INTERFACE
  967. #define INTERFACE   IOleLink
  968.  
  969. DECLARE_INTERFACE_(IOleLink, IUnknown)
  970. {
  971.     BEGIN_INTERFACE
  972.     // *** IUnknown methods ***
  973.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  974.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  975.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  976.  
  977.     // *** IOleLink methods ***
  978.     STDMETHOD(SetUpdateOptions) (THIS_ unsigned long dwUpdateOpt) PURE;
  979.     STDMETHOD(GetUpdateOptions) (THIS_ unsigned long    * pdwUpdateOpt) PURE;
  980.     STDMETHOD(SetSourceMoniker) (THIS_ LPMONIKER pmk, REFCLSID rclsid) PURE;
  981.     STDMETHOD(GetSourceMoniker) (THIS_ LPLPMONIKER ppmk) PURE;
  982.     STDMETHOD(SetSourceDisplayName) (THIS_ const char * lpszDisplayName) PURE;
  983.     STDMETHOD(GetSourceDisplayName) (THIS_ char * * lplpszDisplayName) PURE;
  984.     STDMETHOD(BindToSource) (THIS_ unsigned long bindflags, LPBINDCTX pbc) PURE;
  985.     STDMETHOD(BindIfRunning) (THIS) PURE;
  986.     STDMETHOD(GetBoundSource) (THIS_ LPLPUNKNOWN ppUnk) PURE;
  987.     STDMETHOD(UnbindSource) (THIS) PURE;
  988.     STDMETHOD(Update) (THIS_ LPBINDCTX pbc) PURE;
  989. };
  990. typedef         IOleLink * LPOLELINK, ** LPLPOLELINK;
  991.  
  992.  
  993. /****** OLE InPlace Editing Interfaces ************************************/
  994.  
  995.  
  996. typedef struct FARSTRUCT tagOIFI          // OleInPlaceFrameInfo
  997. {
  998.     long                recordLength;    // (2) == sizeof(OLEINPLACEFRAMEINFO)
  999.     long                version;        // (2) vers == 1
  1000.     WindowPtr              frameWindow;    // (4) 
  1001.     OSType                signature;        // (4) creator signature
  1002.     long                refcon;            // (4) anything you want
  1003.     ProcessSerialNumber    psn;            // (8) psn
  1004.     Handle                 hCmdKeys;        // (4) must be null
  1005.     short                numCmds;        // (2) must be zero
  1006.     short                growHandles;    // (2) which grow handles allowed in server
  1007.     short                dragConstraint;    // (2) which direction dragging allowed in server
  1008.     Boolean               fAdjustMenus;    // (1) cont needs ::AdjustMenus called?
  1009.     Boolean               unused;            // (1) unused
  1010. } OLEINPLACEFRAMEINFO, * LPOLEINPLACEFRAMEINFO;
  1011.  
  1012.  
  1013. typedef struct tagOleMBarRec 
  1014. {
  1015.     long reserved;
  1016. } OleMBarRec, *OleMBarPtr, **OleMBarHandle;
  1017.  
  1018. #define noAxis    3        // indicates no grow or size in any direction
  1019. // see mac #defines noConstraint, hAxisOnly, vAxisOnly
  1020.  
  1021. typedef Rect    BORDERWIDTHS;
  1022. typedef Rect *  LPBORDERWIDTHS;
  1023. typedef LPCRECT LPCBORDERWIDTHS;
  1024.  
  1025. /* Inplace editing specific error codes */
  1026.  
  1027. #define    INPLACE_E_NOTUNDOABLE    (INPLACE_E_FIRST)
  1028. // undo is not avaiable
  1029.  
  1030. #define INPLACE_E_NOTOOLSPACE        (INPLACE_E_FIRST+1)
  1031. // Space for tools is not available
  1032.  
  1033. #define INPLACE_S_TRUNCATED        (INPLACE_S_FIRST)
  1034. // Message is too long, some of it had to be truncated before displaying
  1035.  
  1036. //misc definitions
  1037. #define INPLACE_DEFBORDERWIDTH    4
  1038.  
  1039. //      forward type declarations
  1040. #if defined(__cplusplus)
  1041. interface IOleInPlaceUIWindow;
  1042. #else 
  1043. //typedef interface IOleInPlaceUIWindow IOleInPlaceUIWindow;
  1044. #endif
  1045.  
  1046. typedef   interface  IOleInPlaceUIWindow * LPOLEINPLACEUIWINDOW, ** LPLPOLEINPLACEUIWINDOW;
  1047.  
  1048.  
  1049. #undef  INTERFACE
  1050. #define INTERFACE   IOleWindow
  1051.  
  1052. DECLARE_INTERFACE_(IOleWindow, IUnknown)
  1053. { 
  1054.     BEGIN_INTERFACE
  1055.     // *** IUnknown methods ***
  1056.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  1057.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  1058.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  1059.  
  1060.     // *** IOleWindow methods ***
  1061.     STDMETHOD(GetWindow) (THIS_ WindowPtr * ppWnd) PURE;
  1062.     STDMETHOD(ContextSensitiveHelp) (THIS_ unsigned long fEnterMode) PURE;
  1063. };
  1064.  
  1065. typedef         IOleWindow * LPOLEWINDOW, ** LPLPOLEWINDOW;
  1066.  
  1067.  
  1068.  
  1069. #undef  INTERFACE
  1070. #define INTERFACE   IOleInPlaceObject
  1071.  
  1072. DECLARE_INTERFACE_(IOleInPlaceObject, IOleWindow)
  1073. { 
  1074.     BEGIN_INTERFACE
  1075.     // *** IUnknown methods ***
  1076.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  1077.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  1078.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  1079.  
  1080.     // *** IOleWindow methods ***
  1081.     STDMETHOD(GetWindow) (THIS_ WindowPtr * ppWnd) PURE;
  1082.     STDMETHOD(ContextSensitiveHelp) (THIS_ unsigned long fEnterMode) PURE;
  1083.  
  1084.     // *** IOleInPlaceObject methods ***
  1085.     STDMETHOD(InPlaceDeactivate) (THIS) PURE;   
  1086.     STDMETHOD(UIDeactivate) (THIS) PURE;
  1087.     STDMETHOD(SetObjectRects) (THIS_ LPCRECT lprcPosRect, 
  1088.                     RgnHandle clipRgn,        // cliping area within containing window
  1089.                     RgnHandle frameRgn,        // entire structure rgn of containing window
  1090.                     RgnHandle cliRgn        // union of all structure rgns of all container app windows    
  1091.                     ) PURE;
  1092.     STDMETHOD(ReactivateAndUndo) (THIS) PURE;   
  1093. };
  1094. typedef         IOleInPlaceObject * LPOLEINPLACEOBJECT, ** LPLPOLEINPLACEOBJECT;
  1095.  
  1096.  
  1097.  
  1098. #undef  INTERFACE
  1099. #define INTERFACE   IOleInPlaceActiveObject
  1100.  
  1101. DECLARE_INTERFACE_(IOleInPlaceActiveObject, IOleWindow)
  1102. { 
  1103.     BEGIN_INTERFACE
  1104.    // *** IUnknown methods ***
  1105.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  1106.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  1107.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  1108.  
  1109.     // *** IOleWindow methods ***
  1110.     STDMETHOD(GetWindow) (THIS_ WindowPtr * ppWnd) PURE;
  1111.     STDMETHOD(ContextSensitiveHelp) (THIS_ unsigned long fEnterMode) PURE;
  1112.  
  1113.     // *** IOleInPlaceActiveObject methods ***
  1114.     STDMETHOD(TranslateAccelerator) (THIS_ EventRecord * pEvt) PURE;   
  1115.     STDMETHOD(OnFrameWindowActivate) (THIS_ unsigned long fActivate) PURE;           
  1116.     STDMETHOD(OnDocWindowActivate) (THIS_ unsigned long fActivate) PURE;
  1117.     STDMETHOD(ResizeBorder) (THIS_ LPCRECT lprectBorder, LPOLEINPLACEUIWINDOW lpUIWindow, unsigned long fFrameWindow) PURE;          
  1118.     STDMETHOD(EnableModeless) (THIS_ unsigned long fEnable) PURE;
  1119. };
  1120. typedef         IOleInPlaceActiveObject * LPOLEINPLACEACTIVEOBJECT, ** LPLPOLEINPLACEACTIVEOBJECT;
  1121.  
  1122.  
  1123.  
  1124. #undef  INTERFACE
  1125. #define INTERFACE   IOleInPlaceUIWindow
  1126.  
  1127. DECLARE_INTERFACE_(IOleInPlaceUIWindow, IOleWindow)
  1128. { 
  1129.     BEGIN_INTERFACE
  1130.    // *** IUnknown methods ***
  1131.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  1132.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  1133.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  1134.  
  1135.     // *** IOleWindow methods ***
  1136.     STDMETHOD(GetWindow) (THIS_ WindowPtr * ppWnd) PURE;
  1137.     STDMETHOD(ContextSensitiveHelp) (THIS_ unsigned long fEnterMode) PURE;
  1138.  
  1139.     // *** IOleInPlaceUIWindow methods ***
  1140.     STDMETHOD(GetBorder) (THIS_ Rect * lprectBorder) PURE;
  1141.     STDMETHOD(RequestBorderSpace) (THIS_ LPCBORDERWIDTHS lpborderwidths) PURE;
  1142.     STDMETHOD(SetBorderSpace) (THIS_ LPCBORDERWIDTHS lpborderwidths) PURE;
  1143.     STDMETHOD(SetActiveObject) (THIS_ LPOLEINPLACEACTIVEOBJECT lpActiveObject,
  1144.                         const char * lpszObjName) PURE; 
  1145. };
  1146. //typedef     IOleInPlaceUIWindow * LPOLEINPLACEUIWINDOW, ** LPLPOLEINPLACEUIWINDOW;
  1147.  
  1148.  
  1149.  
  1150. #undef  INTERFACE
  1151. #define INTERFACE   IOleInPlaceFrame
  1152.  
  1153.  
  1154. DECLARE_INTERFACE_(IOleInPlaceFrame, IOleInPlaceUIWindow)
  1155. { 
  1156.     BEGIN_INTERFACE
  1157.    // *** IUnknown methods ***
  1158.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  1159.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  1160.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  1161.  
  1162.     // *** IOleWindow methods ***
  1163.     STDMETHOD(GetWindow) (THIS_ WindowPtr * ppWnd) PURE;
  1164.     STDMETHOD(ContextSensitiveHelp) (THIS_ unsigned long fEnterMode) PURE;
  1165.  
  1166.     // *** IOleInPlaceUIWindow methods ***
  1167.     STDMETHOD(GetBorder) (THIS_ Rect * lprectBorder) PURE;
  1168.     STDMETHOD(RequestBorderSpace) (THIS_ LPCBORDERWIDTHS lpborderwidths) PURE;
  1169.     STDMETHOD(SetBorderSpace) (THIS_ LPCBORDERWIDTHS lpborderwidths) PURE;
  1170.     STDMETHOD(SetActiveObject) (THIS_ LPOLEINPLACEACTIVEOBJECT lpActiveObject,
  1171.                     const char * lpszObjName) PURE; 
  1172.     
  1173.     
  1174.     // *** IOleInPlaceFrame methods ***
  1175.     STDMETHOD(InsertMenus) (THIS_ OleMBarHandle hOleMBar) PURE;
  1176.     STDMETHOD(AdjustMenus) (THIS_ OleMBarHandle hOleMBar) PURE;
  1177.     STDMETHOD(RemoveMenus) (THIS_ OleMBarHandle hOleMBar) PURE;
  1178.     STDMETHOD(SetStatusText) (THIS_ const char * lpszStatusText) PURE;    
  1179.     STDMETHOD(EnableModeless) (THIS_ unsigned long fEnable) PURE;
  1180.     STDMETHOD(TranslateAccelerator) (THIS_ EventRecord * pEvt, long ID) PURE;
  1181. };
  1182. typedef     IOleInPlaceFrame * LPOLEINPLACEFRAME, ** LPLPOLEINPLACEFRAME;
  1183.  
  1184.  
  1185. #undef  INTERFACE
  1186. #define INTERFACE   IOleInPlaceSite
  1187.  
  1188.  
  1189. DECLARE_INTERFACE_(IOleInPlaceSite, IOleWindow)
  1190. { 
  1191.     BEGIN_INTERFACE
  1192.    // *** IUnknown methods ***
  1193.     STDMETHOD(QueryInterface) (THIS_ REFIID riid, void * * ppvObj) PURE;
  1194.     STDMETHOD_(unsigned long,AddRef) (THIS)  PURE;
  1195.     STDMETHOD_(unsigned long,Release) (THIS) PURE;
  1196.  
  1197.     // *** IOleWindow methods ***
  1198.     STDMETHOD(GetWindow) (THIS_ WindowPtr * ppWnd) PURE;
  1199.     STDMETHOD(ContextSensitiveHelp) (THIS_ unsigned long fEnterMode) PURE;
  1200.  
  1201.     // *** IOleInPlaceSite methods ***
  1202.     STDMETHOD(CanInPlaceActivate) (THIS) PURE;
  1203.     STDMETHOD(OnInPlaceActivate) (THIS) PURE;
  1204.     STDMETHOD(OnUIActivate) (THIS) PURE;    
  1205.     STDMETHOD(OnUIVisible) (THIS_ unsigned long fVisible) PURE;    // true if visibile
  1206.  
  1207.     STDMETHOD(GetObjectRects) (THIS_ 
  1208.                     Rect * lprcPosRect,
  1209.                 // server allocs, container fills, server frees
  1210.                     RgnHandle clipRgn,        // defines vis rgn
  1211.                     RgnHandle frameRgn,        // containing window strucRgn
  1212.                     RgnHandle cliRgn        // all container app strucRgns
  1213.                       ) PURE;
  1214.     STDMETHOD(GetWindowContext) (THIS_ 
  1215.                         LPLPOLEINPLACEFRAME lplpFrame,
  1216.                         LPLPOLEINPLACEUIWINDOW lplpDoc,
  1217.                         //WindowPtr    *ppWindow,
  1218.                         Rect *lprcPosRect,
  1219.                     // server allocs, container fills, server frees
  1220.                         RgnHandle clipRgn,        // defines vis rgn
  1221.                         RgnHandle frameRgn,        // containing window strucRgn
  1222.                         RgnHandle cliRgn,        // all container app strucRgns
  1223.                         LPOLEINPLACEFRAMEINFO lpFrameInfo) PURE;
  1224.     STDMETHOD(Scroll) (THIS_ long scrollExtent) PURE;       
  1225.     STDMETHOD(OnUIDeactivate) (THIS_ unsigned long fUndoable) PURE;      
  1226.     STDMETHOD(OnInPlaceDeactivate) (THIS) PURE;
  1227.     STDMETHOD(DiscardUndoState) (THIS) PURE;
  1228.     STDMETHOD(DeactivateAndUndo) (THIS) PURE;
  1229.     STDMETHOD(OnPosRectChange) (THIS_ LPCRECT lprcPosRect) PURE; 
  1230. };
  1231. typedef         IOleInPlaceSite * LPOLEINPLACESITE, ** LPLPOLEINPLACESITE;
  1232.  
  1233.  
  1234.  
  1235. /****** OLE API Prototypes ************************************************/
  1236.  
  1237. STDAPI_(unsigned long) OleBuildVersion( void );
  1238.  
  1239. /* helper functions */
  1240. STDAPI ReadClassStg(LPSTORAGE pStg, CLSID * pclsid);
  1241. STDAPI WriteClassStg(LPSTORAGE pStg, REFCLSID rclsid);
  1242. STDAPI ReadClassStm(LPSTREAM pStm, CLSID * pclsid);
  1243. STDAPI WriteClassStm(LPSTREAM pStm, REFCLSID rclsid);
  1244. STDAPI WriteFmtUserTypeStg (LPSTORAGE pstg, unsigned long cf, char * lpszUserType);
  1245. STDAPI ReadFmtUserTypeStg (LPSTORAGE pstg, unsigned long * pcf, char * * lplpszUserType);
  1246.  
  1247.  
  1248. /* init/term */
  1249.  
  1250.  
  1251. typedef enum tagOLEMANAGER
  1252. {
  1253.     OLEMGR_BIND_NORMAL = 0,          // normal app, launch, bind, and addref
  1254.     OLEMGR_BIND_IF_THERE = 1,    // app only wishes to bind if applet already running
  1255.                                 // useful only for mini-servers
  1256.     OLEMGR_NO_ADDREF = 2,         // do not refct the applet, will bind only if applet running
  1257.                                 // useful only for addins
  1258.     OLEMGR_ASYNC = 4,            // not yet supported
  1259.     OLEMGR_FORCELONG    =    2147483647
  1260. } OLEMANAGER;
  1261.  
  1262.  
  1263. STDAPI_(unsigned long) IsOleManagerRunning(void);        // returns ref ct    
  1264. STDAPI InitOleManager(long dwFlags);                    // dwReserved must be NULL
  1265. STDAPI_(unsigned long) UninitOleManager(void);            // returns true/false
  1266.  
  1267.  
  1268.  
  1269. STDAPI OleInitialize(LPMALLOC pMalloc);
  1270. STDAPI_(void) OleUninitialize(void);
  1271.  
  1272.  
  1273. /* APIs to query whether (Embedded/Linked) object can be created from 
  1274.    the data object */
  1275.  
  1276. STDAPI  OleQueryLinkFromData(LPDATAOBJECT pSrcDataObject);
  1277. STDAPI  OleQueryCreateFromData(LPDATAOBJECT pSrcDataObject);
  1278.                     
  1279.  
  1280. /* Object creation APIs */
  1281.  
  1282. STDAPI  OleCreate(REFCLSID rclsid, REFIID riid, unsigned long renderopt, 
  1283.                 LPFORMATETC pFormatEtc, LPOLECLIENTSITE pClientSite, 
  1284.                 LPSTORAGE pStg, void * * ppvObj); 
  1285.  
  1286. STDAPI  OleCreateFromData(LPDATAOBJECT pSrcDataObj, REFIID riid, 
  1287.                 unsigned long renderopt, LPFORMATETC pFormatEtc, 
  1288.                 LPOLECLIENTSITE pClientSite, LPSTORAGE pStg, 
  1289.                 void * * ppvObj);
  1290.  
  1291. STDAPI  OleCreateLinkFromData(LPDATAOBJECT pSrcDataObj, REFIID riid, 
  1292.                 unsigned long renderopt, LPFORMATETC pFormatEtc, 
  1293.                 LPOLECLIENTSITE pClientSite, LPSTORAGE pStg, 
  1294.                 void * * ppvObj);
  1295.  
  1296. STDAPI  OleCreateStaticFromData(LPDATAOBJECT pSrcDataObj, REFIID iid, 
  1297.                 unsigned long renderopt, LPFORMATETC pFormatEtc, 
  1298.                 LPOLECLIENTSITE pClientSite, LPSTORAGE pStg, 
  1299.                 void * * ppvObj);    
  1300.  
  1301.                 
  1302. STDAPI  OleCreateLink(LPMONIKER pmkLinkSrc, REFIID riid, 
  1303.             unsigned long renderopt, LPFORMATETC lpFormatEtc, 
  1304.             LPOLECLIENTSITE pClientSite, LPSTORAGE pStg, void * * ppvObj);
  1305.  
  1306. // MAC Also has the API's OleCreateLinkToFSp and OleCreateFromFSp defined.
  1307.  
  1308. STDAPI  OleCreateLinkToFile(const char * lpszFileName, REFIID riid, 
  1309.             unsigned long renderopt, LPFORMATETC lpFormatEtc, 
  1310.             LPOLECLIENTSITE pClientSite, LPSTORAGE pStg, void * * ppvObj);
  1311.             
  1312. STDAPI  OleCreateFromFile(REFCLSID rclsid, const char * lpszFileName, REFIID riid, 
  1313.             unsigned long renderopt, LPFORMATETC lpFormatEtc, 
  1314.             LPOLECLIENTSITE pClientSite, LPSTORAGE pStg, void * * ppvObj);
  1315.                                 
  1316.  
  1317. STDAPI  OleLoad(LPSTORAGE pStg, REFIID riid, LPOLECLIENTSITE pClientSite, 
  1318.             void * * ppvObj);
  1319.             
  1320. STDAPI  OleSave(LPPERSISTSTORAGE pPS, LPSTORAGE pStg, unsigned long fSameAsLoad);
  1321.  
  1322. STDAPI  OleLoadFromStream( LPSTREAM pStm, REFIID iidInterface, void * * ppvObj);
  1323. STDAPI  OleSaveToStream( LPPERSISTSTREAM pPStm, LPSTREAM pStm );
  1324.  
  1325.  
  1326. STDAPI  OleSetContainedObject(LPUNKNOWN pUnknown, unsigned long fContained);
  1327. STDAPI  OleNoteObjectVisible(LPUNKNOWN pUnknown, unsigned long fVisible);
  1328.  
  1329.  
  1330. /* Drag/Drop APIs */
  1331.  
  1332. STDAPI  RegisterDragDrop(WindowPtr pWnd, LPDROPTARGET pDropTarget);
  1333. STDAPI  RevokeDragDrop(WindowPtr pWnd);
  1334. STDAPI  DoDragDrop(LPDATAOBJECT pDataObj, LPDROPSOURCE pDropSource,
  1335.             unsigned long dwOKEffects, unsigned long    * pdwEffect);
  1336.  
  1337. /* Clipboard APIs */
  1338.  
  1339. STDAPI  OleSetClipboard(LPDATAOBJECT pDataObj);
  1340. STDAPI  OleGetClipboard(LPLPDATAOBJECT ppDataObj);
  1341. STDAPI  OleFlushClipboard(void);
  1342. STDAPI  OleIsCurrentClipboard(LPDATAOBJECT pDataObj);
  1343.  
  1344.  
  1345. /* InPlace Editing APIs */                                
  1346.  
  1347.  
  1348. STDAPI OleSendLLE(OSType sig, EventRecord *pevt);
  1349. STDAPI OleSendLowLevelEvent(ProcessSerialNumber *ppsn, EventRecord *pevt);
  1350.  
  1351. STDAPI    OleNewMBar(OleMBarHandle *phOleMBar);
  1352.  
  1353. STDAPI    OleDisposeMBar(OleMBarHandle hOleMBar);
  1354.  
  1355. STDAPI  OleInsertMenus(OleMBarHandle hOleMBar, short beforeID1, short beforeID3, short beforeID5); 
  1356.     // OleInsertMenus inserts the hOleMbar menus into the menu list.
  1357.     // each group of menus is inserted before the menu whose
  1358.     // menu ID equals beforeID#. If beforeID# is Ø (or isn't the ID of any menu
  1359.     // in the menu list), the new menu is added after all others. If the menu
  1360.     // is already in the menu list or the menu list is already full, InsertMenu
  1361.     // does nothing. Be sure to call DrawMenuBar to update the menu bar.
  1362.  
  1363. STDAPI  OleHashMenuID(short *pMenuID);
  1364.     // container calls this passing menuid.  If this menuid is currently
  1365.     // hashed, then the hash value is returned.
  1366.  
  1367. STDAPI  OleUnhashMenuID(short *pMenuID);
  1368.     // the container calls this api passing a menuid returned by menu select
  1369.     // this id is unhashed and returned.  If menuid is not hashed,
  1370.     // then in menuID == out menuID
  1371.  
  1372. STDAPI  OlePatchGetMHandle(OleMBarHandle hOleMBar);
  1373.     // Container app calls this to patch GetMHandle.
  1374.     // the menu id's in hOleMbar will be hashed to a range in 15000-17000.
  1375.     // This call should be balanced by call to OleUnpatchGetMHandle.
  1376.  
  1377. STDAPI  OleUnpatchGetMHandle(OleMBarHandle hOleMBar);
  1378.     // Container app calls this to unhash menus and remove GetMHandle patch.
  1379.     // Menus are unhashed and patch is removed if and only if there are
  1380.     // no more unbalanced calls to OlePatchGetMHandle
  1381.  
  1382. STDAPI  OleAddMBarMenu(OleMBarHandle hOleMBar, MenuHandle hMenu, short group);
  1383.     // OleAddMBarMenu adds hMenu to the Ole MBar.  This is called only
  1384.     // by the client and group is 0,2,4,-1.  -1 is for Hierarchical menus.
  1385.  
  1386. STDAPI OleSetInFrontOf(ProcessSerialNumber *pPsn);
  1387.  
  1388. STDAPI    OleSetInPlaceWindow(WindowPtr pWndObject, LPOLEINPLACEFRAMEINFO lpFrameInfo);
  1389.     // OleSetInPlaceWindow is called by the server to tell the 
  1390.     // dlls which window is serving the inplace object.  The dlls
  1391.     // will subclass this window's wdef to remove all structure
  1392.     // rgn from the window.  This is the official request to begin
  1393.     // inplace UI.  Server may change any fields of the frameinfo
  1394.     // before calling this api (eg, growhandles)
  1395.  
  1396. STDAPI    OleUnSetInPlaceWindow(unsigned long fInvalidate);
  1397.     // OleUnSetInPlaceWindow is called by the server to indicate
  1398.     // that the inplace window should be un-subclassed and all
  1399.     // the clipped windows should be unclipped.
  1400.     // if fInvalidate is true, implies server must invalidate rgns
  1401.     // NOTE: only pass TRUE if container is NOT pulling itself forward
  1402.     // or you will get flicker! 
  1403.  
  1404. STDAPI  OleClipWindows(WindowPtr pWndClip);
  1405.     // OleClipWindows is called by the server app to clip all windows
  1406.     // in its windowlist behind and including pWndClip.
  1407.     // This makes the server app appear to remain in the background.
  1408.     // NOTE, you must call OleSetInPlaceWindow() first.
  1409.  
  1410. STDAPI  OleClipWindow(WindowPtr pWndClip);
  1411. STDAPI  OleUnclipWindow(WindowPtr pWndClip, Boolean fPaint);
  1412.  
  1413.  
  1414. STDAPI_(void) OleMoveWindow(WindowPtr pWnd, 
  1415.                             short hPosition, short vPosition, 
  1416.                             Boolean fActivate);
  1417.     // called by container or server on window and this does the right thing
  1418.  
  1419. STDAPI_(void) OleDragParentWindow(WindowPtr pWnd,
  1420.                     Point startPt, const Rect *pLimitRect);
  1421.     // Same as mac trap, but removes server windows from
  1422.     // clipping region
  1423.  
  1424. STDAPI_(long) OleDragObjectWindow(WindowPtr pWnd,
  1425.                     Point startPt, const Rect *pLimitRect, const Rect *pSlopRect,
  1426.                     short constrain, ProcPtr actionProc);
  1427.     // bounds is intersected w/ the parent window rect as drag limit
  1428.     // constrain limits direction of drag
  1429.     // draggrayrgn
  1430.  
  1431.  
  1432. STDAPI_(void) OleSizeParentWindow(WindowPtr pWnd, short h, short v, Boolean fUpdate);
  1433.     // Same as mac trap, but clips ip server window
  1434.  
  1435.  
  1436. STDAPI_(void) OleSizeObjectWindow(WindowPtr pWnd, const Rect *prcNewBounds, Boolean fUpdate);
  1437.     // does a movewindow/sizewindow to effectively "zoom" window to new location/size
  1438.  
  1439. STDAPI_(long) OleZoomParentWindow(WindowPtr pWnd, short wPart, Boolean fMakeFront);
  1440.     // same as mac trap
  1441.  
  1442. STDAPI_(long) OleGrowParentWindow(WindowPtr pWnd, Point pt, const Rect *prcMinMax);
  1443.     // same as mac trap
  1444.  
  1445.  
  1446. STDAPI_(long) OleGrowObjectWindow(WindowPtr pWnd, Point pt, const Rect *prcMinMax, Rect *prcNewBounds);
  1447.     // OleGrowObjectWindow is called by the server app to track the resize handles
  1448.     // of the inplace window.  pass the inplace windowptr, global point
  1449.     // that the mouse went down, constraining min/max lengths in a rect
  1450.     // like growwindow top left is min height/width bottom right is
  1451.     // max height/width, the output rect prcNewBounds is 
  1452.     // dims or rect to pass to olesizewindow and SetInplaceRects
  1453.  
  1454. STDAPI_(short) OleWhichGrowHandle(WindowPtr pWnd, Point pt);
  1455.     // pt is in global coordinates
  1456.     // returns -2, this window is not inplace active
  1457.     // returns -1, not in grow rgn
  1458.     // 0 == standard grow box
  1459.     // 1..8 handles numbered from top left to bot right
  1460.     // this api calls FindWindow to ensure window part is
  1461.     // visible
  1462.  
  1463. STDAPI    OleGetCursor(CursPtr pCursor, WindowPtr pWndObject);
  1464.     // server calls this to get cursor info from container.
  1465.     // objectWindow is server's current ip window
  1466.     // pCursor is ptr to 68 bytes to receive the cursor data
  1467.  
  1468. STDAPI    OleSetCursor(CursPtr pCursor, WindowPtr pWndParent);
  1469.     // container optionally calls this to set up cursor info.
  1470.     // if container does not set up custom cursors, standard
  1471.     // arrow will be assumed.
  1472.     // if pWndParent is not the current ip parent window
  1473.     // this api return error
  1474.  
  1475. STDAPI    OleUpdateCursor(WindowPtr pWndObject);
  1476.     // Server calls this to change cursor for container while
  1477.     // in foreground.  This is a short cut for calling 
  1478.     // OleGetCursor(), OleWhichGrowHandle(), SetCursor().
  1479.     // If no cursor information was supplied by container
  1480.     // the standard arrow cursor will be used
  1481.     // if the cursor is over the drag/resize area of the object window
  1482.     // standard resize cursors will be drawn.
  1483.  
  1484.  
  1485. STDAPI  OleSetInPlaceRects(
  1486.         RgnHandle posRgn, 
  1487.         RgnHandle clipRgn, RgnHandle frameRgn, 
  1488.         RgnHandle cliRgn, RgnHandle clickRgn);
  1489.     // OleSetInPlaceRects is called by the server app to inform the
  1490.     // inplace window how to clip itself to client app windows
  1491.     // the 1st 3 params are the same as SetObjectRects,
  1492.     // all rect/rgn coords are GLOBAL
  1493.     // posRgn - obj pos Rgn
  1494.     // clipRgn - rgn in which object may display itself visibly
  1495.     // frameRgn - strucRgn of obj's containing window
  1496.     // cliRgn - the union of all open/visible client app windows strucRgns
  1497.     // clickRgn - if non-null is sub'ed from posRgn and passed to ole2init to 
  1498.     // catch mouse clicks    (obsolete now?) bugbug
  1499.  
  1500. STDAPI  OleSetParentRgns(RgnHandle clipRgn, 
  1501.     RgnHandle frameRgn, RgnHandle clientRgn);
  1502. //
  1503.  
  1504. STDAPI  OleSetObjectRgn(RgnHandle posRgn);
  1505. // this call is optional
  1506.  
  1507.  
  1508. STDAPI    OleMaskMouse(Boolean bEnable);
  1509.     // server calls this api to turn mouseDown->app1Evt coercion on or off
  1510.     // server calls OleMaskMouse(false) to put up modal dbox
  1511.     // and OleMaskMouse(true) when the dbox is done
  1512.  
  1513. STDAPI    OleTranslateAccelerator (LPOLEINPLACEFRAME lpFrame, 
  1514.             LPOLEINPLACEFRAMEINFO lpFrameInfo, EventRecord * pEvt);
  1515.     // calls menukey to get menuid, then calls lpFrame->TranslateAccelerator,
  1516.     // then calls HiliteMenu(0);
  1517.  
  1518.  
  1519.                                     
  1520. /* Helper APIs */
  1521. STDAPI_(Handle) OleDuplicateData (Handle hSrc, unsigned long cfFormat, 
  1522.                         unsigned short uiFlags);
  1523.  
  1524. STDAPI          OleDraw (LPUNKNOWN pUnknown, unsigned long dwAspect, GrafPtr pGrafDraw, 
  1525.                     LPCRECT lprcBounds); 
  1526.                         
  1527. STDAPI          OleRun(LPUNKNOWN pUnknown);
  1528. STDAPI_(unsigned long)   OleIsRunning(LPOLEOBJECT pObject);
  1529.  
  1530. STDAPI          OleLockRunning(LPUNKNOWN pUnknown, unsigned long fLock, unsigned long fLastUnlockCloses);
  1531.  
  1532. STDAPI_(void)   ReleaseStgMedium(LPSTGMEDIUM);
  1533. STDAPI          CreateOleAdviseHolder(LPLPOLEADVISEHOLDER ppOAHolder);
  1534.  
  1535. STDAPI          OleCreateDefaultHandler(REFCLSID clsid, LPUNKNOWN pUnkOuter,
  1536.                     REFIID riid, void * * lplpObj);
  1537.  
  1538. STDAPI          OleCreateEmbeddingHelper(REFCLSID clsid, LPUNKNOWN pUnkOuter,
  1539.                     unsigned long flags, LPCLASSFACTORY pCF,
  1540.                     REFIID riid, void ** lplpObj);
  1541.  
  1542. #ifdef MERGE
  1543. STDAPI_(BOOL)    IsAccelerator(HACCEL hAccel, int cAccelEntries, LPMSG lpMsg, 
  1544.                     WORD FAR* lpwCmd);
  1545. #endif
  1546.  
  1547.                     
  1548. /* Icon extraction Helper APIs */
  1549.                     
  1550. STDAPI_(PicHandle) OleGetIconOfFile(char * lpszPath, unsigned long fUseFileAsLabel);
  1551. STDAPI_(PicHandle) OleGetIconOfClass(REFCLSID rclsid,    char * lpszLabel, 
  1552.                                     unsigned long fUseTypeAsLabel);
  1553.  
  1554.  
  1555. /* Registration Database Helper APIs */
  1556.  
  1557. STDAPI             OleRegGetUserType (REFCLSID clsid, unsigned long dwFormOfType,
  1558.                     char ** pszUserType);
  1559.  
  1560. STDAPI             OleRegGetMiscStatus    (REFCLSID clsid, unsigned long dwAspect,
  1561.                     unsigned long* pdwStatus);
  1562.  
  1563. STDAPI             OleRegEnumFormatEtc    (REFCLSID clsid, unsigned long dwDirection,
  1564.                     LPLPENUMFORMATETC ppenum);
  1565.  
  1566. STDAPI             OleRegEnumVerbs    (REFCLSID clsid, LPLPENUMOLEVERB ppenum);
  1567.  
  1568.  
  1569.  
  1570. /* OLE 1.0 conversion APIS */
  1571.  
  1572. STDAPI OleConvertIStorageToOLESTREAM
  1573.     (LPSTORAGE            pstg,
  1574.      LPOLESTREAM        polestm);
  1575.  
  1576. STDAPI OleConvertOLESTREAMToIStorage
  1577.     (LPOLESTREAM                polestm,
  1578.     LPSTORAGE                   pstg,
  1579.     const DVTARGETDEVICE *   ptd);
  1580.  
  1581. STDAPI OleConvertIStorageToOLESTREAMEx
  1582.     (LPSTORAGE            pstg,
  1583.                                     // Presentation data to OLESTREAM
  1584.      unsigned long            cfFormat,    //        format
  1585.      long                lWidth,        //        width
  1586.      long                lHeight,    //        height
  1587.      unsigned long        dwSize,        //        size in bytes
  1588.      LPSTGMEDIUM        pmedium,    //        bits
  1589.      LPOLESTREAM        polestm);
  1590.  
  1591. STDAPI OleConvertOLESTREAMToIStorageEx
  1592.     (LPOLESTREAM        polestm,
  1593.      LPSTORAGE            pstg,
  1594.                                     // Presentation data from OLESTREAM
  1595.      unsigned long *    pcfFormat,    //        format
  1596.      long *            plwWidth,    //        width
  1597.      long *            plHeight,    //        height
  1598.      unsigned long *            pdwSize,    //        size in bytes
  1599.      LPSTGMEDIUM        pmedium);    //        bits
  1600.  
  1601.  
  1602.  
  1603. /* Storage Utility APIs */
  1604. STDAPI GetHGlobalFromILockBytes (LPLOCKBYTES plkbyt, Handle * phglobal);
  1605. STDAPI CreateILockBytesOnHGlobal (Handle hGlobal, unsigned long fDeleteOnRelease,
  1606.                                     LPLPLOCKBYTES pplkbyt);
  1607.  
  1608. STDAPI GetHGlobalFromStream (LPSTREAM pstm, Handle * phglobal);
  1609. STDAPI CreateStreamOnHGlobal (Handle hGlobal, unsigned long fDeleteOnRelease,
  1610.                                 LPLPSTREAM ppstm);
  1611.  
  1612.  
  1613. /* ConvertTo APIS */
  1614.  
  1615. STDAPI OleDoAutoConvert(LPSTORAGE pStg, LPCLSID pClsidNew);
  1616. STDAPI OleGetAutoConvert(REFCLSID clsidOld, LPCLSID pClsidNew);
  1617. STDAPI OleSetAutoConvert(REFCLSID clsidOld, REFCLSID clsidNew);
  1618. STDAPI GetConvertStg(LPSTORAGE pStg);
  1619. STDAPI SetConvertStg(LPSTORAGE pStg, unsigned long fConvert);
  1620.  
  1621. #ifndef __MACAPI__
  1622. #include <macapi.h>
  1623. #endif
  1624.  
  1625. #ifdef WLM
  1626. #include "macname2.h"
  1627. #endif // WLM
  1628.  
  1629. #endif /* !__OLE2__ */
  1630.  
  1631.