Qt常用的按钮控件编程（三）

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

本文介绍QT常用控件的第三个按钮，QRadioButton 单选按钮编程。通过这个例子，初步了解QT管理资源机制，以及如何分组管理QRadioButton 单选按钮。项目演示如何使用默认的分组和 QButtonGroup 进行互斥设置，保证多个选项所在的组内只有一个被选中。项目使用样式表文件将两组按钮使用不同的样式表进行外观设置。 文章中使用的例程和内容都是在chatgpt的帮助下完成的，例程经过测试通过。 我们的调试环境仍然是双架构Kits，编译调试在当前的ubuntu（qt5）中进行，重新编译后下载到目标arm设备（qt4）中运行。 我们的编程环境为：Ubuntu64位系统（22.04），目标架构：（1）qt5 x86_64 架构，（2）qt4 32位arm架构。 环境配置请参见《Qt常用的按钮控件编程（一）》第1节。

QRadioButton 是 Qt 中的一个控件类，表示一个单选按钮。在一组单选按钮中，只有一个可以被选中。通常配合 QButtonGroup 使用来实现分组单选功能。

该例程利用 QRadioButton 控件实现了多选项的单选，让用户方便地进行选择。通过默认的分组和 QButtonGroup 进行互斥设置，保证多个选项所在的组内只有一个被选中，从而达到符合用户交互习惯的效果。例程中涉及到了 单选按钮（QRadioButton） 和 按钮组（QButtonGroup ）控件的使用。 在该例程中，5 个 单选控件分为 2 组，分别为第一组的 2 个单选控件和第二组的 3 个 单选控件。我们的程序将 5 个控件添加到主窗口中。 对于第一组的 2 个 单选控件，使用 Qt 默认的分组功能，即将这两个控件放在主窗口中，因为 QRadioButton 是继承自 QAbstractButton 的，所以它的自动互斥特性会自动生效，即任何一组中多个 QRadioButton 控件只能有一个被选中。 对于第二组的 3 个 单选控件，使用 按钮组（QButtonGroup ）来实现互斥。这里我们新建一个 QButtonGroup 控件，将其加入到主窗口中，然后将窗口中的 3 个单选控件分别添加到该 QButtonGroup 中。这样，当选中其中某个单选控件时，其他组内的单选控件会自动取消选择。可以通过 setChecked() 函数设置初始选中状态，程序启动后，用户可以通过鼠标或触摸选择其他单选控件。

其中开关一和开关二为第一组，选择一、选择二、选择三第二组。

