InvokeHelper

InvokeHelper
基本信息
当在项目中插入ActiveX控件ClassWizard生成的CWnd的派生类时，在C++类中可以看到其成员函数的代码中都有对InvokeHelper函数的调用，InvokeHelper函数的第一个参数都和对应的属性或方法在ActiveX控件中的分发(dispatch)ID（标识ActiveX控件的方法或属性的）相对应。通过查看ActiveX控件help文件可以发现，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);
 
 
 

  }