CCmdTarget

最新推荐文章于 2019-07-19 16:45:00 发布

firectrl

最新推荐文章于 2019-07-19 16:45:00 发布

阅读量4.7k

点赞数

分类专栏： VC学习文章标签： mfc 框架文档 c++ null vb

本文链接：https://blog.csdn.net/firectrl/article/details/1787629

版权

VC学习专栏收录该内容

14 篇文章 0 订阅

订阅专栏

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