Qt对话框与界面设计——常见的对话框

目录

QMessageBox - 提供不同类型的消息对话框

QFileDialog - 文件选择对话框

QColorDialog - 颜色选择对话框

QFontDialog - 字体选择对话框

QInputDialog - 输入对话框

QPrintDialog - 打印机选择对话框

QProgressDialog - 进度对话框

QMessageBox - 异常类型提示

QFileDialog

QColorDialog

QFontDialog

QProgressDialog

进度对话框的两种使用方式：

QInputDialog

补充

QFileDialog

枚举类型 (Enums)

成员函数 (Member Functions)

静态函数 (Static Functions)

重写的函数 (Reimplemented Functions)

信号 (Signals)

QColorDialog

枚举类型 (Enums)

属性 (Properties)

成员函数 (Member Functions)

重写的公共函数 (Reimplemented Public Functions)

信号 (Signals)

静态公共成员函数 (Static Public Members)

重写的保护函数 (Reimplemented Protected Functions)

QFontDialog

枚举类型 (Enums)

属性 (Properties)

成员函数 (Member Functions)

重写的公共函数 (Reimplemented Public Functions)

信号 (Signals)

静态公共成员函数 (Static Public Members)

重写的保护函数 (Reimplemented Protected Functions)

QProgressDialog

属性 (Properties)

成员函数 (Member Functions)

重写的公共函数 (Reimplemented Public Functions)

公共槽 (Public Slots)

信号 (Signals)

重写的保护函数 (Reimplemented Protected Functions)

保护槽 (Protected Slots)

QInputDialog

公共类型 (Public Types)

属性 (Properties)

成员函数 (Member Functions)

重写的公共函数 (Reimplemented Public Functions)

信号 (Signals)

静态公共成员函数 (Static Public Members)

我们下面来仔细了解一下常见的特殊对话框

QMessageBox - 提供不同类型的消息对话框

QMessageBox 用于显示各种类型的消息框，例如信息框、警告框、错误框等。

QFileDialog - 文件选择对话框

QFileDialog 用于显示文件或目录选择对话框，支持打开、保存文件以及选择目录。

QColorDialog - 颜色选择对话框

QColorDialog 提供了一个颜色选择对话框，允许用户选择颜色。

QFontDialog - 字体选择对话框

QFontDialog 提供了一个字体选择对话框，允许用户选择字体、样式和大小。

QInputDialog - 输入对话框

QInputDialog 用于显示简单的输入对话框，支持文本、整数、浮动数值、列表项等输入。

QPrintDialog - 打印机选择对话框

QPrintDialog 用于显示打印机选择对话框，允许用户选择打印机及设置打印选项。

QProgressDialog - 进度对话框

QProgressDialog 用于显示一个进度条对话框，显示任务的执行进度。

QMessageBox - 异常类型提示

QFileDialog

QFileDialog 类使用户能够浏览文件系统，选择一个或多个文件，或选择一个目录。

最简单的创建 QFileDialog 的方式是使用静态函数，例如 getOpenFileName()：

cpp复制代码fileName = QFileDialog::getOpenFileName(this,
    tr("Open Image"), "/home/jana", tr("Image Files (*.png *.jpg *.bmp)"));

在上面的例子中，通过静态函数创建了一个模态 QFileDialog 对话框。对话框最初显示的是 /home/jana 目录的内容，并显示与字符串 "Image Files (*.png *.jpg *.bmp)" 匹配的文件类型。文件对话框的父窗口设置为 this，并且窗口标题设置为 "Open Image"。如果你想使用多个过滤器，可以使用双分号将每个过滤器分开。例如：

"Images (*.png *.xpm *.jpg);;Text files (*.txt);;XML files (*.xml)"

你也可以在不使用静态函数的情况下创建自定义的 QFileDialog。通过调用 setFileMode()，你可以指定用户在对话框中必须选择什么：

QFileDialog dialog(this);
dialog.setFileMode(QFileDialog::AnyFile);

在上面的例子中，文件对话框的模式设置为 AnyFile，这意味着用户可以选择任何文件，甚至可以指定一个不存在的文件。这个模式适用于创建“另存为”文件对话框。如果用户必须选择一个已经存在的文件，可以使用 ExistingFile；如果只允许选择目录，可以使用 Directory。有关完整的模式列表，请参见 QFileDialog::FileMode 枚举。

fileMode 属性包含了对话框的操作模式，这决定了用户应该选择何种类型的对象。可以使用 setNameFilter() 来设置对话框的文件过滤器。例如：

