【PySide6快速入门】QInputDialog输入对话框

前言

在桌面应用程序中，输入对话框是常见的用户交互方式之一。当需要获取用户输入时，QInputDialog 是一个非常实用的控件。它提供了多种形式的输入框，可以让用户在一个弹出式对话框中输入文本、选择数字、选择项等。本文将介绍 QInputDialog 的基本用法，帮助你轻松实现常见的输入需求。

什么是QInputDialog？

QInputDialog 是 PySide6 中用于创建标准输入对话框的控件。通过 QInputDialog，开发者可以向用户请求一个输入值，这个输入值可以是文本、数字、选项等。QInputDialog 提供了多种输入类型，可以方便地用于收集用户数据。它通常用于需要获取简单用户输入的场景，如提示用户输入文件名、数值、密码等。

特点：

1. 多种输入类型： 支持文本输入、整数输入、浮动数字输入、选择项等。
2. 简单易用： 通过简单的 API，可以快速创建输入对话框。
3. 自定义功能： 可以设置对话框的标题、标签、默认值等。
4. 信号与槽： 支持信号机制，可以通过信号获取用户的输入结果。

如何使用QInputDialog？

1. 获取文本输入

最常见的输入方式是获取文本，例如用户名或文件名。

示例代码：

from PySide6.QtWidgets import QApplication, QMainWindow, QInputDialog, QVBoxLayout, QPushButton, QWidget

app = QApplication([])

window = QWidget()
layout = QVBoxLayout()

def get_text_input():
    # 显示文本输入对话框
    text, ok = QInputDialog.getText(window, "Input Text", "Please enter your name:")
    if ok:
        print(f"Entered text: {text}")

# 创建按钮，点击时弹出文本输入对话框
button = QPushButton("Enter Text")
button.clicked.connect(get_text_input)

layout.addWidget(button)
window.setLayout(layout)
window.show()

app.exec()

在这个示例中，当用户点击按钮时，会弹出一个文本输入对话框，用户输入文本后会打印到控制台。

2. 获取整数输入

QInputDialog 还可以用来获取整数类型的输入，例如年龄、数量等。

示例代码：

def get_integer_input():
    # 显示整数输入对话框
    value, ok = QInputDialog.getInt(window, "Input Integer", "Please enter your age:", 0, 0, 120, 1)
    if ok:
        print(f"Entered age: {value}")

在这个示例中，getInt 会弹出一个输入框，用户可以输入一个整数。getInt 方法还允许设置输入的最小值、最大值和步长。

3. 获取浮动数字输入

如果需要输入一个浮动数字，可以使用 getDouble 方法。

示例代码：

def get_double_input():
    # 显示浮动数字输入对话框
    value, ok = QInputDialog.getDouble(window, "Input Double", "Please enter a value:", 0.0, -100.0, 100.0, 2)
    if ok:
        print(f"Entered value: {value}")

在这个示例中，用户可以输入一个浮动数字，范围为 -100 到 100，精度为 2 位小数。

4. 获取选项选择

QInputDialog 也支持选择项输入，例如选择城市、颜色等。

示例代码：

def get_item_input():
    items = ["Apple", "Banana", "Cherry"]
    item, ok = QInputDialog.getItem(window, "Select Item", "Select a fruit:", items, 0, False)
    if ok:
        print(f"Selected item: {item}")

在这个示例中，getItem 方法会显示一个下拉列表，用户可以从中选择一个项。

QFileDialog 常用函数分类介绍

1. 文本输入

• getText(parent, title, label, mode, text, echo)
  获取文本输入。
  • 参数：
    • parent：父窗口。
    • title：对话框的标题。
    • label：对话框中的标签文本。
    • mode：文本输入模式（如 QLineEdit.Normal、QLineEdit.Password 等）。
    • text：默认值。
    • echo：输入回显模式。
  • 返回值： 返回输入的文本和一个布尔值，表示用户是否确认输入。

2. 整数输入

• getInt(parent, title, label, value, min, max, step, options)
  获取整数输入。
  • 参数：
    • parent：父窗口。
    • title：对话框的标题。
    • label：对话框中的标签文本。
    • value：默认值。
    • min：输入的最小值。
    • max：输入的最大值。
    • step：步长。
    • options：可选的对话框选项。
  • 返回值： 返回输入的整数和一个布尔值，表示用户是否确认输入。

3. 浮动数字输入

• getDouble(parent, title, label, value, min, max, decimals, options)
  获取浮动数字输入。
  • 参数：
    • parent：父窗口。
    • title：对话框的标题。
    • label：对话框中的标签文本。
    • value：默认值。
    • min：输入的最小值。
    • max：输入的最大值。
    • decimals：精度。
    • options：可选的对话框选项。
  • 返回值： 返回输入的浮动数字和一个布尔值，表示用户是否确认输入。

4. 选项输入

• getItem(parent, title, label, items, current, editable, options)
  获取用户选择的选项。
  • 参数：
    • parent：父窗口。
    • title：对话框的标题。
    • label：对话框中的标签文本。
    • items：可选择的项的列表。
    • current：默认选择项的索引。
    • editable：是否允许编辑选项。
    • options：可选的对话框选项。
  • 返回值： 返回选中的项和一个布尔值，表示用户是否确认选择。

总结

QInputDialog 是 PySide6 中非常实用的控件，能够帮助开发者快速实现用户输入的功能。无论是获取文本、数字、浮动值还是选择项，QInputDialog 都提供了简洁而灵活的解决方案。通过 QInputDialog，你可以方便地收集用户输入的各种数据，并通过信号与槽机制获取输入结果。掌握 QInputDialog 的使用，可以大大提升你的应用程序的交互体验。