当前位置： 首页 > news >正文

「Qt Widget中文示例指南」如何创建一个窗口标志？（一）

news 2026/7/6 20:47:46


Qt是目前最先进、最完整的跨平台C++开发工具。它不仅完全实现了一次编写，所有平台无差别运行，更提供了几乎所有开发过程中需要用到的工具。如今，Qt已被运用于超过70个行业、数千家企业，支持数百万设备及应用。

窗口标志要么是类型，要么是提示。类型用于为小部件指定各种窗口系统属性，一个小部件只能有一种类型，默认是Qt::Widget，但是小部件可以有零个或多个提示；提示用于自定义顶级窗口的外观。

小部件的标志存储在Qt::WindowFlags类型中，该类型存储标志的OR组合。

这个例子由两个类组成：

  • ControllerWindow是主要的应用程序小部件，它允许用户在可用的窗口标志中进行选择，并在单独的预览窗口中显示效果。
  • PreviewWindow是一个自定义小部件，在只读文本编辑器中显示当前设置的窗口标志的名称。

我们将从回顾ControllerWindow类开始，然后再看看PreviewWindow类。

ControllerWindow类定义
class ControllerWindow : public QWidget { Q_OBJECT public: ControllerWindow(QWidget *parent = nullptr); private slots: void updatePreview(); private: void createTypeGroupBox(); void createHintsGroupBox(); QCheckBox *createCheckBox(const QString &text); QRadioButton *createRadioButton(const QString &text); PreviewWindow *previewWindow; QGroupBox *typeGroupBox; QGroupBox *hintsGroupBox; QPushButton *quitButton; QRadioButton *windowRadioButton; QRadioButton *dialogRadioButton; QRadioButton *sheetRadioButton; QRadioButton *drawerRadioButton; QRadioButton *popupRadioButton; QRadioButton *toolRadioButton; QRadioButton *toolTipRadioButton; QRadioButton *splashScreenRadioButton; QCheckBox *msWindowsFixedSizeDialogCheckBox; QCheckBox *x11BypassWindowManagerCheckBox; QCheckBox *framelessWindowCheckBox; QCheckBox *windowNoShadowCheckBox; QCheckBox *windowTitleCheckBox; QCheckBox *windowSystemMenuCheckBox; QCheckBox *windowMinimizeButtonCheckBox; QCheckBox *windowMaximizeButtonCheckBox; QCheckBox *windowCloseButtonCheckBox; QCheckBox *windowContextHelpButtonCheckBox; QCheckBox *windowShadeButtonCheckBox; QCheckBox *windowStaysOnTopCheckBox; QCheckBox *windowStaysOnBottomCheckBox; QCheckBox *customizeWindowHintCheckBox; };

ControllerWindow类继承了QWidget，该小部件允许用户在可用的窗口标志中进行选择，并在单独的预览窗口中显示效果。

我们声明了一个私有updatePreview()槽，以便在用户更改窗口标志时刷新预览窗口。

我们还声明了几个私有函数来简化构造函数：调用createTypeGroupBox()函数，使用私有createButton()函数为每个可用的窗口类型创建一个单选按钮，并将它们收集到一个组框中。以类似的方式，我们使用createHintsGroupBox()函数为每个可用的提示创建一个复选框，使用私有的createCheckBox()函数。

除了各种单选按钮和复选框之外，我们还需要一个相关的PreviewWindow来显示当前选择的窗口标志的效果。

ControllerWindow类实现
ControllerWindow::ControllerWindow(QWidget *parent) : QWidget(parent) { previewWindow = new PreviewWindow(this); createTypeGroupBox(); createHintsGroupBox(); quitButton = new QPushButton(tr("&Quit")); connect(quitButton, &QPushButton::clicked, qApp, &QCoreApplication::quit); QHBoxLayout *bottomLayout = new QHBoxLayout; bottomLayout->addStretch(); bottomLayout->addWidget(quitButton); QHBoxLayout *mainLayout = new QHBoxLayout; mainLayout->addWidget(typeGroupBox); mainLayout->addWidget(hintsGroupBox); mainLayout->addLayout(bottomLayout); setLayout(mainLayout); setWindowTitle(tr("Window Flags")); updatePreview(); }

