CMiniFrameWnd 类

项目
10/16/2023

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

语法

class CMiniFrameWnd : public CFrameWnd

成员

公共构造函数

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

公共方法

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

备注

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

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

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

继承层次结构

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_GETMINMAXINFO、WM_NCCREATE、WM_NCCALCSIZE 和 WM_CREATE 消息发送到窗口。

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

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

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

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

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

另请参阅

CFrameWnd 类
 层次结构图
 CFrameWnd 类

Share via