dialog.setNameFilter(tr("Images (*.png *.xpm *.jpg)"));

在上面的例子中，过滤器设置为 "Images (*.png *.xpm *.jpg)"，这意味着只有扩展名为 png、xpm 或 jpg 的文件会在 QFileDialog 中显示。你可以通过使用 setNameFilters() 来应用多个过滤器。使用 selectNameFilter() 可以选择给定的默认过滤器。

文件对话框有两种视图模式：列表视图和详细视图。列表视图将当前目录的内容呈现为文件和目录名称的列表；详细视图也显示文件和目录名称的列表，但在每个名称旁边还会显示其他信息，如文件大小和修改日期。可以通过 setViewMode() 来设置视图模式：

dialog.setViewMode(QFileDialog::Detail);

创建自定义文件对话框时，最后一个重要的函数是 selectedFiles()。

QStringList fileNames;
if (dialog.exec())
    fileNames = dialog.selectedFiles();

在上面的例子中，创建并显示了一个模态文件对话框。如果用户点击了 OK，选择的文件将被放入 fileNames 中。对话框的工作目录可以通过 setDirectory() 来设置。每个文件都可以使用 selectFile() 函数来选择。

默认情况下，如果平台有原生文件对话框，将使用平台原生对话框。在这种情况下，通常用于构造对话框的小部件不会被实例化，因此相关的访问器（如 layout() 和 itemDelegate()）将返回 null。另外，并不是所有平台都会显示带有标题栏的文件对话框，因此标题文本可能对用户不可见。你可以通过设置 DontUseNativeDialog 选项，或者设置 AA_DontUseNativeDialogs 应用程序属性，确保使用基于小部件的实现，而不是原生对话框。

QColorDialog

颜色对话框的功能是允许用户选择颜色。例如，在绘图程序中，用户可以通过此对话框设置画笔颜色。静态函数提供了模态颜色对话框。

getColor() 静态函数显示颜色对话框，允许用户指定颜色。此函数也可以让用户选择带有透明度的颜色：通过传递 ShowAlphaChannel 选项作为附加参数。

用户可以存储最多 customCount() 个自定义颜色。自定义颜色在所有颜色对话框之间共享，并且在程序执行期间会被记住。可以使用 setCustomColor() 来设置自定义颜色，使用 customColor() 来获取这些颜色。

当按下“拾取屏幕颜色”按钮时，鼠标指针会变为十字形，屏幕上的颜色会被扫描。用户可以通过点击鼠标或按 Enter 键来选择颜色。按下 Escape 键则会恢复进入此模式之前选择的最后一个颜色。

QFontDialog

QFontDialog 通过静态的 getFont() 函数来创建。

bool ok;
QFont font = QFontDialog::getFont(
                &ok, QFont("Helvetica [Cronyx]", 10), this);
if (ok) {
    // the user clicked OK and font is set to the font the user selected
} else {
    // the user canceled the dialog; font is set to the initial
    // value, in this case Helvetica [Cronyx], 10
}

在这个例子中，getFont() 函数返回一个用户选择的字体，并通过 ok 参数告知用户是否点击了“OK”。如果用户选择了字体并点击了 OK，那么 font 将是用户选定的字体；如果用户点击了 Cancel，那么 font 保持原始值（此处为 Helvetica [Cronyx], 10）。

myWidget.setFont(QFontDialog::getFont(0, myWidget.font()));

在这个例子中，getFont() 允许你直接设置一个小部件的字体。如果用户点击了 OK，那么选择的字体会应用到 myWidget；如果用户点击了 Cancel，则会保持原始的字体设置。

QProgressDialog

QProgressDialog 是用来给用户提供一个操作进度的可视化提示，并显示操作的进度。它通常用于较长时间的操作中，让用户知道操作还在进行，并且防止界面看起来“冻结”。此外，用户还可以通过进度对话框中提供的取消按钮来中止当前操作。

1. 设置最小和最大值：setMinimum() 和 setMaximum() 用来设置操作的“步数”。进度条会根据这些值更新。通常可以使用操作的单位来定义步数（如文件个数、字节数等）。

2. 显示进度：操作执行时，可以通过 setValue() 方法更新进度条的当前值。

3. 自动重置和关闭：当操作完成后，进度条会自动重置并隐藏。可以通过 setAutoReset() 和 setAutoClose() 来改变这一行为。

进度对话框的两种使用方式：

• 模态进度对话框：更简单直接。程序员可以在一个循环中执行操作，定期调用 setValue() 更新进度，同时使用 wasCanceled() 检查用户是否取消了操作。例如：

