145 lines
5.3 KiB
C
145 lines
5.3 KiB
C
|
//=--------------------------------------------------------------------------=
|
||
|
|
// PropertyPages.H
|
||
|
|
//=--------------------------------------------------------------------------=
|
||
|
|
// Copyright 1995 Microsoft Corporation. All Rights Reserved.
|
||
|
|
//
|
||
|
|
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
|
||
|
|
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
|
||
|
|
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
|
||
|
|
// PARTICULAR PURPOSE.
|
||
|
|
//=--------------------------------------------------------------------------=
|
||
|
|
//
|
||
|
|
// class declaration for CPropertyPage.
|
||
|
|
//
|
||
|
|
#ifndef _PROPERTYPAGES_H_
|
||
|
|
|
||
|
|
// things we really need
|
||
|
|
//
|
||
|
|
#include "Unknown.H"
|
||
|
|
#include <olectl.h>
|
||
|
|
#include "LocalSrv.H"
|
||
|
|
|
||
|
|
//=--------------------------------------------------------------------------=
|
||
|
|
// messages that we'll send to property pages to instruct them to accomplish
|
||
|
|
// tasks.
|
||
|
|
//
|
||
|
|
#define PPM_NEWOBJECTS (WM_USER + 100)
|
||
|
|
#define PPM_APPLY (WM_USER + 101)
|
||
|
|
#define PPM_EDITPROPERTY (WM_USER + 102)
|
||
|
|
#define PPM_FREEOBJECTS (WM_USER + 103)
|
||
|
|
|
||
|
|
//=--------------------------------------------------------------------------=
|
||
|
|
// structure that control writers will use to define property pages.
|
||
|
|
//
|
||
|
|
typedef struct tagPROPERTYPAGEINFO {
|
||
|
|
|
||
|
|
UNKNOWNOBJECTINFO unknowninfo;
|
||
|
|
WORD wDlgResourceId;
|
||
|
|
WORD wTitleId;
|
||
|
|
WORD wDocStringId;
|
||
|
|
LPCSTR szHelpFile;
|
||
|
|
DWORD dwHelpContextId;
|
||
|
|
|
||
|
|
} PROPERTYPAGEINFO;
|
||
|
|
|
||
|
|
#ifndef INITOBJECTS
|
||
|
|
|
||
|
|
#define DEFINE_PROPERTYPAGEOBJECT(name, pclsid, pszon, pfn, wr, wt, wd, pszhf, dwhci) \
|
||
|
|
extern PROPERTYPAGEINFO name##Page \
|
||
|
|
|
||
|
|
#define DEFINE_PROPERTYPAGEOBJECT2(name, pclsid, pszon, pfn, wr, wt, wd, pszhf, dwhci, fthreadsafe) \
|
||
|
|
extern PROPERTYPAGEINFO name##Page \
|
||
|
|
|
||
|
|
#else // INITOBJECTS
|
||
|
|
|
||
|
|
#define DEFINE_PROPERTYPAGEOBJECT(name, pclsid, pszon, pfn, wr, wt, wd, pszhf, dwhci) \
|
||
|
|
PROPERTYPAGEINFO name##Page = { {pclsid, pszon, NULL, TRUE, pfn }, wr, wt, wd, pszhf, dwhci } \
|
||
|
|
|
||
|
|
#define DEFINE_PROPERTYPAGEOBJECT2(name, pclsid, pszon, pfn, wr, wt, wd, pszhf, dwhci, fthreadsafe) \
|
||
|
|
PROPERTYPAGEINFO name##Page = { {pclsid, pszon, NULL, fthreadsafe, pfn }, wr, wt, wd, pszhf, dwhci } \
|
||
|
|
|
||
|
|
#endif // INITOBJECTS
|
||
|
|
|
||
|
|
|
||
|
|
#define TEMPLATENAMEOFPROPPAGE(index) MAKEINTRESOURCE(((PROPERTYPAGEINFO *)(g_ObjectInfo[index].pInfo))->wDlgResourceId)
|
||
|
|
#define TITLEIDOFPROPPAGE(index) (((PROPERTYPAGEINFO *)(g_ObjectInfo[index].pInfo))->wTitleId)
|
||
|
|
#define DOCSTRINGIDOFPROPPAGE(index) (((PROPERTYPAGEINFO *)(g_ObjectInfo[index].pInfo))->wDocStringId)
|
||
|
|
#define HELPCONTEXTOFPROPPAGE(index) (((PROPERTYPAGEINFO *)(g_ObjectInfo[index].pInfo))->dwHelpContextId)
|
||
|
|
#define HELPFILEOFPROPPAGE(index) (((PROPERTYPAGEINFO *)(g_ObjectInfo[index].pInfo))->szHelpFile)
|
||
|
|
|
||
|
|
//=--------------------------------------------------------------------------=
|
||
|
|
//
|
||
|
|
class CPropertyPage : public CUnknownObject,
|
||
|
|
public IPropertyPage2 {
|
||
|
|
|
||
|
|
public:
|
||
|
|
// IUnknown methods
|
||
|
|
//
|
||
|
|
DECLARE_STANDARD_UNKNOWN();
|
||
|
|
|
||
|
|
// IPropertyPage methods
|
||
|
|
//
|
||
|
|
STDMETHOD(SetPageSite)(LPPROPERTYPAGESITE pPageSite);
|
||
|
|
STDMETHOD(Activate)(HWND hwndParent, LPCRECT lprc, BOOL bModal);
|
||
|
|
STDMETHOD(Deactivate)(void);
|
||
|
|
STDMETHOD(GetPageInfo)(LPPROPPAGEINFO pPageInfo);
|
||
|
|
STDMETHOD(SetObjects)(ULONG cObjects, LPUNKNOWN FAR* ppunk);
|
||
|
|
STDMETHOD(Show)(UINT nCmdShow);
|
||
|
|
STDMETHOD(Move)(LPCRECT prect);
|
||
|
|
STDMETHOD(IsPageDirty)(void);
|
||
|
|
STDMETHOD(Apply)(void);
|
||
|
|
STDMETHOD(Help)(LPCOLESTR lpszHelpDir);
|
||
|
|
STDMETHOD(TranslateAccelerator)(LPMSG lpMsg);
|
||
|
|
|
||
|
|
// IPropertyPage2 methods
|
||
|
|
//
|
||
|
|
STDMETHOD(EditProperty)(THIS_ DISPID dispid);
|
||
|
|
|
||
|
|
// constructor destructor
|
||
|
|
//
|
||
|
|
CPropertyPage(IUnknown *pUnkOuter, int iObjectType);
|
||
|
|
virtual ~CPropertyPage();
|
||
|
|
|
||
|
|
HINSTANCE GetResourceHandle(void); // returns current resource handle.
|
||
|
|
|
||
|
|
protected:
|
||
|
|
IPropertyPageSite *m_pPropertyPageSite; // pointer to our ppage site.
|
||
|
|
void MakeDirty(); // makes the property page dirty.
|
||
|
|
HWND m_hwnd; // our hwnd.
|
||
|
|
|
||
|
|
// the following two methods allow a property page implementer to get at all the
|
||
|
|
// objects that we need to set here.
|
||
|
|
//
|
||
|
|
IUnknown *FirstControl(DWORD *dwCookie);
|
||
|
|
IUnknown *NextControl(DWORD *dwCookie);
|
||
|
|
|
||
|
|
virtual HRESULT InternalQueryInterface(REFIID, void **);
|
||
|
|
|
||
|
|
int m_ObjectType; // what type of object we are
|
||
|
|
|
||
|
|
private:
|
||
|
|
IUnknown **m_ppUnkObjects; // objects that we're working with.
|
||
|
|
|
||
|
|
unsigned m_fActivated:1;
|
||
|
|
unsigned m_fDirty:1;
|
||
|
|
unsigned m_fDeactivating:1; // Set when the page is deactivating. This helps prevent
|
||
|
|
// unnecessary calls to IPropertyPageSite::OnStatusChange
|
||
|
|
|
||
|
|
UINT m_cObjects; // how many objects we're holding on to
|
||
|
|
|
||
|
|
void ReleaseAllObjects(void); // clears out all objects we've got.
|
||
|
|
HRESULT EnsureLoaded(void); // forces the load of the page.
|
||
|
|
HRESULT NewObjects(void); // Notifies page to initialize its fields with prop vals
|
||
|
|
|
||
|
|
// default dialog proc for a page.
|
||
|
|
//
|
||
|
|
static BOOL CALLBACK PropPageDlgProc(HWND, UINT, WPARAM, LPARAM);
|
||
|
|
|
||
|
|
// all page implementers MUST implement the following function.
|
||
|
|
//
|
||
|
|
virtual BOOL DialogProc(HWND, UINT, WPARAM, LPARAM) PURE;
|
||
|
|
};
|
||
|
|
|
||
|
|
#define _PROPERTYPAGES_H_
|
||
|
|
#endif // _PROPERTYPAGES_H_
|