368 lines
11 KiB
C
368 lines
11 KiB
C
/*****************************************************************************\
|
|
* *
|
|
* dvobj.h - Data/view value types, interface and APIs *
|
|
* *
|
|
* Version 1.0 *
|
|
* *
|
|
* Copyright (c) 1993-1994, Microsoft Corp. All rights reserved. *
|
|
* *
|
|
\*****************************************************************************/
|
|
|
|
#if !defined( _DVOBJ_H_ )
|
|
#define _DVOBJ_H_
|
|
|
|
/****** DV value types ******************************************************/
|
|
|
|
// forward type declarations
|
|
#if defined(__cplusplus)
|
|
interface IStorage;
|
|
interface IStream;
|
|
interface IAdviseSink;
|
|
interface IMoniker;
|
|
#else
|
|
typedef interface IStorage IStorage;
|
|
typedef interface IStream IStream;
|
|
typedef interface IAdviseSink IAdviseSink;
|
|
typedef interface IMoniker IMoniker;
|
|
#endif
|
|
|
|
typedef IStorage FAR* LPSTORAGE;
|
|
typedef IStream FAR* LPSTREAM;
|
|
typedef IAdviseSink FAR* LPADVISESINK;
|
|
typedef IMoniker FAR* LPMONIKER;
|
|
|
|
|
|
#if !defined(_MAC)
|
|
typedef WORD CLIPFORMAT;
|
|
#else
|
|
typedef unsigned long CLIPFORMAT; // ResType
|
|
#endif
|
|
typedef CLIPFORMAT FAR* LPCLIPFORMAT;
|
|
|
|
|
|
// Data/View aspect; specifies the desired aspect of the object when
|
|
// drawing or getting data.
|
|
typedef enum tagDVASPECT
|
|
{
|
|
DVASPECT_CONTENT = 1,
|
|
DVASPECT_THUMBNAIL = 2,
|
|
DVASPECT_ICON = 4,
|
|
DVASPECT_DOCPRINT = 8
|
|
} DVASPECT;
|
|
|
|
|
|
// Data/View target device; determines the device for drawing or gettting data
|
|
typedef struct FARSTRUCT tagDVTARGETDEVICE
|
|
{
|
|
DWORD tdSize;
|
|
WORD tdDriverNameOffset;
|
|
WORD tdDeviceNameOffset;
|
|
WORD tdPortNameOffset;
|
|
WORD tdExtDevmodeOffset;
|
|
BYTE tdData[1];
|
|
} DVTARGETDEVICE;
|
|
|
|
|
|
// Format, etc.; completely specifices the kind of data desired, including tymed
|
|
typedef struct FARSTRUCT tagFORMATETC
|
|
{
|
|
CLIPFORMAT cfFormat;
|
|
DVTARGETDEVICE FAR* ptd;
|
|
DWORD dwAspect;
|
|
LONG lindex;
|
|
DWORD tymed;
|
|
} FORMATETC, FAR* LPFORMATETC;
|
|
|
|
|
|
// TYpes of storage MEDiums; determines how data is stored or passed around
|
|
typedef enum tagTYMED
|
|
{
|
|
TYMED_HGLOBAL = 1,
|
|
TYMED_FILE = 2,
|
|
TYMED_ISTREAM = 4,
|
|
TYMED_ISTORAGE = 8,
|
|
TYMED_GDI = 16,
|
|
TYMED_MFPICT = 32,
|
|
TYMED_NULL = 0
|
|
} TYMED;
|
|
|
|
|
|
// DATA format DIRection
|
|
typedef enum tagDATADIR
|
|
{
|
|
DATADIR_GET = 1,
|
|
DATADIR_SET = 2,
|
|
} DATADIR;
|
|
|
|
|
|
// SToraGe MEDIUM; a block of data on a particular medium
|
|
typedef struct FARSTRUCT tagSTGMEDIUM
|
|
{
|
|
DWORD tymed;
|
|
union
|
|
{
|
|
HANDLE hGlobal;
|
|
LPSTR lpszFileName;
|
|
IStream FAR* pstm;
|
|
IStorage FAR* pstg;
|
|
}
|
|
#ifdef NONAMELESSUNION
|
|
u // add a tag when name less unions not supported
|
|
#endif
|
|
;
|
|
IUnknown FAR* pUnkForRelease;
|
|
} STGMEDIUM, FAR* LPSTGMEDIUM;
|
|
|
|
|
|
// Advise Flags
|
|
typedef enum tagADVF
|
|
{
|
|
ADVF_NODATA = 1,
|
|
ADVF_PRIMEFIRST = 2,
|
|
ADVF_ONLYONCE = 4,
|
|
ADVF_DATAONSTOP = 64,
|
|
ADVFCACHE_NOHANDLER = 8,
|
|
ADVFCACHE_FORCEBUILTIN = 16,
|
|
ADVFCACHE_ONSAVE = 32
|
|
} ADVF;
|
|
|
|
|
|
// Stats for data; used by several enumerations and by at least one
|
|
// implementation of IDataAdviseHolder; if a field is not used, it
|
|
// will be NULL.
|
|
typedef struct FARSTRUCT tagSTATDATA
|
|
{ // field used by:
|
|
FORMATETC formatetc; // EnumAdvise, EnumData (cache), EnumFormats
|
|
DWORD advf; // EnumAdvise, EnumData (cache)
|
|
IAdviseSink FAR* pAdvSink; // EnumAdvise
|
|
DWORD dwConnection; // EnumAdvise
|
|
} STATDATA;
|
|
|
|
typedef STATDATA FAR* LPSTATDATA;
|
|
|
|
|
|
|
|
/****** DV Interfaces ***************************************************/
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE IEnumFORMATETC
|
|
|
|
DECLARE_INTERFACE_(IEnumFORMATETC, IUnknown)
|
|
{
|
|
// *** IUnknown methods ***
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR* ppv) PURE;
|
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
|
|
|
// *** IEnumFORMATETC methods ***
|
|
STDMETHOD(Next) (THIS_ ULONG celt, FORMATETC FAR * rgelt, ULONG FAR* pceltFetched) PURE;
|
|
STDMETHOD(Skip) (THIS_ ULONG celt) PURE;
|
|
STDMETHOD(Reset) (THIS) PURE;
|
|
STDMETHOD(Clone) (THIS_ IEnumFORMATETC FAR* FAR* ppenum) PURE;
|
|
};
|
|
typedef IEnumFORMATETC FAR* LPENUMFORMATETC;
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE IEnumSTATDATA
|
|
|
|
DECLARE_INTERFACE_(IEnumSTATDATA, IUnknown)
|
|
{
|
|
// *** IUnknown methods ***
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR* ppv) PURE;
|
|
STDMETHOD_(ULONG, AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG, Release) (THIS) PURE;
|
|
|
|
// *** IEnumSTATDATA methods ***
|
|
STDMETHOD(Next) (THIS_ ULONG celt, STATDATA FAR * rgelt, ULONG FAR* pceltFetched) PURE;
|
|
STDMETHOD(Skip) (THIS_ ULONG celt) PURE;
|
|
STDMETHOD(Reset) (THIS) PURE;
|
|
STDMETHOD(Clone) (THIS_ IEnumSTATDATA FAR* FAR* ppenum) PURE;
|
|
};
|
|
typedef IEnumSTATDATA FAR* LPENUMSTATDATA;
|
|
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE IDataObject
|
|
|
|
#define DATA_E_FORMATETC DV_E_FORMATETC
|
|
#define DATA_S_SAMEFORMATETC (DATA_S_FIRST + 0)
|
|
|
|
DECLARE_INTERFACE_(IDataObject, IUnknown)
|
|
{
|
|
// *** IUnknown methods ***
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR* ppvObj) PURE;
|
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG, Release) (THIS) PURE;
|
|
|
|
// *** IDataObject methods ***
|
|
STDMETHOD(GetData) (THIS_ LPFORMATETC pformatetcIn,
|
|
LPSTGMEDIUM pmedium ) PURE;
|
|
STDMETHOD(GetDataHere) (THIS_ LPFORMATETC pformatetc,
|
|
LPSTGMEDIUM pmedium ) PURE;
|
|
STDMETHOD(QueryGetData) (THIS_ LPFORMATETC pformatetc ) PURE;
|
|
STDMETHOD(GetCanonicalFormatEtc) (THIS_ LPFORMATETC pformatetc,
|
|
LPFORMATETC pformatetcOut) PURE;
|
|
STDMETHOD(SetData) (THIS_ LPFORMATETC pformatetc, STGMEDIUM FAR * pmedium,
|
|
BOOL fRelease) PURE;
|
|
STDMETHOD(EnumFormatEtc) (THIS_ DWORD dwDirection,
|
|
LPENUMFORMATETC FAR* ppenumFormatEtc) PURE;
|
|
|
|
STDMETHOD(DAdvise) (THIS_ FORMATETC FAR* pFormatetc, DWORD advf,
|
|
LPADVISESINK pAdvSink, DWORD FAR* pdwConnection) PURE;
|
|
STDMETHOD(DUnadvise) (THIS_ DWORD dwConnection) PURE;
|
|
STDMETHOD(EnumDAdvise) (THIS_ LPENUMSTATDATA FAR* ppenumAdvise) PURE;
|
|
};
|
|
typedef IDataObject FAR* LPDATAOBJECT;
|
|
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE IViewObject
|
|
|
|
#define VIEW_E_DRAW (VIEW_E_FIRST)
|
|
#define E_DRAW VIEW_E_DRAW
|
|
|
|
#define VIEW_S_ALREADY_FROZEN (VIEW_S_FIRST)
|
|
|
|
DECLARE_INTERFACE_(IViewObject, IUnknown)
|
|
{
|
|
// *** IUnknown methods ***
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR* ppvObj) PURE;
|
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
|
|
|
// *** IViewObject methods ***
|
|
STDMETHOD(Draw) (THIS_ DWORD dwDrawAspect, LONG lindex,
|
|
void FAR* pvAspect, DVTARGETDEVICE FAR * ptd,
|
|
HDC hicTargetDev,
|
|
HDC hdcDraw,
|
|
const LPRECTL lprcBounds,
|
|
const LPRECTL lprcWBounds,
|
|
BOOL (CALLBACK * pfnContinue) (DWORD),
|
|
DWORD dwContinue) PURE;
|
|
|
|
STDMETHOD(GetColorSet) (THIS_ DWORD dwDrawAspect, LONG lindex,
|
|
void FAR* pvAspect, DVTARGETDEVICE FAR * ptd,
|
|
HDC hicTargetDev,
|
|
LPLOGPALETTE FAR* ppColorSet) PURE;
|
|
|
|
STDMETHOD(Freeze)(THIS_ DWORD dwDrawAspect, LONG lindex,
|
|
void FAR* pvAspect,
|
|
DWORD FAR* pdwFreeze) PURE;
|
|
STDMETHOD(Unfreeze) (THIS_ DWORD dwFreeze) PURE;
|
|
STDMETHOD(SetAdvise) (THIS_ DWORD aspects, DWORD advf,
|
|
LPADVISESINK pAdvSink) PURE;
|
|
STDMETHOD(GetAdvise) (THIS_ DWORD FAR* pAspects, DWORD FAR* pAdvf,
|
|
LPADVISESINK FAR* ppAdvSink) PURE;
|
|
};
|
|
typedef IViewObject FAR* LPVIEWOBJECT;
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE IAdviseSink
|
|
|
|
DECLARE_INTERFACE_(IAdviseSink, IUnknown)
|
|
{
|
|
// *** IUnknown methods ***
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR* ppv) PURE;
|
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
|
|
|
// *** IAdviseSink methods ***
|
|
STDMETHOD_(void,OnDataChange)(THIS_ FORMATETC FAR* pFormatetc,
|
|
STGMEDIUM FAR* pStgmed) PURE;
|
|
STDMETHOD_(void,OnViewChange)(THIS_ DWORD dwAspect, LONG lindex) PURE;
|
|
STDMETHOD_(void,OnRename)(THIS_ LPMONIKER pmk) PURE;
|
|
STDMETHOD_(void,OnSave)(THIS) PURE;
|
|
STDMETHOD_(void,OnClose)(THIS) PURE;
|
|
};
|
|
typedef IAdviseSink FAR* LPADVISESINK;
|
|
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE IAdviseSink2
|
|
|
|
DECLARE_INTERFACE_(IAdviseSink2, IAdviseSink)
|
|
{
|
|
// *** IUnknown methods ***
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR* ppv) PURE;
|
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
|
|
|
// *** IAdviseSink methods ***
|
|
STDMETHOD_(void,OnDataChange)(THIS_ FORMATETC FAR* pFormatetc,
|
|
STGMEDIUM FAR* pStgmed) PURE;
|
|
STDMETHOD_(void,OnViewChange)(THIS_ DWORD dwAspect, LONG lindex) PURE;
|
|
STDMETHOD_(void,OnRename)(THIS_ LPMONIKER pmk) PURE;
|
|
STDMETHOD_(void,OnSave)(THIS) PURE;
|
|
STDMETHOD_(void,OnClose)(THIS) PURE;
|
|
|
|
// *** IAdviseSink2 methods ***
|
|
STDMETHOD_(void,OnLinkSrcChange)(THIS_ LPMONIKER pmk) PURE;
|
|
};
|
|
typedef IAdviseSink2 FAR* LPADVISESINK2;
|
|
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE IDataAdviseHolder
|
|
|
|
DECLARE_INTERFACE_(IDataAdviseHolder, IUnknown)
|
|
{
|
|
// *** IUnknown methods ***
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR* ppv) PURE;
|
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
|
|
|
// *** IDataAdviseHolder methods ***
|
|
STDMETHOD(Advise)(THIS_ LPDATAOBJECT pDataObject, FORMATETC FAR* pFetc,
|
|
DWORD advf, LPADVISESINK pAdvise, DWORD FAR* pdwConnection) PURE;
|
|
STDMETHOD(Unadvise)(THIS_ DWORD dwConnection) PURE;
|
|
STDMETHOD(EnumAdvise)(THIS_ LPENUMSTATDATA FAR* ppenumAdvise) PURE;
|
|
|
|
STDMETHOD(SendOnDataChange)(THIS_ LPDATAOBJECT pDataObject, DWORD dwReserved, DWORD advf) PURE;
|
|
};
|
|
typedef IDataAdviseHolder FAR* LPDATAADVISEHOLDER;
|
|
|
|
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE IOleCache
|
|
|
|
#define CACHE_E_NOCACHE_UPDATED (CACHE_E_FIRST)
|
|
|
|
#define CACHE_S_FORMATETC_NOTSUPPORTED (CACHE_S_FIRST)
|
|
#define CACHE_S_SAMECACHE (CACHE_S_FIRST+1)
|
|
#define CACHE_S_SOMECACHES_NOTUPDATED (CACHE_S_FIRST+2)
|
|
|
|
|
|
DECLARE_INTERFACE_(IOleCache, IUnknown)
|
|
{
|
|
// *** IUnknown methods ***
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR* ppvObj) PURE;
|
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
|
|
|
// *** IOleCache methods ***
|
|
STDMETHOD(Cache) (THIS_ LPFORMATETC lpFormatetc, DWORD advf, LPDWORD lpdwConnection) PURE;
|
|
STDMETHOD(Uncache) (THIS_ DWORD dwConnection) PURE;
|
|
STDMETHOD(EnumCache) (THIS_ LPENUMSTATDATA FAR* ppenumStatData) PURE;
|
|
STDMETHOD(InitCache) (THIS_ LPDATAOBJECT pDataObject) PURE;
|
|
STDMETHOD(SetData) (THIS_ LPFORMATETC pformatetc, STGMEDIUM FAR * pmedium,
|
|
BOOL fRelease) PURE;
|
|
};
|
|
typedef IOleCache FAR* LPOLECACHE;
|
|
|
|
|
|
/****** DV APIs ***********************************************************/
|
|
|
|
|
|
STDAPI CreateDataAdviseHolder(LPDATAADVISEHOLDER FAR* ppDAHolder);
|
|
|
|
|
|
#endif // _DVOBJ_H_
|