打开 Qt Creator 并创建一个新的 应用程序项目_radiobutton,选择了Widget基类，不要勾选“Generate form”,将两个配置好的Kits同时选上,项目新建完成如下图。(详细的项目新建过程参见：《Qt常用的按钮控件编程（一）》）

在 Qt 中，可以使用资源文件（.qrc 文件）将一些静态资源（如图像、音频等）打包到应用程序中，以方便统一管理和部署。在本例程中，在images 文件夹中准备了4张图片，拷贝到本项目路径中，下图演示了如何将资源添加到项目中。

输入资源文件的名称(自行定义)和位置，然后点击“下一步”。

在 Qt Creator 中新建资源文件后，默认会进入 res.qrc 文件编辑模式（如果关闭了，可以右键这个文 件点击选择“Open in Editor”），为了方便分类管理文件，我们可以使用 Add Prefix 功能为资源文件添加前缀，前缀的格式应该为类似文件系统中的路径格式，例如 /images。 为了确保路径正确，前缀中的 / 是必需的，它在资源文件引用时是路径分隔符，起到类似 Linux 下根节点的作用，我们现在第⑪处添加了前缀/。 添加了前缀后，我们添加资源图片，放在/images 前缀的下面。这里我们导入在本项目路径 images 文件夹中的4张图片，添加完成需要按“Ctrl + S”保存 res.qrc 才会看到左边的结果。添加完成如下图。

QSS 文件是使用 Qt 程序相关联的样式表文件。它由 GUI 元素的外观和感觉，包括布局，颜色，鼠标的行为，大小和字体。它的风格，一个可以合并到一个 UI（用户界面）。与 HTML 的 CSS 类似，Qt 的样式表是纯文本的格式定义，在应用程序运行时可以载入和解析这些样式定义，从而使应用程序的界面呈现不同的效果。 如上图加入一个空白文件，新建的文件名 style.qss 文件，如下图，默认添加到项目的路径下，后面步骤采用默认，直至完成。 编辑style.qss，保存，最后完成的项目如下图所示：

style.qss文件内容：

我们在系统生成的项目文件中使用条件编译增加目标为qt4-arm时的代码：

为了解决当程序运行在arm架构系统时，中文显示文乱码问题，根据从.pro获得的宏QT_ARM_PLATFORM作为编译条件，判断如果系统运行在arm架构，则程序包含文本字符串转换，解决Qt4中文乱码问题。

第 24 行至 37 行，读取 style.qss 的内容。并设置全局样式。

点击窗口左边的Debug，可以选择编译运行在不同平台上的可执行文件，arm-v7为arm架构的设备，使用Qt4库，而桌面则是当前ubuntu系统，使用Qt5。 Qt5编译完成的可执行程序_qcheckbox，存放在项目目录的build-_qcheckbox-unknown-Debug/文件夹下，Qt4编译完成的可执行程序_qcheckbox，存放在项目目录的build-_qcheckbox-arm_v7-Debug/文件夹下。

在 Qt 中，资源（Resource）指的是应用程序中的特殊文件，如图像、文本等。Qt资源系统将这些资源文件封装为资源文件（Resource File），并将它们存储在.qrc文件中，然后使用rcc工具（编译时rcc工具会自动被调用）将.qrc文件编译成一种二进制格式，并与应用程序的可执行文件或库一并打包存储。

通过 Qt 提供的资源管理类可以方便的访问这些资源，这样可以有效地避免了文件路径问题以及繁琐的资源查找流程。使用 Qt 资源系统，可以使开发者更加方便地管理和使用应用程序中的资源，提高应用程序的质量和开发效率。

在我们的_radiobutton项目中，将4个图片文件和一个.qss样式表文件作为资源文件添加到.qrc文件。

.qss 文件是一个 Qt 样式表文件，用于为应用程序中的部件（例如按钮、文本框、标签等）定义自定义样式。它可以包含一些常规的样式属性，如字体、颜色、背景和边框设置，也可以包含复杂的样式设置，如图像背景、渐变色和阴影效果。 使用 .qss 文件，可以改变 Qt 部件的外观和行为，以匹配应用程序的主题和风格。可以选择遵循现有的样式规则，也可以通过定义自己的样式规则来创建全新的外观效果。.qss 文件是一种非常灵活和强大的方法，可以实现几乎任何自定义样式的要求。 事实上，Qt 应用程序中的样式文件名称可以完全自定义，只要在应用程序中正确地引用了它们即可。将样式表文件保存为 .qss 扩展名是一种推荐的做法，因为它可以让其他开发人员快速理解某个文件的用途。为节省时间并简化管理，通常建议将样式表文件保存在应用程序的一个单独目录中，并使用一致的命名约定。例如，可以将所有的样式表文件保存在 styles 目录下，并按照 theme_name.qss 的格式命名，其中 theme_name 是想要使用的主题名称。这样做可以使文件命名和管理更加清晰，并使代码更加易于维护。 如果不想使用样式表文件，仍然可以使用 setStyleSheet() 方法将样式定义直接嵌入到 Qt 应用程序的代码中，这样的做法会让应用程序的代码和布局变得混乱且难以维护。

QRadioButton 支持的图片文件类型包括： PNG 格式：PNG 格式是 Qt 支持的最常用的图片格式之一，它支持透明度和 alpha 通道，并且可以轻松地在不同的平台上进行交互和显示。 BMP 格式：BMP 格式也是 Qt 支持的常用图片格式之一，它可以在不同的平台上轻松地进行交互和显示。 GIF 格式：GIF 格式是一种支持动画和透明度的图片文件格式，但是它有一些限制，比如只支持 256 色。 JPEG 格式：JPEG 格式是一种常用的压缩图片格式，它可以在 Qt 中使用，并且可以配置图片质量。 SVG 格式：SVG 是一种矢量图形格式，可以在 Qt 中使用，并支持缩放和动画。 总的来说，QRadioButton 支持很多种图片格式，主要包括 PNG、BMP、GIF、JPEG 和 SVG 等，开发者可以根据自己的需要选择合适的图片格式。

ButtonGroup 是用于管理一组按钮的控件。它能够在一组互斥的按钮中，确保只有一个按钮被选中。当用户点击这组按钮中的一个按钮时，QButtonGroup 将会自动检测其中的选中状态并更新其它按钮的选中状态，以确保只有一个按钮被选中。 QButtonGroup 可以管理多种类型的按钮控件，包括：

虽然 QButtonGroup 可以像容器一样管理一组按钮，但事实上 QButtonGroup 并不是容器控件，而是 Qt 的一种支持控件。容器控件用于管理（即容纳）其他控件，例如 QWidget、QFrame、QSplitter 等，可以将多个控件作为其子控件添加到其内部，形成一个层次化的控件树。而 QButtonGroup 只是用于管理一组互斥的按钮，它并没有作为容器控件来管理其他控件。