为应用程序添加脚本支持
为应用程序添加脚本支持
作者:Yuri Polyakov 翻译:PowerCPP
代码运行效果图如下：
介绍
有时我们并不需要提供完整的脚本支持,就像本文所要介绍的ActiveX脚本宿主(script hosting,可能称为脚本引擎更好理解),本文提供的ScriptControlMacro程序展示了使用Microsoft脚本控件简单地实现脚本支持功能,代码中还包括了以下一些技术:
用文件映射实现只允许一个应用实例.
如何用MFC存储读取二进制注册表数据
如何保存恢复应用程序窗口尺寸,位置
如何在CEditView派生类中使用不同地字体
如何捕捉OLE异常并显示错误信息
等...
开始前的准备
这篇文章假定你已经对COM、ActiveX控件、OLE自动化有所熟悉，并知道如何在MFC里使用他们。因为这些技术包含了相当多的内容，因此你应该先学习一下这些内容再来看本文。
基本步骤：
1、建立一个提供ActiveX控件支持的新的MFC工程
2、使用ClassWizard从脚本控件类型库中建立一个dispatch类
ClassWizard将为脚本控件接口生成头文件与执行文件。
// Machine generated IDispatch wrapper class(es) created with
// ClassWizard
////////////////////////////////////////////////////////////
// IScriptControl wrapper class
class IScriptControl : public COleDispatchDriver
{
// Operations
public:
void SetLanguage(LPCTSTR lpszNewValue);
void SetSitehWnd(HWND hWnd);
LPDISPATCH GetError();
void AddObject(LPCTSTR Name, LPDISPATCH Object,
BOOL AddMembers);
void AddCode(LPCTSTR Code);
};
// Machine generated IDispatch wrapper class(es) created
// with ClassWizard
#include "stdafx.h"
#include "MSScriptControl.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
////////////////////////////////////////////////////////////
// IScriptControl operations
void IScriptControl::SetLanguage(LPCTSTR lpszNewValue)
{
static BYTE parms[] =
VTS_BSTR;
InvokeHelper(0x5dc, DISPATCH_PROPERTYPUT, VT_EMPTY,
NULL, parms,
lpszNewValue);
}
void IScriptControl::SetSitehWnd(HWND hWnd)
{
static BYTE parms[] =
VTS_I4;
InvokeHelper(0x5de, DISPATCH_PROPERTYPUT, VT_EMPTY,
NULL, parms,
hWnd);
}
LPDISPATCH IScriptControl::GetError()
{
LPDISPATCH result;
InvokeHelper(0x5e3, DISPATCH_PROPERTYGET, VT_DISPATCH,
(void*)&result, NULL);
return result;
}
void IScriptControl::AddObject(LPCTSTR Name,
LPDISPATCH Object,
BOOL AddMembers)
{
static BYTE parms[] =
VTS_BSTR VTS_DISPATCH VTS_BOOL;
InvokeHelper(0x9c4, DISPATCH_METHOD, VT_EMPTY, NULL, parms,
Name, Object, AddMembers);
}
void IScriptControl::AddCode(LPCTSTR Code)
{
static BYTE parms[] =
VTS_BSTR;
InvokeHelper(0x7d0, DISPATCH_METHOD, VT_EMPTY, NULL, parms,
Code);
}
3、删除类中不需要的IDispatch封装的方法
4、如果你想自己添加函数，可以用ClassWizard添加一个自动化类。
ClasWizard将为IDispatch接口产生如下头文件与执行文件：
// ScriptControlMacroDispatch.h : interface of the
// CScriptControlMacroDispatch class
//
////////////////////////////////////////////////////////////
#if !defined(AFX_SCRIPTCONTROLMACRODISPATCH_H__FB55B5AF_
00E5_47F5_B176_214B2C7BF19A__INCLUDED_)
#define AFX_SCRIPTCONTROLMACRODISPATCH_H__FB55B5AF_00E5_
47F5_B176_214B2C7BF19A__INCLUDED_
#if _MSC_VER 1000
#pragma once
#endif // _MSC_VER 1000
////////////////////////////////////////////////////////////
// CScriptControlMacroDispatch command target
class CScriptControlMacroDispatch : public CCmdTarget
{
DECLARE_DYNCREATE(CScriptControlMacroDispatch)
CScriptControlMacroDispatch();
// protected constructor used by dynamic creation
// Overrides
// ClassWizard generated virtual function overrides
//{{AFX_VIRTUAL(CScriptControlMacroDispatch)
//}}AFX_VIRTUAL
// Implementation
protected:
//friend class CScriptControlMacroView;
// Generated message map functions
//{{AFX_MSG(CScriptControlMacroDispatch)
// NOTE - the ClassWizard will add and remove member
// functions here.
//}}AFX_MSG
DECLARE_MESSAGE_MAP()
// Generated OLE dispatch map functions
//{{AFX_DISPATCH(CScriptControlMacroDispatch)
afx_msg void Test1();
afx_msg void Test2();
//}}AFX_DISPATCH
DECLARE_DISPATCH_MAP()
DECLARE_INTERFACE_MAP()
};
// Note: we add support for IID_IScriptControlMacroDispatch
// to support typesafe binding from VBA. This IID must match
// the GUID that is attached to the dispinterface in the
// .ODL file.
// {69AA5686-41AF-4CD9-AEAE-9DB88130E7C1}
static const IID IID_IScriptControlMacroDispatch =
{0x69AA5686, 0x41AF, 0x4CD9, {0xAE, 0xAE, 0x9D, 0xB8,
0x81, 0x30, 0xE7, 0xC1}};
////////////////////////////////////////////////////////////
//{{AFX_INSERT_LOCATION}}
// Microsoft Visual C++ will insert additional declarations
// immediately before the previous line.
#endif // !defined(AFX_SCRIPTCONTROLMACRODISPATCH_H__
// FB55B5AF_00E5_47F5_B176_214B2C7BF19A__INCLUDED_)
// ScriptControlMacroDispatch.cpp : implementation of the
// CScriptControlMacroDispatch class
//
#include "stdafx.h"
#include "ScriptControlMacroDispatch.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
////////////////////////////////////////////////////////////
// CScriptControlMacroDispatch
IMPLEMENT_DYNCREATE(CScriptControlMacroDispatch, CCmdTarget)
CScriptControlMacroDispatch::CScriptControlMacroDispatch()
{
EnableAutomation();
}
BEGIN_MESSAGE_MAP(CScriptControlMacroDispatch, CCmdTarget)
//{{AFX_MSG_MAP(CScriptControlMacroDispatch)
// NOTE - the ClassWizard will add and remove mapping
// macros here.
//}}AFX_MSG_MAP
END_MESSAGE_MAP()
BEGIN_DISPATCH_MAP(CScriptControlMacroDispatch, CCmdTarget)
//{{AFX_DISPATCH_MAP(CScriptControlMacroDispatch)
DISP_FUNCTION(CScriptControlMacroDispatch,
"Test1", Test1, VT_EMPTY, VTS_NONE)
DISP_FUNCTION(CScriptControlMacroDispatch,
"Test2", Test2, VT_EMPTY, VTS_NONE)
//}}AFX_DISPATCH_MAP
END_DISPATCH_MAP()
BEGIN_INTERFACE_MAP(CScriptControlMacroDispatch, CCmdTarget)
INTERFACE_PART(CScriptControlMacroDispatch,
IID_IScriptControlMacroDispatch, Dispatch)
END_INTERFACE_MAP()
////////////////////////////////////////////////////////////
// CScriptControlMacroDispatch message handlers
void CScriptControlMacroDispatch::Test1()
{
// TODO: Add your dispatch handler code here
AfxMessageBox(CString(_T("\"")) + GetDispatchMap()-
lpEntries-lpszName + _T("\" method call of
the \"") + RUNTIME_CLASS(
CScriptControlMacroDispatch)-m_lpszClassName
+ _T("\" class"), MB_ICONASTERISK);
}
void CScriptControlMacroDispatch::Test2()
{
// TODO: Add your dispatch handler code here
AfxMessageBox(CString(_T("\"")) + GetDispatchMap()-
lpEntries[1].lpszName + _T("\" method
call of the \"") + RUNTIME_CLASS(
CScriptControlMacroDispatch)-m_lpszClassName
+ _T("\" class"), MB_ICONASTERISK);
}
5、这样在产生的代码中已经实现了一些自定义的东西
a. 不必要的声名和代码已经删除
b. 全局的应用程序对象已经声名：extern CScriptControlMacroApp theApp
c. MFC隐含函数声名已经添加：CString AFXAPI AfxStringFromCLSID( REFCLSID ).
d. 为了使用AfxStringFromCLSID，IID_IScriptControlMacroDispatch定义已经移到了头文件中
6、为了在所有MFC程序中方便地提供Unicode支持，在AFX.H头文件中作了如下定制：
////////////////////////////////////////////////////////////
// Win32 libraries
// Start of customization
#ifdef _UNICODE
#pragma comment(linker, "/entry:wWinMainCRTStartup")
#endif
// End of customization
7、为了在所有MFC工程中使用 _WIN32_WINDOWS=0x500 这个预定义，在AFXV_W32.H头文件中作了如下定制：
#ifndef ALL_WARNINGS
#pragma warning(disable: 4201)
// winnt.h uses nameless structs
#endif
// Start of customization
#ifndef _WIN32_WINDOWS
// End of customization
#define _WIN32_WINDOWS 0x0500
// Start of customization
#endif
// End of customization
更多信息可以查看源代码或访问微软WINDOWS脚本技术网页http://msdn.microsoft.com/scripting/