在构造函数中，我们首先创建预览窗口。然后使用私有的createTypeGroupBox()和createHintsGroupBox()函数创建包含可用窗口标志的组框。此外，我们还创建了一个Quit按钮，将按钮和一个可伸缩空间放在一个单独的布局中，来使按钮出现在WindowFlag小部件的右下角。

最后，我们将按钮的布局和两个组框添加到QVBoxLayout中，设置窗口标题并使用updatePreview()槽刷新预览窗口。

void ControllerWindow::updatePreview() { Qt::WindowFlags flags; if (windowRadioButton->isChecked()) flags = Qt::Window; else if (dialogRadioButton->isChecked()) flags = Qt::Dialog; else if (sheetRadioButton->isChecked()) flags = Qt::Sheet; else if (drawerRadioButton->isChecked()) flags = Qt::Drawer; else if (popupRadioButton->isChecked()) flags = Qt::Popup; else if (toolRadioButton->isChecked()) flags = Qt::Tool; else if (toolTipRadioButton->isChecked()) flags = Qt::ToolTip; else if (splashScreenRadioButton->isChecked()) flags = Qt::SplashScreen;

每当用户更改任何窗口标志时，就调用updatePreview()插槽。首先我们创建一个空Qt::WindowFlags标志，然后确定要检查的类型并将其添加到标志中。

if (msWindowsFixedSizeDialogCheckBox->isChecked()) flags |= Qt::MSWindowsFixedSizeDialogHint; if (x11BypassWindowManagerCheckBox->isChecked()) flags |= Qt::X11BypassWindowManagerHint; if (framelessWindowCheckBox->isChecked()) flags |= Qt::FramelessWindowHint; if (windowNoShadowCheckBox->isChecked()) flags |= Qt::NoDropShadowWindowHint; if (windowTitleCheckBox->isChecked()) flags |= Qt::WindowTitleHint; if (windowSystemMenuCheckBox->isChecked()) flags |= Qt::WindowSystemMenuHint; if (windowMinimizeButtonCheckBox->isChecked()) flags |= Qt::WindowMinimizeButtonHint; if (windowMaximizeButtonCheckBox->isChecked()) flags |= Qt::WindowMaximizeButtonHint; if (windowCloseButtonCheckBox->isChecked()) flags |= Qt::WindowCloseButtonHint; if (windowContextHelpButtonCheckBox->isChecked()) flags |= Qt::WindowContextHelpButtonHint; if (windowShadeButtonCheckBox->isChecked()) flags |= Qt::WindowShadeButtonHint; if (windowStaysOnTopCheckBox->isChecked()) flags |= Qt::WindowStaysOnTopHint; if (windowStaysOnBottomCheckBox->isChecked()) flags |= Qt::WindowStaysOnBottomHint; if (customizeWindowHintCheckBox->isChecked()) flags |= Qt::CustomizeWindowHint; previewWindow->setWindowFlags(flags);

我们还确定哪些暗示的检查，并将它们添加到标记使用的OR操作符，使用标志来设置预览窗口的窗口标志。

QPoint pos = previewWindow->pos(); if (pos.x() < 0) pos.setX(0); if (pos.y() < 0) pos.setY(0); previewWindow->move(pos); previewWindow->show(); }

我们调整预览窗口的位置，这样做的原因是在某些平台上，摆弄窗户的框架可能会导致窗户的位置在背后发生变化。如果窗口位于屏幕的左上角，则可能看不到该窗口的某些部分。因此我们调整小部件的位置，以确保如果发生这种情况，窗口在屏幕边界内移动，最后调用 QWidget::show() 来确保预览窗口可见。

