resorgoptions.h

一个vc中管理资源文件ID的插件

#if !defined(__ResOrgOptions_H__)
#define __ResOrgOptions_H__
/************************************************************************
 *
 *                 Resource ID Organiser Utility Library
 *
 *       (c) Copyright 2000 by Andy Metcalfe ([e-mail])
 *                         All rights reserved.
 *
 ************************************************************************
 *                                                                       
 *  Filename    : ResOrgOptions.h
 *
 *  Description : CResOrgOptions - class to hold program options
 *                
 *  Compiler    : Microsoft Visual C++ 6.0, Service Pack 3 or 4
 *                                                                       
 *  Target                                                               
 *  Environment : Windows 98/NT
 *
 *  NOTE:
 *
 *    This software is provided "as is" free for personal use. All
 *    title and copyrights in and to the software, including but not
 *    limited to any images, text, etc. incorporated into it, are
 *    owned by Andy Metcalfe, except where acknowledged otherwise.
 *
 *    Your may freely to use this code in your own products, PROVIDED
 *    this notice is not removed or modified.
 *
 *
 *    Visit http://www.resorg.co.uk for latest updates
 *
 ************************************************************************
 *
 *   MODIFICATION HISTORY:
 *
 *           This is a controlled document. See project configuration
 *           control tool for latest version and full version history.
 *
 *    $Archive: /Projects/AddIns/ResOrg/ResOrgUtils/ResOrgOptions.h $
 *   $Revision: 12 $
 *       $Date: 8/07/01 8:36 $
 *     $Author: Andy $
 *
 *    $History: ResOrgOptions.h $
 * 
 * *****************  Version 12  *****************
 * User: Andy         Date: 8/07/01    Time: 8:36
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * CResOrgOptions::Configure() now allows the parent window of the Options
 * dialog to be specified
 * 
 * *****************  Version 11  *****************
 * User: Andy         Date: 2/07/01    Time: 22:17
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * Added additional options for web URLs (updated from the version
 * checker)
 * 
 * *****************  Version 10  *****************
 * User: Andy         Date: 22/06/01   Time: 9:48
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * Made class declaration "Rose friendly"
 * 
 * *****************  Version 9  *****************
 * User: Andy         Date: 26/05/01   Time: 15:14
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * Added Mailing List prompt option
 * 
 * *****************  Version 8  *****************
 * User: Andy         Date: 22/05/01   Time: 16:02
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * 1.  Removed version check code from Initialise () to a new
 * DoVersionCheck() method. This prevents problems with the "nag" screen
 * displayed by the ResOrg app.
 * 2.  Made StartVersionCheck() a bit more fault tolerant
 * 
 * *****************  Version 7  *****************
 * User: Andy         Date: 22/05/01   Time: 6:42
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * 1.  Class now derived from CCmdTarget to allow it to receive WM_COMMAND
 * notifications from the MainFrame
 * 2.  StartVersionCheck() now takes an extra parameter to allow dial-up
 * networking prompts to be disabled
 * 3.  OnVersionCheckCompleted() now returns an error code instead of a
 * boolean
 * 4.  Added OnExit()
 * 
 * *****************  Version 6  *****************
 * User: Andy         Date: 16/05/01   Time: 20:56
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * Added "Updates" page and version checking
 * 
 * *****************  Version 5  *****************
 * User: Andy         Date: 12/05/01   Time: 6:47
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * Added a registry entry to allow ResOrg to be forced to check a
 * particular version of DevStudio
 * 
 * *****************  Version 4  *****************
 * User: Andy         Date: 5/12/00    Time: 20:32
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * Added web URL to options
 * 
 * *****************  Version 3  *****************
 * User: Andy         Date: 3/12/00    Time: 8:40
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 * Added AskAboutLoadingAddIn()
 * 
 * *****************  Version 2  *****************
 * User: Andy         Date: 29/11/00   Time: 18:38
 * Updated in $/Projects/AddIns/ResOrg/ResOrgUtils
 *  Added file banners
 *
 * $Nokeywords: $
 *
 ************************************************************************/

