CCmdTarget

CCmdTarget

类CCmdTarget是MFC类库中消息映射体系的一个基类。消息映射把命令或消息引导给用户为之编写的响应函数(命令是由菜单项、命令按钮或者加速键产生的消息)。从CCmdTarget继承来的按键框架类包括:CView、CWinApp、CDocument、CWnd和CFrameWnd。如果想生成一个处理按键消息的类,可以选择其中的一个派生一个子类。很少需要直接从CCmdTarget派生类。相关的命令目标和OnCmdMsg例程的其它信息,请参阅联机文档“VisualC++程序员指南斨械摹懊钅勘辍薄ⅰ懊盥酚伞焙汀坝成湎ⅰ辈糠帧@郈CmdTarget包括了处理沙漏形光标显示的成员函数。当某个命令的执行时间比较长时,可以显示沙漏标提示用户命令正在执行。和消息映射类似,分派映射用于列出OLE自动的IDispatch功能。列出这个接口后,其它的应用(如VB)就能调用这个应用了。有关IDispatch接口的更详细的信息,请参阅“Win32 SDK OLE程序员参考”中的“创建IDPatch接口”和“分派接口与API函数”。
#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 
}
 
请参阅  CWaitCursor,
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 
}
 
请参阅  CWaitCursor,
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
 
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值