void ControllerWindow::createTypeGroupBox() { typeGroupBox = new QGroupBox(tr("Type")); windowRadioButton = createRadioButton(tr("Window")); dialogRadioButton = createRadioButton(tr("Dialog")); sheetRadioButton = createRadioButton(tr("Sheet")); drawerRadioButton = createRadioButton(tr("Drawer")); popupRadioButton = createRadioButton(tr("Popup")); toolRadioButton = createRadioButton(tr("Tool")); toolTipRadioButton = createRadioButton(tr("Tooltip")); splashScreenRadioButton = createRadioButton(tr("Splash screen")); windowRadioButton->setChecked(true); QGridLayout *layout = new QGridLayout; layout->addWidget(windowRadioButton, 0, 0); layout->addWidget(dialogRadioButton, 1, 0); layout->addWidget(sheetRadioButton, 2, 0); layout->addWidget(drawerRadioButton, 3, 0); layout->addWidget(popupRadioButton, 0, 1); layout->addWidget(toolRadioButton, 1, 1); layout->addWidget(toolTipRadioButton, 2, 1); layout->addWidget(splashScreenRadioButton, 3, 1); typeGroupBox->setLayout(layout); }

私有的createTypeGroupBox()函数从构造函数中调用。

首先我们创建一个组框，然后为窗口标志中的每个可用类型创建一个单选按钮（使用私有的createRadioButton() 函数），我们将Qt::Window作为最初应用的类型，将单选按钮放入QGridLayout中，并将布局安装在组框上。

我们不包含默认的Qt::Widget类型，原因是它的行为与其他类型有些不同。如果没有为小部件指定类型，并且它没有父部件，则该小部件是窗口。但是如果它有父部件，它就是标准的子部件。其他类型都是顶级窗口，由于提示只影响顶级窗口，我们放弃Qt::Widget类型。

void ControllerWindow::createHintsGroupBox() { hintsGroupBox = new QGroupBox(tr("Hints")); msWindowsFixedSizeDialogCheckBox = createCheckBox(tr("MS Windows fixed size dialog")); x11BypassWindowManagerCheckBox = createCheckBox(tr("X11 bypass window manager")); framelessWindowCheckBox = createCheckBox(tr("Frameless window")); windowNoShadowCheckBox = createCheckBox(tr("No drop shadow")); windowTitleCheckBox = createCheckBox(tr("Window title")); windowSystemMenuCheckBox = createCheckBox(tr("Window system menu")); windowMinimizeButtonCheckBox = createCheckBox(tr("Window minimize button")); windowMaximizeButtonCheckBox = createCheckBox(tr("Window maximize button")); windowCloseButtonCheckBox = createCheckBox(tr("Window close button")); windowContextHelpButtonCheckBox = createCheckBox(tr("Window context help button")); windowShadeButtonCheckBox = createCheckBox(tr("Window shade button")); windowStaysOnTopCheckBox = createCheckBox(tr("Window stays on top")); windowStaysOnBottomCheckBox = createCheckBox(tr("Window stays on bottom")); customizeWindowHintCheckBox= createCheckBox(tr("Customize window")); QGridLayout *layout = new QGridLayout; layout->addWidget(msWindowsFixedSizeDialogCheckBox, 0, 0); layout->addWidget(x11BypassWindowManagerCheckBox, 1, 0); layout->addWidget(framelessWindowCheckBox, 2, 0); layout->addWidget(windowNoShadowCheckBox, 3, 0); layout->addWidget(windowTitleCheckBox, 4, 0); layout->addWidget(windowSystemMenuCheckBox, 5, 0); layout->addWidget(customizeWindowHintCheckBox, 6, 0); layout->addWidget(windowMinimizeButtonCheckBox, 0, 1); layout->addWidget(windowMaximizeButtonCheckBox, 1, 1); layout->addWidget(windowCloseButtonCheckBox, 2, 1); layout->addWidget(windowContextHelpButtonCheckBox, 3, 1); layout->addWidget(windowShadeButtonCheckBox, 4, 1); layout->addWidget(windowStaysOnTopCheckBox, 5, 1); layout->addWidget(windowStaysOnBottomCheckBox, 6, 1); hintsGroupBox->setLayout(layout); }

