home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / com / activexcontrol / basectl / include / ctrlobj.h < prev    next >
C/C++ Source or Header  |  1997-10-05  |  25KB  |  523 lines
  1. //=--------------------------------------------------------------------------=
  2. // CtrlObj.H
  3. //=--------------------------------------------------------------------------=
  4. // Copyright 1995-1997 Microsoft Corporation.  All Rights Reserved.
  5. //
  6. // THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF 
  7. // ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO 
  8. // THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A 
  9. // PARTICULAR PURPOSE.
  10. //=--------------------------------------------------------------------------=
  11. //
  12. // class declaration for the COleControl object
  13. //
  14. #ifndef _CTRLOBJ_H_
  15.  
  16. // we need the automation object and ctlole.h
  17. //
  18. #include "AutoObj.H"
  19. #include <olectl.h>
  20.  
  21. // forward declaration
  22. //
  23. class COleControl;
  24.  
  25. //=--------------------------------------------------------------------------=
  26. // Misc Helper Functions
  27. //=--------------------------------------------------------------------------=
  28. //
  29. // given an Unknown pointer, get the COleControl * for it.  used typically
  30. // in property page code.
  31. //
  32. COleControl *ControlFromUnknown(IUnknown *);
  33.  
  34.  
  35. //=--------------------------------------------------------------------------=
  36. // Misc Constants
  37. //=--------------------------------------------------------------------------=
  38. // maximum number of arguments that can be sent to FireEvent()
  39. //
  40. #define MAX_ARGS    32
  41.  
  42. // for the types of sinks that the COleControl class has.  you shouldn't ever
  43. // need to use these
  44. //
  45. #define SINK_TYPE_EVENT      0
  46. #define SINK_TYPE_PROPNOTIFY 1
  47.  
  48. // superclass window support.  you can pass this in to DoSuperClassPaint
  49. //
  50. #define DRAW_SENDERASEBACKGROUND        1
  51.  
  52. //=--------------------------------------------------------------------------=
  53. // Various Hosts don't handle OLEIVERB_PROPERTIES correctly, so we can't use
  54. // that as our Properties verb number.  Instead, we're going to define
  55. // CTLIVERB_PROPERTIES as 1, and return that one in IOleObject::EnumVerbs,
  56. // but we'll still handle OLEIVERB_PROPERTIES correctly in DoVerb.
  57. //
  58. #define CTLIVERB_PROPERTIES     1
  59.  
  60.  
  61. //=--------------------------------------------------------------------------=
  62. // this structure is like the OLEVERB structure, except that it has a resource ID
  63. // instead of a string for the verb's name.  better support for localization.
  64. //
  65. typedef struct tagVERBINFO {
  66.  
  67.     LONG    lVerb;                // verb id
  68.     ULONG   idVerbName;           // resource ID of verb name
  69.     DWORD   fuFlags;              // verb flags
  70.     DWORD   grfAttribs;           // Specifies some combination of the verb attributes in the OLEVERBATTRIB enumeration.
  71.  
  72. } VERBINFO;
  73.  
  74. // describes an event
  75. //
  76. typedef struct tagEVENTINFO {
  77.  
  78.     DISPID    dispid;                    // dispid of the event
  79.     int       cParameters;               // number of arguments to the event
  80.     VARTYPE  *rgTypes;                   // type of each argument
  81.  
  82. } EVENTINFO;
  83.  
  84. //=--------------------------------------------------------------------------=
  85. // CONTROLOBJECTINFO
  86. //=--------------------------------------------------------------------------=
  87. // for each control you wish to expose to the programmer/user, you need to
  88. // declare and define one of the following structures.  the first part should
  89. // follow the rules of the AUTOMATIONOBJECTINFO structure.  it's pretty hard,
  90. // however, to imagine a scenario where the control isn't CoCreatable ...
  91. // once this structre is declared/defined, an entry should be put in the
  92. // global g_ObjectInfo table.
  93. //
  94. typedef struct {
  95.  
  96.     AUTOMATIONOBJECTINFO AutomationInfo;           // automation and creation information
  97.     const IID      *piidEvents;                    // IID of primary event interface
  98.     DWORD           dwOleMiscFlags;                // control flags
  99.     DWORD           dwActivationPolicy;            // IPointerInactive support
  100.     VARIANT_BOOL    fOpaque;                       // is your control 100% opaque?
  101.     VARIANT_BOOL    fWindowless;                   // do we do windowless if we can?
  102.     WORD            wToolboxId;                    // resource ID of Toolbox Bitmap
  103.     LPCSTR          szWndClass;                    // name of window control class
  104.     VARIANT_BOOL    fWindowClassRegistered;        // has the window class been registered yet?
  105.     WORD            cPropPages;                    // number of property pages
  106.     const GUID    **rgPropPageGuids;               // array of the property page GUIDs
  107.     WORD            cCustomVerbs;                  // number of custom verbs
  108.     const VERBINFO *rgCustomVerbs;                 // description of custom verbs
  109.     WNDPROC         pfnSubClass;                   // for subclassed controls.
  110.  
  111. } CONTROLOBJECTINFO;
  112.  
  113.  
  114. #ifndef INITOBJECTS
  115.  
  116. #define DEFINE_CONTROLOBJECT(name, clsid, progid, fn, ver, riid, pszh, piide, dwcf, dwap, w, szwc, cpp, rgppg, ccv, rgcv) \
  117. extern CONTROLOBJECTINFO name##Control \
  118.  
  119. #define DEFINE_WINDOWLESSCONTROLOBJECT(name, clsid, progid, fn, ver, riid, pszh, piide, dwcf, dwap, fo,  w, szwc, cpp, rgppg, ccv, rgcv) \
  120. extern CONTROLOBJECTINFO name##Control \
  121.  
  122.  
  123. #else
  124. #define DEFINE_CONTROLOBJECT(name, clsid, progid, fn, ver, riid, pszh, piide, dwcf, dwap, w, szwc, cpp, rgppg, ccv, rgcv) \
  125. CONTROLOBJECTINFO name##Control = { { {clsid, progid, fn}, ver, riid, pszh, NULL, 0}, piide, dwcf, dwap, TRUE, FALSE, w, szwc, FALSE, cpp, rgppg, ccv, rgcv, NULL } \
  126.  
  127. #define DEFINE_WINDOWLESSCONTROLOBJECT(name, clsid, progid, fn, ver, riid, pszh, piide, dwcf, dwap, fo, w, szwc, cpp, rgppg, ccv, rgcv) \
  128. CONTROLOBJECTINFO name##Control = { { {clsid, progid, fn}, ver, riid, pszh, NULL, 0}, piide, dwcf, dwap, fo, TRUE, w, szwc, FALSE, cpp, rgppg, ccv, rgcv, NULL } \
  129.  
  130. #endif // !INITOBJECTS
  131.  
  132. #define OLEMISCFLAGSOFCONTROL(index)     ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->dwOleMiscFlags
  133. #define FCONTROLISWINDOWLESS(index)      ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->fWindowless
  134. #define FCONTROLISOPAQUE(index)          ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->fOpaque
  135. #define ACTIVATIONPOLICYOFCONTROL(index) ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->dwActivationPolicy
  136. #define EVENTIIDOFCONTROL(index)         (*(((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->piidEvents))
  137. #define WNDCLASSNAMEOFCONTROL(index)     ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->szWndClass
  138. #define CPROPPAGESOFCONTROL(index)       ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->cPropPages
  139. #define PPROPPAGESOFCONTROL(index)       ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->rgPropPageGuids
  140. #define CCUSTOMVERBSOFCONTROL(index)     ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->cCustomVerbs
  141. #define CUSTOMVERBSOFCONTROL(index)      ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->rgCustomVerbs
  142. #define BITMAPIDOFCONTROL(index)         ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->wToolboxId
  143. #define CTLWNDCLASSREGISTERED(index)     ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->fWindowClassRegistered
  144. #define SUBCLASSWNDPROCOFCONTROL(index)  ((CONTROLOBJECTINFO *)(g_ObjectInfo[index].pInfo))->pfnSubClass
  145.  
  146.  
  147. //=--------------------------------------------------------------------------=
  148. // COleControl
  149. //=--------------------------------------------------------------------------=
  150. // the mother of all C++ objects
  151. //
  152. class COleControl : public CAutomationObject,
  153.                     public IOleObject, public IOleControl,
  154.                     public IOleInPlaceObjectWindowless, public IOleInPlaceActiveObject,
  155.                     public IViewObjectEx, public IPersistPropertyBag,
  156.                     public IPersistStreamInit, public IPersistStorage,
  157.                     public IConnectionPointContainer, public ISpecifyPropertyPages,
  158.                     public IProvideClassInfo, public IPointerInactive,
  159.                     public IQuickActivate
  160. {
  161.   public:
  162.     // IUnknown methods -- there are required since we inherit from variuos
  163.     // people who themselves inherit from IUnknown.  just delegate to controlling
  164.     // unknown
  165.     //
  166.     DECLARE_STANDARD_UNKNOWN();
  167.  
  168.     //=--------------------------------------------------------------------------=
  169.     // IPersist methods.  used by IPersistStream and IPersistStorage
  170.     //
  171.     STDMETHOD(GetClassID)(THIS_ LPCLSID lpClassID);
  172.  
  173.     // IPersistStreamInit methods
  174.     //
  175.     STDMETHOD(IsDirty)(THIS);
  176.     STDMETHOD(Load)(LPSTREAM pStm);
  177.     STDMETHOD(Save)(LPSTREAM pStm, BOOL fClearDirty);
  178.     STDMETHOD(GetSizeMax)(ULARGE_INTEGER FAR* pcbSize);
  179.     STDMETHOD(InitNew)();
  180.  
  181.     // IPersistStorage
  182.     //
  183.     STDMETHOD(InitNew)(IStorage  *pStg);
  184.     STDMETHOD(Load)(IStorage  *pStg);
  185.     STDMETHOD(Save)(IStorage  *pStgSave, BOOL fSameAsLoad);
  186.     STDMETHOD(SaveCompleted)(IStorage  *pStgNew);
  187.     STDMETHOD(HandsOffStorage)(void);
  188.  
  189.     // IPersistPropertyBag
  190.     //
  191.     STDMETHOD(Load)(LPPROPERTYBAG pPropBag, LPERRORLOG pErrorLog);
  192.     STDMETHOD(Save)(LPPROPERTYBAG pPropBag, BOOL fClearDirty,
  193.                     BOOL fSaveAllProperties);
  194.  
  195.     // IOleControl methods
  196.     //
  197.     STDMETHOD(GetControlInfo)(LPCONTROLINFO pCI);
  198.     STDMETHOD(OnMnemonic)(LPMSG pMsg);
  199.     STDMETHOD(OnAmbientPropertyChange)(DISPID dispid);
  200.     STDMETHOD(FreezeEvents)(BOOL bFreeze);
  201.  
  202.     // IOleObject methods
  203.     //
  204.     STDMETHOD(SetClientSite)(IOleClientSite  *pClientSite);
  205.     STDMETHOD(GetClientSite)(IOleClientSite  * *ppClientSite);
  206.     STDMETHOD(SetHostNames)(LPCOLESTR szContainerApp, LPCOLESTR szContainerObj);
  207.     STDMETHOD(Close)(DWORD dwSaveOption);
  208.     STDMETHOD(SetMoniker)(DWORD dwWhichMoniker, IMoniker  *pmk);
  209.     STDMETHOD(GetMoniker)(DWORD dwAssign, DWORD dwWhichMoniker, IMoniker  * *ppmk);
  210.     STDMETHOD(InitFromData)(IDataObject  *pDataObject, BOOL fCreation, DWORD dwReserved);
  211.     STDMETHOD(GetClipboardData)(DWORD dwReserved, IDataObject  * *ppDataObject);
  212.     STDMETHOD(DoVerb)(LONG iVerb, LPMSG lpmsg, IOleClientSite  *pActiveSite, LONG lindex,
  213.                                      HWND hwndParent, LPCRECT lprcPosRect);
  214.     STDMETHOD(EnumVerbs)(IEnumOLEVERB  * *ppEnumOleVerb);
  215.     STDMETHOD(Update)(void);
  216.     STDMETHOD(IsUpToDate)(void);
  217.     STDMETHOD(GetUserClassID)(CLSID  *pClsid);
  218.     STDMETHOD(GetUserType)(DWORD dwFormOfType, LPOLESTR  *pszUserType);
  219.     STDMETHOD(SetExtent)(DWORD dwDrawAspect,SIZEL  *psizel);
  220.     STDMETHOD(GetExtent)(DWORD dwDrawAspect, SIZEL  *psizel);
  221.     STDMETHOD(Advise)(IAdviseSink  *pAdvSink, DWORD  *pdwConnection);
  222.     STDMETHOD(Unadvise)(DWORD dwConnection);
  223.     STDMETHOD(EnumAdvise)(IEnumSTATDATA  * *ppenumAdvise);
  224.     STDMETHOD(GetMiscStatus)(DWORD dwAspect, DWORD  *pdwStatus);
  225.     STDMETHOD(SetColorScheme)(LOGPALETTE  *pLogpal);
  226.  
  227.     // IOleWindow.  required for IOleInPlaceObject and IOleInPlaceActiveObject
  228.     //
  229.     STDMETHOD(GetWindow)(HWND *phwnd);
  230.     STDMETHOD(ContextSensitiveHelp)(BOOL fEnterMode);
  231.  
  232.     // IOleInPlaceObject/IOleInPlaceObjectWindowless
  233.     //
  234.     STDMETHOD(InPlaceDeactivate)(void);
  235.     STDMETHOD(UIDeactivate)(void);
  236.     STDMETHOD(SetObjectRects)(LPCRECT lprcPosRect,LPCRECT lprcClipRect) ;
  237.     STDMETHOD(ReactivateAndUndo)(void);
  238.     STDMETHOD(OnWindowMessage)(UINT msg, WPARAM wParam, LPARAM lParam, LRESULT *plResult);
  239.     STDMETHOD(GetDropTarget)(IDropTarget **ppDropTarget);
  240.  
  241.     // IOleInPlaceActiveObject
  242.     //
  243.     STDMETHOD(TranslateAccelerator)(LPMSG lpmsg);
  244.     STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);
  245.     STDMETHOD(OnDocWindowActivate)(BOOL fActivate);
  246.     STDMETHOD(ResizeBorder)(LPCRECT prcBorder,
  247.                             IOleInPlaceUIWindow  *pUIWindow,
  248.                             BOOL fFrameWindow);
  249.     STDMETHOD(EnableModeless)(BOOL fEnable);
  250.  
  251.     // IViewObject2/IViewObjectEx
  252.     //
  253.     STDMETHOD(Draw)(DWORD dwDrawAspect, LONG lindex, void  *pvAspect,
  254.                     DVTARGETDEVICE  *ptd, HDC hdcTargetDev, HDC hdcDraw,
  255.                     LPCRECTL lprcBounds, LPCRECTL lprcWBounds,
  256.                     BOOL ( __stdcall  *pfnContinue )(DWORD dwContinue),
  257.                     DWORD dwContinue);
  258.     STDMETHOD(GetColorSet)(DWORD dwDrawAspect,LONG lindex, void  *pvAspect,
  259.                            DVTARGETDEVICE  *ptd, HDC hicTargetDev,
  260.                            LOGPALETTE  * *ppColorSet);
  261.     STDMETHOD(Freeze)(DWORD dwDrawAspect, LONG lindex,
  262.                       void  *pvAspect,DWORD  *pdwFreeze);
  263.     STDMETHOD(Unfreeze)(DWORD dwFreeze);
  264.     STDMETHOD(SetAdvise)(DWORD aspects, DWORD advf, IAdviseSink  *pAdvSink);
  265.     STDMETHOD(GetAdvise)(DWORD *pAspects, DWORD  *pAdvf, IAdviseSink  * *ppAdvSink);
  266.     STDMETHOD(GetExtent)(DWORD dwDrawAspect, LONG lindex, DVTARGETDEVICE __RPC_FAR *ptd, LPSIZEL lpsizel);
  267.     STDMETHOD(GetRect)(DWORD dwAspect, LPRECTL pRect);
  268.     STDMETHOD(GetViewStatus)(DWORD *pdwStatus);
  269.     STDMETHOD(QueryHitPoint)(DWORD dwAspect, LPCRECT pRectBounds, POINT ptlLoc, LONG lCloseHint, DWORD *pHitResult);
  270.     STDMETHOD(QueryHitRect)(DWORD dwAspect, LPCRECT pRectBounds, LPCRECT prcLoc, LONG lCloseHint, DWORD *pHitResult);
  271.     STDMETHOD(GetNaturalExtent)(DWORD dwAspect, LONG lindex, DVTARGETDEVICE *ptd, HDC hicTargetDev, DVEXTENTINFO *pExtentInfo, LPSIZEL psizel);
  272.  
  273.     // IConnectionPointContainer methods
  274.     //
  275.     STDMETHOD(EnumConnectionPoints)(LPENUMCONNECTIONPOINTS FAR* ppEnum);
  276.     STDMETHOD(FindConnectionPoint)(REFIID iid, LPCONNECTIONPOINT FAR* ppCP);
  277.  
  278.     // ISpecifyPropertyPages
  279.     //
  280.     STDMETHOD(GetPages)(CAUUID * pPages);
  281.  
  282.     // IProvideClassInfo methods
  283.     //
  284.     STDMETHOD(GetClassInfo)(LPTYPEINFO * ppTI);
  285.  
  286.     // IPointerInactive methods
  287.     //
  288.     STDMETHOD(GetActivationPolicy)(DWORD *pdwPolicy);
  289.     STDMETHOD(OnInactiveMouseMove)(LPCRECT pRectBounds, long x, long y, DWORD dwMouseMsg);
  290.     STDMETHOD(OnInactiveSetCursor)(LPCRECT pRectBounds, long x, long y, DWORD dwMouseMsg, BOOL fSetAlways);
  291.  
  292.     // IQuickActivate methods
  293.     //
  294.     STDMETHOD(QuickActivate)(QACONTAINER *pqacontainer, QACONTROL *pqacontrol);
  295.     STDMETHOD(SetContentExtent)(LPSIZEL);
  296.     STDMETHOD(GetContentExtent)(LPSIZEL);
  297.  
  298.     // constructor and destructor
  299.     //
  300.     COleControl(IUnknown *pUnkOuter, int iPrimaryDispatch, void *pMainInterface, 
  301.         BOOL fExpandoEnabled=FALSE);
  302.     virtual ~COleControl();
  303.  
  304.     //=--------------------------------------------------------------------------=
  305.     // callable by anybody
  306.     //
  307.     static LRESULT CALLBACK ControlWindowProc(HWND hwnd, UINT msg, WPARAM wp, LPARAM lp);
  308.     static LRESULT CALLBACK ReflectWindowProc(HWND hwnd, UINT msg, WPARAM wp, LPARAM lp);
  309.     static COleControl * ControlFromHwnd(HWND hwnd) {
  310.         return (COleControl *) GetWindowLong(hwnd, GWL_USERDATA);
  311.     }
  312.  
  313.     void __cdecl FireEvent(EVENTINFO * pEventInfo, ...);
  314.     HINSTANCE    GetResourceHandle(void);
  315.  
  316.  
  317.     //=--------------------------------------------------------------------------=
  318.     // ole controls that want to support both windowed and windowless operations
  319.     // should use these wrappers instead of the appropriate win32 api routine.
  320.     // controls that don't care and just want to be windowed all the time can
  321.     // just go ahead and use the api routines.
  322.     //
  323.     BOOL    SetFocus(BOOL fGrab);                       // SetFocus API
  324.     BOOL    OcxGetFocus(void);                          // GetFocus() == m_hwnd
  325.     BOOL    OcxGetWindowRect(LPRECT);                   // gets your current window rect
  326.     LRESULT OcxDefWindowProc(UINT, WPARAM, LPARAM);     // DefWindowProc
  327.     HDC     OcxGetDC(void);                             // GetDC(m_hwnd);
  328.     void    OcxReleaseDC(HDC hdc);                      // ReleaseDC(m_hwnd, hdc);
  329.     BOOL    OcxSetCapture(BOOL fGrab);                  // SetCapture(fGrab ? m_hwnd : NULL);
  330.     BOOL    OcxGetCapture(void);                        // GetCapture() == m_hwnd
  331.     BOOL    OcxInvalidateRect(LPCRECT, BOOL);           // InvalidateRect(m_hwnd, prc, f);
  332.     BOOL    OcxScrollRect(LPCRECT, LPCRECT, int, int);  // ScrollWindowEx(...);
  333.  
  334.   protected:
  335.  
  336.     //=--------------------------------------------------------------------------=
  337.     // member variables that derived controls can get at.
  338.     //
  339.     // derived controls Should NOT modify the following.
  340.     //
  341.     IOleClientSite     *m_pClientSite;             // client site
  342.     IOleControlSite    *m_pControlSite;            // IOleControlSite ptr on client site
  343.     IOleInPlaceSite    *m_pInPlaceSite;            // IOleInPlaceSite for managing activation
  344.     IOleInPlaceFrame   *m_pInPlaceFrame;           // IOleInPlaceFrame ptr on client site
  345.     IOleInPlaceUIWindow *m_pInPlaceUIWindow;       // for negotiating border space with client
  346.     ISimpleFrameSite   *m_pSimpleFrameSite;        // simple frame site
  347.     IDispatch          *m_pDispAmbient;            // ambient dispatch pointer
  348.     SIZEL               m_Size;                    // the size of this control    
  349.     RECT                m_rcLocation;              // where we at
  350.     HWND                m_hwnd;                    // our window
  351.     HWND                m_hwndParent;              // our parent window
  352.     HRGN                m_hRgn;
  353.  
  354.     // Windowless OLE controls support
  355.     //
  356.     IOleInPlaceSiteWindowless *m_pInPlaceSiteWndless; // IOleInPlaceSiteWindowless pointer
  357.  
  358.     // flags indicating internal state.  do not modify.
  359.     //
  360.     unsigned m_fDirty:1;                           // does the control need to be resaved?
  361.     unsigned m_fInPlaceActive:1;                   // are we in place active or not?
  362.     unsigned m_fInPlaceVisible:1;                  // we are in place visible or not?
  363.     unsigned m_fUIActive:1;                        // are we UI active or not.
  364.     unsigned m_fCreatingWindow:1;                  // indicates if we're in CreateWindowEx or not
  365.  
  366.     //=--------------------------------------------------------------------------=
  367.     // methods that derived controls can override, but may need to be called
  368.     // from their versions.
  369.     //
  370.     virtual void      ViewChanged(void);
  371.     virtual HRESULT   InternalQueryInterface(REFIID riid, void **ppvObjOut);
  372.     virtual BOOL      SetGUIFocus(HWND hwndSet);
  373.  
  374.     //=--------------------------------------------------------------------------=
  375.     // member functions that provide for derived controls, or that we use, but
  376.     // derived controls might still find useful.
  377.     //
  378.     HRESULT      DoSuperClassPaint(HDC, LPCRECTL);
  379.     HRESULT      RecreateControlWindow(void);
  380.     BOOL         DesignMode(void);
  381.     BOOL         GetAmbientProperty(DISPID, VARTYPE, void *);
  382.     BOOL         GetAmbientFont(IFont **ppFontOut);
  383.     void         ModalDialog(BOOL fShow);
  384.     void         InvalidateControl(LPCRECT prc);    
  385.     BOOL         SetControlSize(SIZEL *pSizel);
  386.  
  387.     HWND         CreateInPlaceWindow(int x, int y, BOOL fNoRedraw);
  388.     HRESULT      InPlaceActivate(LONG lVerb);
  389.     void         SetInPlaceVisible(BOOL);
  390.     void         SetInPlaceParent(HWND);
  391.  
  392.     // IPropertyNotifySink stuff.
  393.     //
  394.     inline void  PropertyChanged(DISPID dispid) {
  395.         m_cpPropNotify.DoOnChanged(dispid);
  396.     }
  397.     inline BOOL  RequestPropertyEdit(DISPID dispid) {
  398.         return m_cpPropNotify.DoOnRequestEdit(dispid);
  399.     }
  400.  
  401.     // subclassed windows controls support ...
  402.     //
  403.     inline HWND  GetOuterWindow(void) {
  404.         return (m_hwndReflect) ? m_hwndReflect : m_hwnd;
  405.     }
  406.  
  407.     // little routine for people to tell if they are windowless or not
  408.     //
  409.     inline BOOL  Windowless(void) {
  410.         return !m_fInPlaceActive || m_pInPlaceSiteWndless;
  411.     }
  412.  
  413.     // some people don't care if they're windowed or not -- they just need
  414.     // a site pointer.  this makes it a little easier.
  415.     //
  416.     inline IOleInPlaceSite    *GetInPlaceSite(void) {
  417.         return (IOleInPlaceSite *)(m_pInPlaceSiteWndless ? m_pInPlaceSiteWndless : m_pInPlaceSite);
  418.     }
  419.  
  420.   private:
  421.     //=--------------------------------------------------------------------------=
  422.     // the following are methods that ALL control writers must override and implement
  423.     //
  424.     STDMETHOD(LoadBinaryState)(IStream *pStream) PURE;
  425.     STDMETHOD(SaveBinaryState)(IStream *pStream) PURE;
  426.     STDMETHOD(LoadTextState)(IPropertyBag *pPropertyBag, IErrorLog *pErrorLog) PURE;
  427.     STDMETHOD(SaveTextState)(IPropertyBag *pPropertyBag, BOOL fWriteDefault) PURE;
  428.     STDMETHOD(OnDraw)(DWORD dvAspect, HDC hdcDraw, LPCRECTL prcBounds, LPCRECTL prcWBounds, HDC hicTargetDev, BOOL fOptimize) PURE;
  429.     virtual LRESULT WindowProc(UINT msg, WPARAM wParam, LPARAM lParam) PURE;
  430.     virtual BOOL    RegisterClassData(void) PURE;
  431.  
  432.     //=--------------------------------------------------------------------------=
  433.     // OVERRIDABLES -- methods controls can implement for customized functionality
  434.     //
  435.     virtual void    AmbientPropertyChanged(DISPID dispid);
  436.     virtual BOOL    BeforeCreateWindow(DWORD *, DWORD *, LPSTR);
  437.     virtual void    BeforeDestroyWindow(void);
  438.     virtual HRESULT DoCustomVerb(LONG lVerb);
  439.     virtual BOOL    OnSetExtent(const SIZEL *pSizeL);
  440.     virtual BOOL    OnSpecialKey(LPMSG);
  441.     virtual BOOL    OnGetPalette(HDC, LOGPALETTE **);
  442.     virtual HRESULT OnQuickActivate(QACONTAINER *, DWORD *);
  443.     virtual BOOL    InitializeNewState();
  444.     virtual BOOL    AfterCreateWindow(void);
  445.     virtual BOOL    OnGetRect(DWORD dvAspect, LPRECTL prcRect);
  446.     virtual void    OnSetObjectRectsChangingWindowPos(DWORD *dwFlag);
  447.     virtual void    OnVerb(LONG lVerb);
  448.  
  449.     //=--------------------------------------------------------------------------=
  450.     // methods that various people internally will share.  not needed, however, by
  451.     // any inherting classes.
  452.     //
  453.     HRESULT         m_SaveToStream(IStream *pStream);
  454.     HRESULT         LoadStandardState(IPropertyBag *pPropertyBag, IErrorLog *pErrorLog);
  455.     HRESULT         LoadStandardState(IStream *pStream);
  456.     HRESULT         SaveStandardState(IPropertyBag *pPropertyBag);
  457.     HRESULT         SaveStandardState(IStream *pStream);
  458.  
  459.     //=--------------------------------------------------------------------------=
  460.     // member variables we don't want anybody to get their hands on, including
  461.     // inheriting classes
  462.     //
  463.     HWND              m_hwndReflect;               // for subclassed windows
  464.     IOleAdviseHolder *m_pOleAdviseHolder;          // IOleObject::Advise holder object
  465.     IAdviseSink      *m_pViewAdviseSink;           // IViewAdvise sink for IViewObject2
  466.     unsigned short    m_nFreezeEvents;             // count of freezes versus thaws
  467.     unsigned          m_fHostReflects:1;           // does the host reflect messages?
  468.     unsigned          m_fCheckedReflecting:1;      // have we checked above yet?
  469.  
  470.     // internal flags.  various other flags are visible to the end control class.
  471.     //
  472.     unsigned m_fModeFlagValid:1;                   // we stash the mode as much as possible
  473.     unsigned m_fSaveSucceeded:1;                   // did an IStorage save work correctly?
  474.     unsigned m_fViewAdvisePrimeFirst: 1;           // for IViewobject2::setadvise
  475.     unsigned m_fViewAdviseOnlyOnce: 1;             // for iviewobject2::setadvise
  476.     unsigned m_fUsingWindowRgn:1;                  // for SetObjectRects and clipping
  477.     unsigned m_fRunMode:1;                         // are we in run mode or not?
  478.  
  479.     class CConnectionPoint : public IConnectionPoint {
  480.       public:
  481.         IUnknown **m_rgSinks;
  482.  
  483.         // IUnknown methods
  484.         //
  485.         STDMETHOD(QueryInterface)(THIS_ REFIID riid, LPVOID FAR* ppvObj) ;
  486.         STDMETHOD_(ULONG,AddRef)(THIS) ;
  487.         STDMETHOD_(ULONG,Release)(THIS) ;
  488.  
  489.         // IConnectionPoint methods
  490.         //
  491.         STDMETHOD(GetConnectionInterface)(IID FAR* pIID);
  492.         STDMETHOD(GetConnectionPointContainer)(IConnectionPointContainer FAR* FAR* ppCPC);
  493.         STDMETHOD(Advise)(LPUNKNOWN pUnkSink, DWORD FAR* pdwCookie);
  494.         STDMETHOD(Unadvise)(DWORD dwCookie);
  495.         STDMETHOD(EnumConnections)(LPENUMCONNECTIONS FAR* ppEnum);
  496.  
  497.         void    DoInvoke(DISPID dispid, DISPPARAMS * pdispparam);
  498.         void    DoOnChanged(DISPID dispid);
  499.         BOOL    DoOnRequestEdit(DISPID dispid);
  500.         HRESULT AddSink(void *, DWORD *);
  501.  
  502.         COleControl *m_pOleControl();
  503.         CConnectionPoint(BYTE b){
  504.             m_bType = b;
  505.             m_rgSinks = NULL;
  506.             m_cSinks = 0;
  507.         }
  508.         ~CConnectionPoint();
  509.  
  510.       private:
  511.         BYTE   m_bType;
  512.         short  m_cSinks;
  513.  
  514.     } m_cpEvents, m_cpPropNotify;
  515.  
  516.     // so they can get at some of our protected things, like AddRef, QI, etc.
  517.     //
  518.     friend CConnectionPoint;
  519. };
  520.  
  521. #define _CTRLOBJ_H_
  522. #endif // _CTRLOBJ_H_
  523.