界面编程

开发平台：
Visual C++

PROPSET.H：源码内容
							// propset.h : interface of the CDrawCliProperty, CDrawCliPropertySection, and CPropertSet classes
//
// This is a part of the Microsoft Foundation Classes C++ library.
// Copyright (C) 1992-1998 Microsoft Corporation
// All rights reserved.
//
// This source code is only intended as a supplement to the
// Microsoft Foundation Classes Reference and related
// electronic documentation provided with the library.
// See these sources for detailed information regarding the
// Microsoft Foundation Classes product.
#ifndef __DRAWCLI_PROPSET_H
#define __DRAWCLI_PROPSET_H
//  Property setting
typedef struct tagSECTIONHEADER
{
	DWORD       cbSection ;
	DWORD       cProperties ;  // Number of props.
} SECTIONHEADER, *LPSECTIONHEADER ;
typedef struct tagPROPERTYIDOFFSET
{
	DWORD       propertyID;
	DWORD       dwOffset;
} PROPERTYIDOFFSET, *LPPROPERTYIDOFFSET;
typedef struct tagPROPHEADER
{
	WORD        wByteOrder ;    // Always 0xFFFE
	WORD        wFormat ;       // Always 0
	DWORD       dwOSVer ;       // System version
	CLSID       clsID ;         // Application CLSID
	DWORD       cSections ;     // Number of sections (must be at least 1)
} PROPHEADER, *LPPROPHEADER ;
typedef struct tagFORMATIDOFFSET
{
	GUID        formatID;
	DWORD       dwOffset;
} FORMATIDOFFSET, *LPFORMATIDOFFSET;
/////////////////////////////////////////////////////////////////////////////
// CDrawCliProperty
class CDrawCliProperty : public CObject
{
	friend class CDrawCliPropertySet ;
	friend class CDrawCliPropertySection ;
public:
// Construction
	CDrawCliProperty( void ) ;
	CDrawCliProperty( DWORD dwID, const LPVOID pValue, DWORD dwType ) ;
// Attributes
	BOOL    Set( DWORD dwID, const LPVOID pValue, DWORD dwType ) ;
	BOOL    Set( const LPVOID pValue, DWORD dwType ) ;
	BOOL    Set( const LPVOID pValue ) ;
	LPVOID  Get( DWORD* pcb ) ;     // Returns pointer to actual value
	LPVOID  Get( void ) ;           // Returns pointer to actual value
	DWORD   GetType( void ) ;       // Returns property type
	void    SetType( DWORD dwType ) ;
	DWORD   GetID( void ) ;
	void    SetID( DWORD dwPropID ) ;
	LPVOID  GetRawValue( void ) ;   // Returns pointer internal value (may
									// include size information)
// Operations
	BOOL    WriteToStream( IStream* pIStream ) ;
	BOOL    ReadFromStream( IStream* pIStream ) ;
private:
	DWORD       m_dwPropID ;
	DWORD       m_dwType ;
	LPVOID      m_pValue ;
	LPVOID  AllocValue(ULONG cb);
	void    FreeValue();
public:
	~CDrawCliProperty() ;
} ;
/////////////////////////////////////////////////////////////////////////////
// CDrawCliPropertySection
class CDrawCliPropertySection : public CObject
{
	friend class CDrawCliPropertySet ;
	friend class CDrawCliProperty ;
public:
// Construction
	CDrawCliPropertySection( void ) ;
	CDrawCliPropertySection( CLSID FormatID ) ;
// Attributes
	CLSID   GetFormatID( void ) ;
	void    SetFormatID( CLSID FormatID ) ;
	BOOL    Set( DWORD dwPropID, LPVOID pValue, DWORD dwType ) ;
	BOOL    Set( DWORD dwPropID, LPVOID pValue ) ;
	LPVOID  Get( DWORD dwPropID, DWORD* pcb ) ;
	LPVOID  Get( DWORD dwPropID ) ;
	void    Remove( DWORD dwPropID ) ;
	void    RemoveAll() ;
	CDrawCliProperty* GetProperty( DWORD dwPropID ) ;
	void AddProperty( CDrawCliProperty* pProp ) ;
	DWORD   GetSize( void ) ;
	DWORD   GetCount( void ) ;
	CObList* GetList( void ) ;
	BOOL    GetID( LPCTSTR pszName, DWORD* pdwPropID ) ;
	BOOL    SetName( DWORD dwPropID, LPCTSTR pszName ) ;
	BOOL    SetSectionName( LPCTSTR pszName );
	LPCTSTR GetSectionName( void );
// Operations
	BOOL    WriteToStream( IStream* pIStream ) ;
	BOOL    ReadFromStream( IStream* pIStream, LARGE_INTEGER liPropSet ) ;
	BOOL    WriteNameDictToStream( IStream* pIStream ) ;
	BOOL    ReadNameDictFromStream( IStream* pIStream ) ;
private:
// Implementation
	CLSID           m_FormatID ;
	SECTIONHEADER   m_SH ;
	// List of properties (CDrawCliProperty)
	CObList         m_PropList ;
	// Dictionary of property names
	CMapStringToPtr m_NameDict ;
	CString         m_strSectionName;
public:
	~CDrawCliPropertySection();
} ;
/////////////////////////////////////////////////////////////////////////////
// CDrawCliPropertySet
class CDrawCliPropertySet : public CObject
{
	friend class CDrawCliPropertySection ;
	friend class CDrawCliProperty ;
public:
// Construction
	CDrawCliPropertySet( void ) ;
	CDrawCliPropertySet( CLSID clsID )  ;
// Attributes
	BOOL    Set( CLSID FormatID, DWORD dwPropID, LPVOID pValue, DWORD dwType ) ;
	BOOL    Set( CLSID FormatID, DWORD dwPropID, LPVOID pValue ) ;
	LPVOID  Get( CLSID FormatID, DWORD dwPropID, DWORD* pcb ) ;
	LPVOID  Get( CLSID FormatID, DWORD dwPropID ) ;
	void    Remove( CLSID FormatID, DWORD dwPropID ) ;
	void    Remove( CLSID FormatID ) ;
	void    RemoveAll( ) ;
	CDrawCliProperty* GetProperty( CLSID FormatID, DWORD dwPropID ) ;
	void AddProperty( CLSID FormatID, CDrawCliProperty* pProp ) ;
	CDrawCliPropertySection* GetSection( CLSID FormatID ) ;
	CDrawCliPropertySection* AddSection( CLSID FormatID ) ;
	void AddSection( CDrawCliPropertySection* psect ) ;
	WORD    GetByteOrder( void ) ;
	WORD    GetFormatVersion( void ) ;
	void    SetFormatVersion( WORD wFmtVersion ) ;
	DWORD   GetOSVersion( void ) ;
	void    SetOSVersion( DWORD dwOSVer ) ;
	CLSID   GetClassID( void ) ;
	void    SetClassID( CLSID clsid ) ;
	DWORD   GetCount( void ) ;
	CObList* GetList( void ) ;
// Operations
	BOOL    WriteToStream( IStream* pIStream ) ;
	BOOL    ReadFromStream( IStream* pIStream ) ;
// Implementation
private:
	PROPHEADER      m_PH ;
	CObList         m_SectionList ;
public:
	~CDrawCliPropertySet();
} ;
#endif // __DRAWCLI_PROPSET_H

						