CFrameWnd选件类

提供的Windows函数单文档界面与管理窗口的成员一起的重叠或弹出框架窗口,(SDI)。

class CFrameWnd : public CWnd

成员

za93adby.collapse_all(zh-cn,VS.110).gif公共构造函数

名称

说明

CFrameWnd::CFrameWnd

构造 CFrameWnd 对象。

za93adby.collapse_all(zh-cn,VS.110).gif公共方法

名称

说明

CFrameWnd::ActivateFrame

具有帧可见并提供给用户。

CFrameWnd::BeginModalState

设置框架窗口到模式。

CFrameWnd::Create

调用创建和初始化Windows框架窗口与 CFrameWnd 对象。

CFrameWnd::CreateView

创建在从 CView未派生的帧中的视图。

CFrameWnd::DockControlBar

停靠控件条。

CFrameWnd::EnableDocking

允许控制条停靠。

CFrameWnd::EndModalState

关闭框架窗口的模式状态。 启用 BeginModalState禁用所有窗口。

CFrameWnd::FloatControlBar

浮点控制条。

CFrameWnd::GetActiveDocument

返回有效的 CDocument 对象。

CFrameWnd::GetActiveFrame

返回有效的 CFrameWnd 对象。

CFrameWnd::GetActiveView

返回有效的 CView 对象。

CFrameWnd::GetControlBar

检索控件条。

CFrameWnd::GetDockState

检索框架窗口的停靠状态。

CFrameWnd::GetMenuBarState

检索菜单中显示状态在当前MFC应用程序的。

CFrameWnd::GetMenuBarVisibility

指示菜单的默认行为在当前MFC应用程序的是否为隐藏或可见。

CFrameWnd::GetMessageBar

返回指向的指针属于框架窗口的状态栏。

CFrameWnd::GetMessageString

检索消息与命令ID.相应

CFrameWnd::GetTitle

检索相关控件条的标题。

CFrameWnd::InitialUpdateFrame

在将调用框架窗口导致属于所有视图的 OnInitialUpdate 成员函数。

CFrameWnd::InModalState

返回指示框架窗口是否为值在一个模式状态。

CFrameWnd::IsTracking

确定拆分栏当前是否正在移动。

CFrameWnd::LoadAccelTable

调用加载快捷键对应表。

CFrameWnd::LoadBarState

调用还原控件条的设置。

CFrameWnd::LoadFrame

调用动态创建从资源信息的框架窗口。

CFrameWnd::NegotiateBorderSpace

协调在框架窗口的边框空间。

CFrameWnd::OnBarCheck

调用,每当事件在指定的控制条执行。

CFrameWnd::OnContextHelp

就地项目中处理SHIFT+F1帮助。

CFrameWnd::OnSetPreviewMode

设置应用程序的主框架窗口到并在打印预览模式之外。

CFrameWnd::OnUpdateControlBarMenu

调用由框架,这种关联的菜单更新。

CFrameWnd::RecalcLayout

重新定位 CFrameWnd 对象的控制条。

CFrameWnd::SaveBarState

调用保存控件条的设置。

CFrameWnd::SetActivePreviewView

指定指定的视图是丰富预览的活动视图。

CFrameWnd::SetActiveView

设置活动 CView 对象。

CFrameWnd::SetDockState

调用停靠在主窗口框架窗口。

CFrameWnd::SetMenuBarState

将当前MFC应用程序中隐藏或显示的菜单上显示状态。

CFrameWnd::SetMenuBarVisibility

设置菜单的默认行为在当前MFC应用程序的是隐藏或可见。

CFrameWnd::SetMessageText

设置标准状态栏的文本。

CFrameWnd::SetProgressBarPosition

将Windows的当前位置显示的7进度栏在任务栏。

CFrameWnd::SetProgressBarRange

将Windows的范围在任务栏的显示7进度栏。

CFrameWnd::SetProgressBarState

设置在任务栏按钮显示的进度指示器的类型和状态。

CFrameWnd::SetTaskbarOverlayIcon

已重载。 对复盖率任务栏按钮指示应用程序状态或通知给用户。

CFrameWnd::SetTitle

一组相关控件条的标题。

CFrameWnd::ShowControlBar

调用显示控件条。

CFrameWnd::ShowOwnedWindows

显示是 CFrameWnd 对象的子代的所有窗口。

za93adby.collapse_all(zh-cn,VS.110).gif受保护的方法

名称

说明

CFrameWnd::OnCreateClient

创建框架的客户端窗口。

CFrameWnd::OnHideMenuBar

调用在当前MFC应用程序菜单之前隐藏。

CFrameWnd::OnShowMenuBar

调用在当前MFC应用程序的菜单中显示。

za93adby.collapse_all(zh-cn,VS.110).gif公共数据成员

名称

说明

CFrameWnd::m_bAutoMenuEnable

自动的控件启用和禁用菜单项的功能。