私有的createHintsGroupBox()函数也从构造函数中调用。

同样我们要做的第一件事是创建一个组框，然后使用私有的createCheckBox()函数为窗口标志中的每个可用提示创建一个复选框。我们将复选框放入QGridLayout中，并在组框上安装布局。

QCheckBox *ControllerWindow::createCheckBox(const QString &text) { QCheckBox *checkBox = new QCheckBox(text); connect(checkBox, &QCheckBox::clicked, this, &ControllerWindow::updatePreview); return checkBox; }

私有的createCheckBox()函数从createHintsGroupBox()调用。

我们只需用提供的文本创建一个QCheckBox，将其连接到私有的updatePreview()槽，并返回一个指向复选框的指针。

QRadioButton *ControllerWindow::createRadioButton(const QString &text) { QRadioButton *button = new QRadioButton(text); connect(button, &QRadioButton::clicked, this, &ControllerWindow::updatePreview); return button; }

在私有的createRadioButton()函数中，它是我们用提供的文本创建的QRadioButton，并连接到私有的updatePreview()槽。该函数从createTypeGroupBox()调用，并返回一个指向按钮的指针。

未完待续，精彩下期继续......

http://www.jsqmd.com/news/1136968/

相关文章：

  • SDC命令详解：使用get_nets命令进行查询
  • 3步打造你的专属Firefox浏览器：WaveFox主题定制完全指南
  • Xenia Manager未来路线图：即将推出的5大新功能预览
  • CDDStore性能优化指南：FPS监控、内存管理和启动优化终极教程
  • MAX9744与MKV42F128VLH16组合的D类音频放大器设计
  • Remotion键盘导航完全指南：用快捷键将视频制作效率提升300%
  • SDC命令详解：使用get_libs命令进行查询
  • 10分钟快速上手Stable Diffusion WebUI Forge：让AI绘画效果提升300%的终极指南
  • 深入解析FloatingView：Android悬浮动画库的核心架构
  • Crew vs Polecat：Gas Town中两种工作模式的最佳应用场景指南
  • 革命性文档主题pydata-sphinx-theme：打造专业级Python数据科学文档的完整指南
  • Paperxie 毕业论文智能写作｜毕业写论文全程不用硬扛，一套工具走完全流程
  • MKXP：让RPG Maker游戏在Linux上重获新生的开源引擎
  • Mix 2.0与Tailwind CSS集成：打造高效Flutter开发工作流
  • etcdadm安全最佳实践：证书管理、访问控制和网络安全的完整方案
  • 猫抓浏览器插件：网页视频资源嗅探与下载的终极开源解决方案
  • Gas Town跨项目协作指南：Worktree与Dispatch两种模式对比
  • SmartMirror手势识别算法优化：提升准确率与响应速度的7个方法
  • React-redux-toastr 源码深度剖析：从reducer到组件的完整实现原理
  • ubuntu24安装MaxKB
  • 终极Mac清理指南：如何用Mole一次性释放95.5GB存储空间
  • 题解：学而思编程 第K个约数
  • Linkora使用技巧：10个你必须知道的高效链接管理功能
  • Linkora vs 传统书签工具：为什么本地优先的链接管理器更适合你
  • 用自然语言控制任何设备：Midscene如何让自动化变得像说话一样简单
  • LiteLoaderQQNT安装脚本：三分钟搞定QQNT插件加载器部署
  • GeoQ用户权限管理：构建多层次地理数据访问控制体系
  • 00-生态工具链导学：构建完整工程化能力
  • 专业级像素字体革命：Fusion Pixel Font的多语言设计创新方案
  • zgrab支持的10种协议扫描全攻略：SMTP、FTP、Telnet等实战案例