|
CCmdTarget
#include <afxwin.h> 请参阅 CCmdUI, CDocument, CDocTemplate, CWinApp,CWnd, CView,CFrameWnd, COleDispatchDriver CCmdTarget类的成员 属性 FromDispatch返回一个指向CCmdTarget对象的指针，该对象与IDispatch相联系 GetDispatch返回一个指向IDispatch对象的指针，该对象与CCmdTarget对象相关 IsResultExpected如果自动函数要返回一个值，则返回非零值 操作 BeginWaitCursor显示沙漏标 EnableAutomation允许CCmdTarget 对象的OLE自动函数 EndWaitCursor返回到前一个光标 RestoreWaitCursor重置沙漏标 可覆盖的函数 OnCmdMsg分派命令消息 OnFinalRelease在最后一个OLE对象参考被释放时清除环境 成员函数 CCmdTarget::BeginWaitCursor void BeginWaitCursor( ); 说明 本函数用于显示沙漏标（通常在命令执行时间较长时采用）。框架调用本函数显示沙漏标，告诉用户系统忙，例如在加载一个CDocument对象或把它保存到文件时。在不是处理单个消息时，BeginWaitCursor可能不象其它函数那样有效，例如OnSetCursor的处理也能改变光标形状。调用函数EndWaitCursor可以恢复此前的光标。 示例  //The following example illustrates the most common case //of displaying the hourglass cursor during some lengthy //processing of a command handler implemented in some //CCmdTaget-derived class,such as a document or view. void CMyView::OnSomeCommand( )   ...{  BeginWaitCursor( ); //display the hourglass cursor //do some lengthy processing EndWaitCursor( ); //remove the hourglass cursor  } //The next example illustrates RestoreWaitCursor void CMyView::OnSomeCommand( ) ...{ BeginWaitCursor( ); //display the hourglass cursor //do some lengthy processing // The dialog box will normally change the cursor to // the standard arrow cursor,and leave the cursor in // as the standard arrow cursor when the dialog box is //closed. CMyDialog dlg;dlg.DoModal( ); // It is necessary to call RestoreWaitCursor here in order // to change the cursor back to the hourglass cursor. RestoreWaitCursor( ); // do some more lengthy processing EndWaitCursor( ); //remove the hourglass cursor } // In the above example,the dialog was clearly invoked between // the pair of calls to BeginWaitCursor and EndWaitCursor. // Sometimes it may not be clear whether the dialog is invoked // in between a pair of calls to BeginWaitCursor and EndWaitCursor .// It is permissable to call RestoreWaitCursor,even if // BeginWaitCursor was not previously called.This case is // illustrated below,where CMyView::AnotherFunction does not // need to know whether it was called in the context of an // hourglass cursor. void CMyView::AnotherFunction( ) ...{ // some processing CMyDialog dlg; dlg.DoModal( ); RestoreWaitCursor( ); //some more processing } // If the dialog is invoked from a member function of // some non-CCmdTarget,the you call CWinApp::DoWaitCursor // with a 0 parameter value to restore the hourglass cursor. void CMyObject::AnotherFunction( ) ...{ CMyDialog dlg; dlg.DoModal( ); AfxGetApp( )->DoWaitCursor(0); //same as CCmdTarget::RestoreWaitCursor } CCmdTarget::EndWaitCursor, CCmdTarget::RestoreWaitCursor, CWinApp::DoWaitCursor CCmdTarget::EnableAutomation void EnableAutomation( ); 说明 本函数设置对象的OLE自动功能。一般在对象的构造函数里调用。调用时要保证已经为类声明了分派映射。有关自动功能的更详细信息，请参阅联机文档“Visual C++程序员指南”中的” 自动客户”和“自动服务器” 请参阅 DECLARE_DISPATCH_MAP, DECLARE_OLECREATE CCmdTarget::EndWaitCursor void EndWaitCursor( ); 说明 本函数在BeginWaitCursor之后调用。它用于撤消沙漏标，并恢复以前的光标。框架在调用沙漏标之后也调用本函数。 示例 // The following example illustrates the most common case // of displaying the hourglass cursor during some lengthy // processing of a command handler implemented in some // CCmdTarget-derived class,such as a document or view. void CMyView::OnSomeCommand( ) ...{ BeginWaitCursor( ); // display the hourglass cursor // do some lengthy processing EndWaitCursor( ); // remove the hourglass cursor } // The next example illustrates RestoreWaitCursor void CMyView::OnSomeCommand( ) ...{ BeginWaitCursor( ); // display the hourglass cursor // do some lengthy processing // The dialog box will normally change the cursor to // the standard arrow cursor,and leave the cursor in // as the standard arrow cursor when the dialog box is // closed. CMyDialog dlg; dlg.DoModal( ); // It is necessary to call RestoreWaitCursor here in order // to change the cursor back to the hourglass cursor. RestoreWaitCursor( ); // do some more lengthy processing EndWaitCursor( ); // remove the hourglass cursor } // In the above example,the dialog was clearly invoked between // the pair of calls to BeginWaitCursor and EndWaitCursor. // Sometimes it may not be clear whether the dialog is invoked // in between a pair of calls to BeginWaitCursor and EndWaitCursor. // It is permissable to call RestoreWaitCursor,even if // BeginWaitCursor was not previously called.This case is // illustrated below,where CMyView::AnotherFunction does not // need to know whether it was called in the context of an // hourglass cursor. void CMyView::AnotherFunction( ) ...{ // some processing…. CMyDialog dlg; dlg.DoModal( ); RestoreWaitCursor( ); // some more processing… } // If the dialog is invoked from a member function of // some non-CCmdTarget,the you call CWinApp::DoWaitCursor // with a 0 parameter value to restore the hourglass cursor. void CMyObject::AnotherFunction( ) ...{ CMyDialog dlg; dlg.DoModal( ); AfxGetApp( )->DoWaitCursor(0); // same as CCmdTarget::RestorWaitCursor } CCmdTarget::BeginWaitCursor, CCmdTarget::RestoreWaitCursor, CWinApp::DoWaitCursor CCmdTarget::FromIDispatch static CCmdTarget* FromIDispatch( LPDISPATCH lpDispatch ); 返回值 返回一个和lpDistpatch相关的CCmdTarget对象的指针。如果该IDistpatch对象不是一个MFC IDistpatch对象，则返回NULL。 参数 lpDispatch指向IDistpatch对象的指针。 说明 本函数把从类的自动成员函数中得到的一个IDistpatch指针映射到一个实现了IDistpatch对象接口的CCmdTarget对象。函数的结果与调用函数GetIDispatch的结果相反。 请参阅 CCmdTarget::GetIDispatch, COleDispatchDriver CCmdTarget::GetIDispatch LPDISPATCH GetIDispatch( BOOL bAddRef ); 返回值 返回一个和该对象相关的IDistpatch指针。 参数 bAddRef指明是否增加对该对象的参考记数。 说明 本成员函数用于检索一个自动方法的IDistpatch指针，该自动方法返回一个IDistpatch指针或参考一个IDistpatch指针。对于那些在构造函数中调用了EnableAutomation的对象，本函数使它们自动激活，并返回一个指向IDistpatch在MFC中的实现的指针。该IDistpatch被那些通过IDistpatch接口通信的客户所使用。本函数的调用自动增加一个对该指针的参考，因而不需要调用IUnknow::AddRef。 请参阅 CCmdTarget::EnableAutomation,COleDispatchDriver,IUnknow::Release CCmdTarget::IsResultExpected BOOL IsResultExpected( ); 返回值 如果自动函数要返回一个值，则返回非零值。否则为0。 说明 本函数确定客户是否期待从它对自动函数的调用中返回一个值。OLE接口告诉MFC客户是使用了还是忽略了调用返回值。MFC则使用这些信息决定IsResultExpected的返回值。如果返回值的计算比较耗费时间或其它资源，可以在计算返回值之前调用本函数以提高效率。本函数只返回一次0，这样，如果在一个已被客户端调用的自动函数中调用了其它的自动函数，就可以获得有效的返回值。如果在没有进行自动函数调用时调用本函数，将返回非零值。 请参阅 CCmdTarget::GETIDispatch, CCmdTarget::EnableAutomation CCmdTarget::OnCmdMsgvirtual BOOL OnCmdMsg( UINT nID, int nCode, void* pExtra,AFX_CMDHANDL-ERINF O*pHandlerInfo ); 返回值 如果消息被处理了，则返回非零值；否则为0。 参数 nID命令的ID。 nCode命令的通知代码。 PExtra根据nCode的值使用。 pHandlerInfo如果非空，OnCmdMsg将填充pHandlerInfo 结构的pTarget和pmf成员，而不是分派该命令。此参数通常为NULL。 说明 本函数由框架来调用，它分派命令并处理那些提供了命令用户接口的对象的更新。这是框架的命令体系中实现的一个主要例程。在运行时，OnCmdMsg把命令分派到其它对象上或者调用CcmdTarg-et::OnCmd Msg（此函数进行真正的消息映射查找）自己处理命令。有关这个缺省命令例程的完整描述，请参阅联机文档“Visual C++程序员指南”中的“消息处理”和“映射主题”部分。偶尔需要覆盖本函数以扩展MFC框架的标准命令例程。有关命令例程体系中的更多细节，请参阅联机文档中的“技术指南21”。 请参阅 CCmdUI CCmdTarget::OnFinalRelease virtual void OnFinalRelease( ); 说明 本函数在对对象的最后一个OLE参考或对象对别人的后一个OLE参考被释放时，由框架调用。可以覆盖它以进行所需的处理。缺省的实现是删除该对象。 请参阅 COleServerItem CCmdTarget::RestoreWaitCursorvoid RestoreWaitCursor( ); 说明 本函数用于在系统光标改变后重置沙漏标（例如，在一个耗时操作的过程中打开一个消息窗口而后又关闭它。） 请参阅 CWaitCusor, CCmdTarget:: EndWaitCursor, CCmdTarget::BeginWaitCursor, CWinApp::DoWaitCursor |
CCmdTarget
墨衍会员
·
AI 创作全网分发
墨衍智能分发
本文由作者通过墨衍一键同步至各平台
1分发平台
4.8k累计阅读
4.9k平均单平台
已同步平台
CSDN
微信公众号
微博
知乎
掘金
百家号
博客园
抖音
小红书
你的文章也可以这样分发
墨衍会员 ¥399起/年，写一次发全网
我也要
1203
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