CFrameWnd::rectDefault

在创建 CFrameWnd 对象允许Windows选择窗口的初始大小和位置时,请通过此静态 CRect 作为参数。

备注

若要创建应用程序的一个有用的框架窗口,从 CFrameWnd派生选件类。 添加成员变量添加到派生类来存储数据特定于您的应用程序。 实现消息处理程序成员函数和消息映射在派生类指定发生的情况,在处理消息到windows时。

有三种构造框架窗口:

  • 使用 创建,请直接构造它。

  • 使用 LoadFrame,请直接构造它。

  • 使用文档模板,请取消构造它。

在调用 CreateLoadFrame之前,使用C++ new 运算符,则必须生成堆中的框架窗口对象。 在调用 Create之前,可以注册窗口选件类。也将框架的图标和选件类样式的 AfxRegisterWndClass 全局函数。

使用 Create 成员函数通过帧的创建参数作为即时参数。

LoadFrameCreate需要的参数和从资源中检索大多数其默认值,包括帧的说明、图标、快捷键对应表和菜单。 若要访问由 LoadFrame,所有这些资源必须具有相同的资源ID (例如,IDR_MAINFRAME)。

CFrameWnd 对象包含视图和文档时,它们是间接由框架创建的而不是直接程序员。 CDocTemplate 对象协调下帧,包含"视图中创建的创建,因此,视图的连接与相应文档。 CDocTemplate 构造函数的参数指定涉及的三选件类的 CRuntimeClass (文档,则框架和视图)。 框架用于 CRuntimeClass 对象动态创建新框架,指定由用户(例如,通过使用文件的命令或多文档界面(mdi) (MDI)窗口新的命令)。

必须声明从派生 CFrameWnd 框架窗口选件类与 DECLARE_DYNCREATE 为上面 RUNTIME_CLASS 结构才能正常工作。

CFrameWnd 到Windows的典型的应用程序包含默认实现来执行一个主窗口的以下功能:

  • CFrameWnd 框架窗口记录是Windows活动窗口或当前输入焦点的独立的一个当前活动的视图。 这些帧重新激活时,活动视图通过调用 CView::OnActivateView通知。

  • 命令消息和许多常见帧通知消息,包括 OnSetFocus处理的错误,OnHScrollCWndOnVScroll 功能,由 CFrameWnd 框架窗口委托给为当前活动的视图。

  • 为当前活动的视图(或在MDI框架的当前活动的MDI子框架窗口)可以确定框架窗口的说明。 此功能可通过关闭 FWS_ADDTOTITLE 样式禁用bit框架窗口。

  • CFrameWnd 框架窗口管理确定控制条、视图和其他子窗口在框架窗口的工作区内。 框架窗口还执行闲置时更新工具栏和其他控件条按钮。 CFrameWnd 框架窗口还有命令的默认实现打开或关闭的工具栏和状态栏。

  • CFrameWnd 框架窗口管理主菜单栏。 当弹出菜单显示时,框架窗口使用 UPDATE_COMMAND_UI framework确定应启用,禁用或查看哪些菜单项。 当用户选择菜单项时,框架窗口更新消息字符串的状态栏该命令的。

  • CFrameWnd 框架窗口将自动转换键盘快捷键的一个选项快捷键对应表。

  • 有关上下文相关帮助的 CFrameWnd 框架窗口都有一个选项可帮助ID设置为 LoadFrame。 框架窗口是semimodal状态的主要管弦乐队例如区分上下文的帮助(SHIFT+F1)和打印预览模式。

  • CFrameWnd 框架窗口将打开在框架窗口拖动从文件管理器和删除的文件。 如果文件扩展名并将向应用程序注册,框架窗口回答发生的动态数据交换(dde) (DDE)打开请求,当用户打开在文件管理器的数据文件,或者 ShellExecute Windows函数调用时。

  • 如果框架窗口是主应用程序窗口(即 CWinThread::m_pMainWnd),那么,当用户关闭应用程序时,框架窗口提示用户保存任何修改文档(对于 OnCloseOnQueryEndSession)。

  • 如果框架窗口是主应用程序窗口,框架窗口是运行的WinHelp上下文。 如果它对于此应用程序,帮助生成已关闭框架窗口将关闭WINHELP.EXE。

不要使用C++ delete 运算符销毁框架窗口。 请改用 CWnd::DestroyWindow。 当销毁,PostNcDestroyCFrameWnd 实现会删除C++对象窗口。 当用户关闭框架窗口,默认 OnClose 处理程序将调用 DestroyWindow

有关 CFrameWnd的更多信息,请参见 Windows框架

继承层次结构

CObject

CCmdTarget

CWnd

CFrameWnd

要求

**标头:**afxwin.h

请参见

参考

CWnd 类

层次结构图

CWnd 类

CMDIFrameWnd选件类

CMDIChildWnd选件类

CView选件类

CDocTemplate选件类

CRuntimeClass结构