cpp复制代码QProgressDialog progress("Copying files...", "Abort Copy", 0, numFiles, this);
progress.setWindowModality(Qt::WindowModal);
​
for (int i = 0; i < numFiles; i++) {
    progress.setValue(i);
​
    if (progress.wasCanceled())
        break;
    // ... copy one file
}
progress.setValue(numFiles);

在这种模式下，QProgressDialog 会在操作期间阻塞用户交互，直到操作完成或被用户取消。

• 无模态进度对话框：适用于后台任务，用户可以在任务进行时继续与应用程序进行交互。这类操作通常依赖于定时器（如 QTimer）或在后台线程中执行。进度对话框通常也可以在主窗口的状态栏中使用 QProgressBar 来替代。无模态进度对话框需要事件循环来运行，并连接 canceled() 信号到一个槽来停止操作。例如：

cpp复制代码// Operation constructor
Operation::Operation(QObject *parent)
    : QObject(parent), steps(0)
{
    pd = new QProgressDialog("Operation in progress.", "Cancel", 0, 100);
    connect(pd, &QProgressDialog::canceled, this, &Operation::cancel);
    t = new QTimer(this);
    connect(t, &QTimer::timeout, this, &Operation::perform);
    t->start(0);
}
​
void Operation::perform()
{
    pd->setValue(steps);
    // ... perform one percent of the operation
    steps++;
    if (steps > pd->maximum())
        t->stop();
}
​
void Operation::cancel()
{
    t->stop();
    // ... cleanup
}

这种模式通常适用于后台的长时间操作，允许用户继续与程序交互。

QProgressDialog 提供了一些方法来定制对话框的外观和行为，例如：

• setLabel()：设置显示在对话框中的标签。

• setBar()：设置进度条。

• setCancelButton()：设置取消按钮。

可以通过 setLabelText() 和 setCancelButtonText() 来修改文本内容。为了避免在硬件差异较大的环境中出现不必要的进度对话框显示，QProgressDialog 会根据操作所需的时间估算来决定是否显示进度对话框。只有当操作的估计时间超过了 minimumDuration()（默认值为 4 秒）时，进度对话框才会显示。

QInputDialog

QInputDialog 提供了五个静态的便利函数，用于获取不同类型的用户输入。它们分别是：getText()、getMultiLineText()、getInt()、getDouble() 和 getItem()。这些函数的用法类似，允许你通过对话框获取文本、整数、浮动点数或从列表中选择一个项。

例如，使用 getText() 函数可以获取一个字符串输入：

bool ok;
QString text = QInputDialog::getText(this, tr("QInputDialog::getText()"),
                                     tr("User name:"), QLineEdit::Normal,
                                     QDir::home().dirName(), &ok);
if (ok && !text.isEmpty()) {
    textLabel->setText(text);
}

补充

QFileDialog

枚举类型 (Enums)

成员函数 (Member Functions)

静态函数 (Static Functions)

重写的函数 (Reimplemented Functions)

信号 (Signals)

QColorDialog

枚举类型 (Enums)

属性 (Properties)

成员函数 (Member Functions)

重写的公共函数 (Reimplemented Public Functions)

信号 (Signals)

静态公共成员函数 (Static Public Members)

重写的保护函数 (Reimplemented Protected Functions)

QFontDialog

枚举类型 (Enums)

属性 (Properties)

成员函数 (Member Functions)

重写的公共函数 (Reimplemented Public Functions)

信号 (Signals)

静态公共成员函数 (Static Public Members)

重写的保护函数 (Reimplemented Protected Functions)

QProgressDialog

属性 (Properties)

成员函数 (Member Functions)

重写的公共函数 (Reimplemented Public Functions)

公共槽 (Public Slots)

信号 (Signals)

重写的保护函数 (Reimplemented Protected Functions)

保护槽 (Protected Slots)

QInputDialog

公共类型 (Public Types)

1. InputDialogOption 枚举类型，定义输入对话框的选项：

   • NoButtons：不显示按钮。

   • UseListViewForComboBoxItems：在组合框中使用列表视图。

   • UsePlainTextEditForTextInput：使用纯文本编辑器输入。

2. InputMode 枚举类型，定义输入的模式：

   • TextInput：文本输入。

   • IntInput：整数输入。

   • DoubleInput：浮动点数输入。

属性 (Properties)

成员函数 (Member Functions)

重写的公共函数 (Reimplemented Public Functions)

信号 (Signals)

静态公共成员函数 (Static Public Members)