术语 | COleServerDoc::OnExecOleCmd | ||||||||||||||||||||||||||||
释义 | COleServerDoc::OnExecOleCmd HRESULT OnExecOleCmd( const GUID* pGroup, DWORD nCmdID, DWORD nCmdExecOut, VARIANTARG* pvaIn, VARIANTARG* pvaOut ); 返回值: 如果成功则返回S_OK;否则,返回下列错误代码之一:
参数:
说明: 框架调用这个函数来执行一个指定的命令,或为命令显示帮助。 COleCmdUI可以用来使能,更新和设置DocObject用户界面命令的其它属性。 在命令被初始化之后,你可以用OnExecOleCmd来执行它们。在框架尝试翻译和分派一个OLE文档命令之前,它调用这个函数。在处理标准的OLE文档命令时,你不必重载这个函数。但是如果你想处理你自己的定制命令,或处理需要接收参数或返回结果的命令时,你必须要重载这个函数。 大多数命令不需要接收参数或返回结果。对于大多数的命令来说,调用者可以将NULL赋给pvaIn和pvaOut。对于那些需要接收输入参数的命令,调用者可以声明和初始化一个VARIANTARG变量,并将一个指针传递给pvaIn中的变量。对需要一个单一值的命令,参数被直接保存在VARIANTARG中,并传递给函数。而多个参数则必须要在VARIANTARG中使用某个允许的类型(如IDispatch和SAFEARRAY)来打包。 类似的,如果一个命令要返回参数,则调用者需要定义一个VARIANTARG,将它初始化为VT_EMPTY,并将它的地址传递给pvaOut。如果命令返回一个单一的值,则对象可以将这个值直接保存在pvaOut中。如果有多个输出值则必须用某种适用于VARIANTARG的方法来打包。 这个函数的基类实现将使OLE COMMAND_MAP结构与命令目标相联系,并尝试为命令分派一个合适的句柄。函数的基类实现只处理不接收参数和不返回结果的命令。如果你需要处理接收参数或返回结果的命令,你就必须重载这个函数,并且自己来处理pvaIn和pvaOut。 请参阅:COleCmdUI |
||||||||||||||||||||||||||||
随便看 |
|
MFC类库中文详解手册包含4274条MFC类库参考词条,基本涵盖了Microsoft基本类库中的类、全局函数、全局变量和宏的内容,是计算机编程的有利工具。