// ResOrgOptions.h : interface of the CResOrgOptions class
//
/////////////////////////////////////////////////////////////////////////////


#if _MSC_VER >= 1000
#pragma once
#endif // _MSC_VER >= 1000



class CResOrgVersionCheck;


/////////////////////////////////////////////////////////////////////////////
// CResOrgOptions class

#define CResOrgOptions_BASE							CCmdTarget

class RESORGUTILS_EXT_CLASS	CResOrgOptions : public	CCmdTarget
{
public:
			CResOrgOptions(void);

	virtual ~CResOrgOptions(void);


// Attributes
protected:
			BOOL					m_bWarnOnSymbolChanges;
			BOOL					m_bAskAboutLoading;
			BOOL					m_bAskAboutMailingList;
			CString					m_sWebURL;
			CString					m_sFaqURL;
			CString					m_sDiscussionBoardURL;
			CString					m_sKnownBugsURL;
			CString					m_sMailingListURL;

			CString					m_sDevStudioVer;
			BOOL					m_bEnableVersionChecking;
			int						m_nVersionCheckInterval;

			CTime					m_timeLastUpdateCheck;
			CResOrgVersionCheck*	m_pVersionChecker;

// Operations
public:
			BOOL					WarnOnSymbolChanges(void) const
										{ return m_bWarnOnSymbolChanges; }

			BOOL					AskAboutLoadingAddIn(void) const
										{ return m_bAskAboutLoading; }

			BOOL					AskAboutLoadingAddIn(BOOL bLoad);

			BOOL					IsMailingListPromptEnabled(void) const
										{ return m_bAskAboutMailingList; }

			BOOL					EnableMailingListPrompt(BOOL bEnable);

			CString					GetWebURL(void) const
										{ return m_sWebURL; }

			CString					GetFaqURL(void) const
										{ return m_sFaqURL; }

			CString					GetDiscussionBoardURL(void) const
										{ return m_sDiscussionBoardURL; }

			CString					GetKnownBugsURL(void) const
										{ return m_sKnownBugsURL; }

			CString					GetMailingListURL(void) const
										{ return m_sMailingListURL; }

			BOOL					SetWebURL(const CString& sWebURL);

			BOOL					SetFaqURL(const CString& sFaqURL);

			BOOL					SetDiscussionBoardURL(const CString& sDiscussionBoardURL);

			BOOL					SetKnownBugsURL(const CString& sKnownBugsURL);

			BOOL					SetMailingListURL(const CString& sMailingListURL);

			CString					GetDevStudioVer(void) const
										{ return m_sDevStudioVer; }

			BOOL					IsVersionCheckEnabled(void) const
										{ return m_bEnableVersionChecking; }

			int						GetVersionCheckInterval(void) const
										{ return m_nVersionCheckInterval; }

			BOOL					IsVersionCheckDue(void) const;

			BOOL					DoVersionCheck(void);

			CResOrgVersionCheck*	StartVersionCheck(	BOOL bDisableDialupPrompt,
														CWnd* pNotifyTarget = NULL,
														UINT uMsg = 0,
														UINT uID = 0);

			BOOL					IsVersionCheckRunning(void) const;

			CResOrgVersionCheck*	GetVersionChecker(void) const
										{ return m_pVersionChecker; }

	virtual	DWORD					OnVersionCheckCompleted(BOOL bPromptAlways = FALSE);

	virtual	BOOL					OnExit(void);


// Overrides
	virtual	BOOL					Initialise(void);

	virtual	int						Configure(CWnd* pParentWnd = NULL);


// Implementation
protected:
			BOOL					UpdateURLs(void);

	//{{AFX_MSG(CResOrgOptions)
	afx_msg	void					OnCmdResOrgUpdateCheckCompleted(void);
	//}}AFX_MSG

	DECLARE_MESSAGE_MAP()
};


/////////////////////////////////////////////////////////////////////////////

//{{AFX_INSERT_LOCATION}}
// Microsoft Developer Studio will insert additional declarations immediately before the previous line.

#endif // !defined(__ResOrgOptions_H__)