导入Active控件,可能用到的invokehelper

InvokeHelper　　当在项目中插入ActiveX控件ClassWizard生成的CWnd的派生类C++类中，可以看到其成员函数的代码中都有对InvokeHelper函数的调用，InvokeHelper函数的第一个参数都和对应的属性或方法在ActiveX控件中的分发(dispatch)ID（标识ActiveX控件的方法或属性的）相对应。通过查看ActiveX控件hlp文件可以发现，ActiveX控件的方法在生存的C++类中都有同名的成员函数与之对应，ActiveX控件的属性都有一组Get和Set函数对其操作，其中ActiveX控件的方法和属性操作与生成的C++类成员函数相关联都是通过InvokeHelper函数的调用来完成的，InvokeHelper函数的第一个参数是由Component Gallery（控件提供者）提供的。因为经过这样的处理，所以我们如果要调用ActiveX控件的方法或对其属性进行取和设置操作，只需调用生成的C++类对应的成员函数便可。 
　　下面对InvokeHelper单独说明： 
　　CWnd::InvokeHelper 
　　void InvokeHelper( DISPID dwDispID, WORD wFlags, VARTYPE vtRet, void* pvRet, const BYTE* pbParamInfo, ... ); 
　　说明： 
　　Call this member function to invoke the OLE control method or property specified by dwDispID, in the context specified by wFlags. 
　　其中参数： 
　　dwDispID： 
　　//Identifies the method or property to be invoked. This value is usually supplied by Component Gallery. 
　　wFlags：可以为下面些值，指明调用InvokeHelper的目的。 
　　//[ DISPATCH_METHOD ] The member is invoked as a method. If a property has the same name, both this and the DISPATCH_PROPERTYGET flag may be set. 
　　[ DISPATCH_PROPERTYGET ] The member is retrieved as a property or data member. 
　　[ DISPATCH_PROPERTYPUT ] The member is changed as a property or data member. 
　　[ DISPATCH_PROPERTYPUTREF ] The member is changed by a reference assignment, rather than a value assignment. This flag is valid only when the property accepts a reference to an object. 
　　vtRet： 
　　//Specifies the type of the return value. 
　　VT_EMPTY void 
　　VT_I2 short 
　　VT_I4 long 
　　VT_R4 float 
　　VT_R8 double 
　　VT_CY CY 
　　VT_DATE DATE 
　　VT_BSTR BSTR 
　　VT_DISPATCH LPDISPATCH 
　　VT_ERROR SCODE 
　　VT_BOOL BOOL 
　　VT_VARIANT VARIANT 
　　VT_UNKNOWN LPUNKNOWN 
　　pvRet： 
　　//Address of the variable that will that will receive the property value or return value. It must match the type specified by vtRet. 
　　pbParamInfo：一般都设置为NULL 
　　//Pointer to a null-terminated string of bytes specifying the types of the parameters following pbParamInfo. 
　　specifies the types of the parameters passed to the method or property. 
　　...： 
　　//Variable List of parameters, of types specified in pbParamInfo.
　　InvokeHelper()函数的用法
　　1、播放文件的函数： 
　　void CActiveMovie3::Run() 
　　{ 
　　InvokeHelper(0x60020001, DISPATCH_METHOD, VT_EMPTY, NULL, NULL); 
　　} 
　　2、暂停播放的函数： void CActiveMovie3::Pause() 
　　{ 
　　InvokeHelper(0x60020002, DISPATCH_METHOD, VT_EMPTY, NULL, NULL); 
　　} 
　　4、停止播放的函数： void CActiveMovie3::Stop() 
　　{ 
　　InvokeHelper(0x60020003, DISPATCH_METHOD, VT_EMPTY, NULL, NULL); 
　　} 
　　5、获得文件的函数： CString CActiveMovie3::GetFileName() 
　　{ 
　　CString result; 
　　InvokeHelper(0xb, DISPATCH_PROPERTYGET, VT_BSTR, (void*)&result, NULL); 
　　return result; 
　　} 
　　6、设置文件的函数： void CActiveMovie3::SetFileName(LPCTSTR lpszNewValue) 
　　{ 
　　static BYTE parms[] = VTS_BSTR; 
　　InvokeHelper(0xb, DISPATCH_PROPERTYPUT, VT_EMPTY, NULL, parms, 
　　lpszNewValue); 
　　} 
　　7、获得播放位置的函数： double CActiveMovie3::GetCurrentPosition() 
　　{ 
　　double result; 
　　InvokeHelper(0xd, DISPATCH_PROPERTYGET, VT_R8, (void*)&result, NULL); 
　　return result; 
　　} 
　　8、设置播放位置的函数： void CActiveMovie3::SetCurrentPosition(double newValue) 
　　{ 
　　static BYTE parms[] = VTS_R8; 
　　InvokeHelper(0xd, DISPATCH_PROPERTYPUT, VT_EMPTY, NULL, parms, newValue); 
　　} 
　　9、获得音量的函数： long CActiveMovie3::GetVolume() 
　　{ 
　　long result; 
　　InvokeHelper(0x13, DISPATCH_PROPERTYGET, VT_I4, (void*)&result, NULL); 
　　return result; 
　　} 
　　10、设置音量的函数： void CActiveMovie3::SetVolume(long nNewValue) 
　　{ 
　　static BYTE parms[] = VTS_I4; 
　　InvokeHelper(0x13, DISPATCH_PROPERTYPUT, VT_EMPTY, NULL, parms, nNewValue); 
　　} 当在项目中插入ActiveX控件ClassWizard生成的CWnd的派生类C++类中，可以看到其成员函数的代码中都有对InvokeHelper函数的调用，InvokeHelper函数的第一个参数都和对应的属性或方法在ActiveX控件中的分发(dispatch)ID（标识ActiveX控件的方法或属性的）相对应。通过查看ActiveX控件hlp文件可以发现，ActiveX控件的方法在生存的C++类中都有同名的成员函数与之对应，ActiveX控件的属性都有一组Get和Set函数对其操作，其中ActiveX控件的方法和属性操作与生成的C++类成员函数相关联都是通过InvokeHelper函数的调用来完成的，InvokeHelper函数的第一个参数是由Component Gallery（控件提供者）提供的。因为经过这样的处理，所以我们如果要调用ActiveX控件的方法或对其属性进行取和设置操作，只需调用生成的C++类对应的成员函数便可。 
　　下面对InvokeHelper单独说明： 
　　CWnd::InvokeHelper 
　　void InvokeHelper( DISPID dwDispID, WORD wFlags, VARTYPE vtRet, void* pvRet, const BYTE* pbParamInfo, ... ); 
　　说明： 
　　Call this member function to invoke the OLE control method or property specified by dwDispID, in the context specified by wFlags. 
　　其中参数： 
　　dwDispID： 
　　//Identifies the method or property to be invoked. This value is usually supplied by Component Gallery. 
　　wFlags：可以为下面些值，指明调用InvokeHelper的目的。 
　　//[ DISPATCH_METHOD ] The member is invoked as a method. If a property has the same name, both this and the DISPATCH_PROPERTYGET flag may be set. 
　　[ DISPATCH_PROPERTYGET ] The member is retrieved as a property or data member. 
　　[ DISPATCH_PROPERTYPUT ] The member is changed as a property or data member. 
　　[ DISPATCH_PROPERTYPUTREF ] The member is changed by a reference assignment, rather than a value assignment. This flag is valid only when the property accepts a reference to an object. 
　　vtRet： 
　　//Specifies the type of the return value. 
　　VT_EMPTY void 
　　VT_I2 short 
　　VT_I4 long 
　　VT_R4 float 
　　VT_R8 double 
　　VT_CY CY 
　　VT_DATE DATE 
　　VT_BSTR BSTR 
　　VT_DISPATCH LPDISPATCH 
　　VT_ERROR SCODE 
　　VT_BOOL BOOL 
　　VT_VARIANT VARIANT 
　　VT_UNKNOWN LPUNKNOWN 
　　pvRet： 
　　//Address of the variable that will that will receive the property value or return value. It must match the type specified by vtRet. 
　　pbParamInfo：一般都设置为NULL 
　　//Pointer to a null-terminated string of bytes specifying the types of the parameters following pbParamInfo. 
　　specifies the types of the parameters passed to the method or property. 
　　...： 
　　//Variable List of parameters, of types specified in pbParamInfo.