CMiniFrameWnd 类

表示通常在浮动工具条周围出现的半高框架窗口。

语法

class CMiniFrameWnd : public CFrameWnd

成员

公共构造函数

名称 描述
CMiniFrameWnd::CMiniFrameWnd 构造 CMiniFrameWnd 对象。

公共方法

名称 描述
CMiniFrameWnd::Create 在构造后创建 CMiniFrameWnd 对象。
CMiniFrameWnd::CreateEx 在构造后创建 CMiniFrameWnd 对象(具有其他选项)。

备注

这些微型框窗口的行为类似于普通框架窗口,不同的是它们没有最小化/最大化按钮或菜单,只需单击系统菜单即可将其关闭。

若要使用 CMiniFrameWnd 对象,请先定义该对象。 然后调用 Create 成员函数以显示微型框窗口。

有关如何使用 CMiniFrameWnd 对象详细信息,请参阅文章停靠和浮动工具栏

继承层次结构

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

要求

标头:afxwin.h

CMiniFrameWnd::CMiniFrameWnd

构造 CMiniFrameWnd 对象,但不创建窗口。

CMiniFrameWnd();

注解

若要创建窗口,请调用 CMiniFrameWnd::Create

CMiniFrameWnd::Create

创建 Windows 微型框窗口并将其附加到 CMiniFrameWnd 对象。

virtual BOOL Create(
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

参数

lpClassName
指向命名 Windows 类的以 null 终止的字符串。 类名可以是向全局 AfxRegisterWndClass 函数注册的任何名称。 如果为 NULL,则框架将为你注册窗口类。 MFC 为默认类提供以下样式和特性:

  • 将样式位设置为 CS_DBLCLKS,当用户双击鼠标时,它会将双击消息发送到窗口过程。

  • 将样式位设置为 CS_HREDRAW 和 CS_VREDRAW,当窗口更改大小时,它会指示重新绘制工作区的内容。

  • 将类光标设置为 Windows 标准 IDC_ARROW。

  • 将类背景画笔设置为 NULL,因此窗口不会擦除其背景。

  • 将类图标设置为标准的 Windows 徽标图标(飘扬的旗帜)。

  • 将窗口设置为默认大小和位置,如 Windows 指示。

lpWindowName
指向包含窗口名称的以 null 终止的字符串。

dwStyle
指定窗口样式特性。 这些特性可以包括标准窗口样式和以下一个或多个特殊样式:

  • MFS_MOVEFRAME 允许通过单击窗口的任何边缘(而不仅仅是标题)移动微型框窗口。

  • MFS_4THICKFRAME 禁用微型框窗口的大小调整。

  • MFS_SYNCACTIVE 将微型框窗口的激活同步到其父窗口的激活。

  • MFS_THICKFRAME 允许将微型框窗口的大小调整为允许的工作区内容。

  • MFS_BLOCKSYSMENU 禁用对系统菜单和控件菜单的访问,并将其转换为标题栏(标题栏)的一部分。

有关可能的窗口样式值的说明,请参阅 CWnd::Create。 用于微型框窗口的典型组合是 WS_POPUP|WS_CAPTION|WS_SYSMENU

rect
用于指定窗口的所需维度的 RECT 结构。

pParentWnd
指向父窗口。 对顶级窗口使用 NULL。

nID
如果微型框窗口创建为子窗口,则这是子控件的标识符;否则为 0。

返回值

如果成功,则不为 0;否则为 0。

备注

Create 初始化窗口的类名称和窗口名称,并为其样式和父级注册默认值。

CMiniFrameWnd::CreateEx

创建一个 CMiniFrameWnd 对象。

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

参数

dwExStyle
指定要创建的 CMiniFrameWnd 的扩展样式。 将任何扩展窗口样式应用于窗口。

lpClassName
指向命名 Windows 类(WNDCLASS 结构)的以 null 终止的字符串。 类名可以是向全局 AfxRegisterWndClass 函数注册的任何名称或任何预定义的控件类名称。 不得为 NULL。

lpWindowName
指向包含窗口名称的以 null 终止的字符串。

dwStyle
指定窗口样式特性。 有关可能值的说明,请参阅窗口样式CWnd::Create

rect
窗口的大小和位置,以 pParentWnd 的客户端坐标表示。

pParentWnd
指向父窗口对象。

nID
子窗口的标识符。

返回值

如果成功,则返回 TRUE;如果失败,则返回 FALSE。

备注

CreateEx 参数指定 WNDCLASS、窗口样式和(可选)窗口的初始位置和大小。 CreateEx 还指定窗口的父级(如果有)和 ID。

执行 CreateEx 时,Windows 会将 WM_GETMINMAXINFOWM_NCCREATEWM_NCCALCSIZEWM_CREATE 消息发送到窗口。

若要扩展默认消息处理,请从 CMiniFrameWnd 派生一个类,将消息映射添加到新类,并为上述消息提供成员函数。 例如,重写 OnCreate 以为新类执行所需的初始化。

重写其他 OnMessage 消息处理程序以向派生类添加更多功能。

如果指定了 WS_VISIBLE 样式,则 Windows 会向窗口发送激活和显示窗口所需的所有消息。 如果窗口样式指定标题栏,则 lpszWindowName 参数指向的窗口标题将显示在标题栏中。

dwStyle 参数可以是窗口样式的任意组合。

不再支持旧样式调色板工具箱窗口。 在早期版本的 Windows 上运行 MFC 应用程序时,支持没有“X”关闭按钮的旧样式,但在 Visual C++.NET 中不再受支持。 现在仅支持新的 WS_EX_TOOLWINDOW 样式;有关此样式的说明,请参阅扩展窗口样式

另请参阅

CFrameWnd 类
层次结构图
CFrameWnd 类