Qt控件

Layout

1. 垂直布局（Vertical Layout）

• 功能：垂直布局将控件按垂直方向排列，每个控件占据一行。当窗口大小改变时，控件会保持垂直排列，并根据需要调整大小。
• 应用场景：适用于需要将多个控件垂直堆叠的场景，如设置对话框中的选项按钮。

2. 水平布局（Horizontal Layout）

• 功能：水平布局将控件按水平方向排列，每个控件占据一列。当窗口大小改变时，控件会保持水平排列，并根据需要调整大小。
• 应用场景：适用于需要将多个控件水平排列的场景，如工具栏中的按钮。

3. 网格布局（Grid Layout）

• 功能：网格布局将控件放置在一个网格中，每个控件占据一个或多个单元格。当窗口大小改变时，所有单元格的大小会等比例调整，以保持控件之间的相对位置和大小关系。
• 应用场景：适用于需要复杂布局的场景，如表单输入界面，其中控件需要按照特定的行列关系排列。

4. 表单布局（Form Layout）

• 功能：表单布局类似于网格布局，但它通常用于创建表单界面。在表单布局中，标签（Label）和相应的输入控件（如LineEdit、SpinBox等）会成对出现，标签通常位于输入控件的左侧或上方。
• 应用场景：适用于需要创建数据输入表单的场景，如用户注册界面。

布局控件的共同特点和使用注意事项：

• 自动管理控件大小：布局控件会根据窗口大小自动调整内部控件的大小和位置，无需手动设置。
• 嵌套使用：布局控件可以嵌套使用，以创建更复杂的布局结构。例如，可以在水平布局中嵌套垂直布局，或在网格布局中嵌套其他布局控件。
• 边距和间距：在布局控件中，可以设置边距（Margin）和间距（Spacing）来调整控件与布局边界以及控件之间的空间距离。
• 伸缩性：某些布局控件（如网格布局和表单布局）支持伸缩性设置，允许用户指定在窗口大小改变时哪些控件应该优先调整大小。

使用布局控件的建议：

• 尽早使用布局：在设计GUI界面时，应尽早使用布局控件来规划控件的排列方式，以避免在后期调整界面布局时出现混乱。
• 合理利用嵌套布局：通过嵌套使用不同的布局控件，可以创建出既美观又实用的GUI界面。但需要注意的是，过度嵌套可能会导致布局变得复杂且难以维护。
• 注意控件的默认大小和策略：某些控件具有默认的大小和伸缩策略，这些设置可能会影响布局控件的效果。因此，在设计界面时需要注意控件的这些属性并根据需要进行调整。

Spacer

一、Spacer控件的类型

Qt Designer提供了两种主要类型的Spacer控件，虽然在实际使用中可能通过不同的方式实现（如QSpacerItem和QSpacerWidget），但在Qt Designer的界面中，用户主要关注的是它们的功能和效果：

1. 横向Spacer：

   • 功能：用于在水平方向上占据空间，调整控件之间的水平间距。
   • 应用场景：当需要在水平布局中增加控件之间的水平间距时，可以使用横向Spacer。

2. 纵向Spacer：

   • 功能：用于在垂直方向上占据空间，调整控件之间的垂直间距。
   • 应用场景：当需要在垂直布局中增加控件之间的垂直间距时，可以使用纵向Spacer。

需要注意的是，虽然Qt Designer的界面可能不直接区分“横向Spacer”和“纵向Spacer”作为独立的控件类型，但用户可以通过在水平布局中添加Spacer来实现横向间距的调整，在垂直布局中添加Spacer来实现纵向间距的调整。

二、Spacer控件的属性

Spacer控件在Qt Designer中可能不直接暴露所有底层属性（如QSpacerItem的sizeHint和stretch属性），但用户可以通过布局管理器间接控制Spacer的行为。然而，了解Spacer控件背后的一些常见属性对于深入理解其工作原理是有帮助的：

• sizeHint：Spacer控件建议的大小。这通常是一个最小值，布局管理器可能会根据需要进行调整。
• stretch：Spacer控件的伸缩因子。它决定了在布局调整大小时，Spacer控件相对于其他控件应该占据多少额外空间。stretch值较大的Spacer控件会占据更多的额外空间。

在Qt Designer中，用户可能无法直接设置这些属性，但可以通过调整布局和Spacer控件的位置和大小来间接影响它们。

三、Spacer控件的使用

在Qt Designer中使用Spacer控件非常直观：

1. 添加Spacer：

   • 打开Qt Designer并加载或创建一个UI文件。
   • 在工具箱中找到Spacer控件（有时可能需要先选择一个布局容器，因为Spacer控件不是独立的控件，而是布局的一部分）。
   • 将Spacer控件拖拽到布局中的适当位置。

2. 调整Spacer：

   • 选中Spacer控件后，您可能会看到它的边缘出现调整手柄（这取决于Qt Designer的版本和设置）。
   • 通过拖动调整手柄，您可以改变Spacer控件的大小。然而，请注意，对于Spacer控件来说，“大小”实际上是一个相对概念，它更多地影响的是布局中其他控件之间的间距。

3. 观察效果：

   • 在调整Spacer控件后，观察布局中其他控件的位置和间距是否如您所期望的那样发生了变化。

四、注意事项

• Spacer控件的实际效果取决于布局管理器和其他控件的属性。因此，在调整Spacer控件时，请务必考虑整个布局的情况。
• 避免过度使用Spacer控件。虽然Spacer控件是调整布局间距的有用工具，但过度使用可能会使布局变得复杂且难以维护。在可能的情况下，尝试使用布局管理器的默认间距和边距属性来简化布局设计。

Button

在Qt Designer中，Button控件是一组用于与用户交互的按钮类控件，它们提供了不同的功能和外观选项。以下是对所有常见Button控件的详细讲解：

1. Push Button（常规按钮）

• 功能：Push Button是最常见的按钮类型，用于响应用户的点击操作。点击后会触发clicked信号。
• 外观定制：可以通过设置按钮的文本、图标等属性来定制其外观。同时，支持通过样式表进一步定制按钮的样式。
• 使用场景：适用于大多数需要用户点击以执行操作的场景，如提交表单、打开新窗口等。

2. Tool Button（工具按钮）

• 功能：通常用于创建工具栏按钮，可以显示图标、文本或者同时显示两者。工具按钮还可以包含一个菜单项，当用户点击时弹出菜单。
• 外观定制：除了文本和图标外，还可以设置按钮的弹出模式（即时弹出、延迟弹出等）和样式。
• 使用场景：适用于工具栏中的快速访问按钮，如保存、打开、撤销等操作。

3. Radio Button（单选按钮）

• 功能：用于在一组选项中选择一个选项。当选择某个单选按钮时，其他单选按钮将被自动取消选择。
• 使用注意事项：单选按钮通常需要放在RadioGroup内以实现单选功能。
• 使用场景：适用于需要从一组互斥选项中选择一个的场景，如性别选择、语言选择等。

4. Check Box（复选框）

• 功能：用于可选的选项，可以选择多个。与单选按钮不同，复选框允许用户同时选择多个选项。
• 使用场景：适用于需要从多个可选项中选择一个或多个的场景，如同意隐私政策、订阅新闻等。
• 特有属性：复选框还可以设置为三态（未选中、选中、半选中），但这需要特别配置。

5. Command Link Button（命令链接按钮）

• 功能：这是一种类似于QPushButton的按钮类型，但具有更多的样式和功能。它可以显示文本、图标以及访问键信息，并支持拖拽操作。
• 外观定制：提供了更多的样式选项，如高亮、悬停等状态样式。
• 使用场景：常用于向导和对话框中，提供类似链接的按钮样式，以增加用户的交互体验。

6. Dialog Button Box（对话框按钮盒）

• 功能：这是一种特殊的按钮容器，用于放置对话框中的标准按钮，如“OK”、“Cancel”、“Yes”、“No”等。它提供了统一的外观和行为标准，方便用户理解和使用。
• 使用方式：可以自定义按钮布局和样式，也可以直接使用系统默认按钮。
• 使用场景：适用于所有需要标准对话框按钮布局的场景，如确认对话框、设置对话框等。

共性属性

除了上述特定于每种Button控件的属性外，它们还共享一些共性属性，这些属性通常通过QAbstractButton类提供：

• text：按钮上显示的文本。
• icon：按钮上显示的图标。
• iconSize：图标的大小。
• shortcut：与按钮关联的快捷键。
• checkable：按钮是否可以被选中（对于非单选/复选框按钮）。
• checked：按钮是否被选中的状态。
• autoRepeat、autoRepeatDelay、autoRepeatInterval：控制按钮按下事件是否重复、重复的频次等。
• autoExclusive：是否启用按钮的自动排他特性（对于非单选按钮）。

这些共性属性使得开发者能够灵活地定制Button控件的行为和外观，以满足不同应用程序的需求。同时，Qt Designer提供的拖放式设计方式大大简化了界面开发的过程，提高了开发效率。

item view

在Qt Designer中，Item View控件是基于模型/视图（Model/View）架构的一组控件，用于展示和操作数据。这些控件通过分离数据的存储（模型）和数据的展示（视图），提供了灵活且高效的数据展示方式。以下是几种常见的Item View控件的详细讲解：

1. List View（列表视图）

• 功能：用于展示列表形式的数据。可以定制列表项的显示方式，如文本、图标等，并支持单选或多选。
• 数据模型：List View本身不存储数据，而是通过一个数据模型（如QStringListModel、QStandardItemModel等）来获取数据。
• 特点：提供垂直滚动条，支持拖拽操作，可以设置选择模式、编辑触发器等。
• 使用场景：适用于需要展示一系列可选项的场景，如文件列表、搜索结果等。

2. Tree View（树形视图）

• 功能：用于展示树形结构的数据，如文件系统、组织结构图等。支持节点的展开和折叠，以及节点的拖拽操作。
• 数据模型：与List View类似，Tree View也通过数据模型来获取数据，常用的数据模型包括QAbstractItemModel、QStandardItemModel等。
• 特点：提供垂直滚动条，可以定制节点的显示方式，支持多列展示（通过QTreeView配合委托实现）。
• 使用场景：适用于需要展示层次结构数据的场景。

3. Table View（表格视图）

• 功能：用于展示二维表格数据，如电子表格、数据库表格等。支持行和列的插入、删除、移动，以及数据的排序和过滤。
• 数据模型：Table View同样需要一个数据模型来提供数据，常用的数据模型包括QAbstractTableModel、QStandardItemModel等。
• 特点：提供水平和垂直滚动条，可以调整列宽和行高，支持多选、排序、过滤等功能。
• 使用场景：适用于需要展示和编辑二维数据的场景。

4. Column View（列视图）

• 功能：Column View是一种特殊的列表视图，它以列为单位展示数据，每列可以看作是一个独立的列表视图。
• 特点：这种展示方式对于展示具有层次结构但层级不多的数据特别有用，因为它允许用户通过横向滚动来查看不同层级的数据。
• 使用场景：适用于需要展示有限层级的树形结构数据的场景。

5. Undo View（撤销命令视图）

• 功能：Undo View提供了一个用户界面来展示和操作QUndoStack中的命令。用户可以从列表中选择并撤销或重做特定的命令。
• 特点：通常显示为一个列表，与List View类似，但专门用于撤销/重做操作的管理。
• 使用场景：在需要支持撤销/重做功能的应用程序中非常有用，如文本编辑器、图形编辑器等。

共性特点

• 模型/视图分离：所有Item View控件都遵循模型/视图架构，使得数据的存储和展示可以独立进行，提高了数据管理的灵活性和效率。
• 丰富的接口和属性：这些控件提供了丰富的接口和属性，允许开发者定制外观、行为和数据交互方式。
• 易于集成：在Qt Designer中，开发者可以通过拖拽的方式将这些视图控件添加到界面中，并通过属性编辑器设置相关属性，使得界面开发更加直观和高效。

总的来说，Qt Designer中的Item View控件为开发者提供了强大的数据展示和操作功能，通过灵活使用这些控件，可以构建出丰富多样的用户界面。

Container

在Qt Designer中，Container控件（容器控件）主要用于对界面上的其他控件进行分组、布局和管理，以提高界面的组织性和美观性。以下是对几种常见Container控件的详细讲解：

1. Group Box（分组框）

• 功能：将一组相关的控件组织在一起，并在外部提供一个边框和标题栏，用于标识这组控件的用途或类别。
• 特点：分组框内部通常需要使用布局管理器（如QHBoxLayout、QVBoxLayout等）来安排控件的位置和大小。分组框本身也可以响应点击事件，但主要作用是作为控件的容器。
• 使用场景：适用于需要将一组控件作为一个整体进行展示和操作的场景，如设置选项、表单输入等。

2. Scroll Area（滚动区域）

• 功能：提供一个可滚动的视图区域，用于在有限的显示空间内展示大量内容或控件。
• 特点：当滚动区域的内容超出其可视范围时，会自动显示滚动条，允许用户通过滚动来查看完整内容。滚动区域可以包含任何类型的控件或布局。
• 使用场景：适用于需要展示大量数据或控件，但显示空间有限的场景，如长文本编辑器、图片查看器等。

3. Tab Widget（标签页部件）

• 功能：允许在同一个区域内通过标签页的形式切换不同的界面或内容。
• 特点：每个标签页都对应一个独立的界面或内容区域，用户可以通过点击标签页来切换显示的内容。标签页部件提供了丰富的接口来管理标签页，如添加、删除、重命名等。
• 使用场景：适用于需要将多个相关但独立的界面组织在一起，并通过标签页进行切换的场景，如浏览器的多个标签页、软件的多功能界面等。

4. Stacked Widget（堆叠控件）

• 功能：以堆叠的方式组织多个控件或界面，但一次只显示一个控件或界面。
• 特点：通过编程方式或与其他控件（如列表框）配合，可以实现控件或界面之间的切换。堆叠控件不提供直接的切换界面，需要通过代码或信号与槽机制来实现。
• 使用场景：适用于需要根据用户操作或条件动态切换显示不同控件或界面的场景，如向导式界面、设置选项卡等。

5. Tool Box（工具箱）

• 功能：提供一个多页面的工具箱，每个页面可以包含多个控件或布局。
• 特点：类似于标签页部件，但工具箱的页面通常通过按钮或标题栏来切换，且页面之间的切换更加紧凑和直观。工具箱也支持拖拽操作，允许用户重新排列页面顺序。
• 使用场景：适用于需要将多个相关页面组织在一起，并通过按钮或标题栏进行切换的场景，如软件的工具箱、设置选项分组等。

6. Frame（框架）

• 功能：作为其他控件的容器，用于对控件进行分组或装饰。
• 特点：框架本身不提供滚动条或标签页等功能，但可以通过设置边框样式、阴影等属性来美化界面。框架内部同样需要使用布局管理器来安排控件的位置和大小。
• 使用场景：适用于需要对一组控件进行简单分组或装饰的场景，如表单中的字段分组、界面中的装饰性边框等。

共性特点

• 容器作用：所有Container控件都作为其他控件的容器，用于组织和管理界面元素。
• 布局管理：内部通常需要使用布局管理器来安排控件的位置和大小，以确保界面的整洁和一致性。
• 灵活定制：大多数Container控件都提供了丰富的属性和接口，允许开发者根据需要进行定制和扩展。

通过合理使用这些Container控件，开发者可以构建出结构清晰、美观易用的用户界面。

Input Widget

在Qt Designer中，Input Widgets（输入控件）是一组用于接收用户输入的界面元素。这些控件允许用户通过键盘、鼠标或其他输入设备输入文本、数字、日期时间等信息。以下是对Qt中常见Input Widgets控件的详细讲解：

1. QLineEdit（单行文本编辑框）

• 功能：用于单行文本输入，如用户名、密码等。
• 常用方法：
  • setText(const QString &text)：设置文本框内容。
  • text() const：返回文本框内容。
  • clear()：清除文本框内容。
• 信号：
  • textChanged(const QString &text)：当文本框内容发生变化时发射。
  • editingFinished()：当编辑完成（如按下回车键）时发射。
• 使用场景：适用于需要单行文本输入的场景。

2. QTextEdit（多行文本编辑框）

• 功能：用于多行文本输入，支持富文本格式（HTML）。
• 常用方法：
  • toPlainText()：返回文本框内的纯文本内容。
  • setPlainText(const QString &text)：设置文本框内的纯文本内容。
  • toHtml()：返回文本框内的HTML内容。
  • setHtml(const QString &text)：设置文本框内的HTML内容。
• 信号：
  • textChanged()：当文本内容发生变化时发射。
  • cursorPositionChanged()：当光标位置发生变化时发射。
• 使用场景：适用于需要输入或显示多行文本的场景，如邮件正文、聊天窗口等。

3. QPlainTextEdit（纯文本多行编辑框）

• 功能：与QTextEdit类似，但专门用于纯文本编辑，不支持富文本格式。
• 常用方法：
  • toPlainText()：返回文本框内的纯文本内容。
  • appendPlainText(const QString &text)：在文本末尾追加纯文本内容。
  • insertPlainText(const QString &text)：在光标位置插入纯文本内容。
• 信号：
  • textChanged()：当文本内容发生变化时发射。
  • cursorPositionChanged()：当光标位置发生变化时发射。
• 使用场景：适用于需要编辑纯文本的场景，如代码编辑器、文本文件编辑器等。

4. QSpinBox（整数调节按钮）

• 功能：允许用户通过点击上下箭头或输入数字来选择一个整数值。
• 常用属性：
  • minimum：最小值。
  • maximum：最大值。
  • singleStep：每次点击箭头改变的值。
  • value：当前值。
• 常用方法：
  • setValue(int val)：设置当前值。
  • value()：获取当前值。
• 信号：
  • valueChanged(int i)：当值发生变化时发射。
• 使用场景：适用于需要用户输入整数值的场景，如年龄、数量等。

5. QDoubleSpinBox（浮点数调节按钮）

• 功能：与QSpinBox类似，但允许用户输入浮点数。
• 特有属性：
  • decimals：小数点后的位数。
• 其他属性与方法：与QSpinBox相似。
• 使用场景：适用于需要用户输入浮点数值的场景，如价格、百分比等。

6. QComboBox（下拉列表框）

• 功能：提供一个下拉列表供用户选择，节省屏幕空间。
• 常用方法：
  • addItem(const QString &text, const QVariant &userData = QVariant())：添加单个选项。
  • addItems(const QStringList &texts)：添加多个选项。
  • currentIndex()：获取当前选中项的索引。
  • currentText()：获取当前选中项的文本。
• 信号：
  • currentIndexChanged(int index)：当选中项发生变化时发射，参数为新的索引值。
  • currentIndexChanged(const QString &text)：当选中项发生变化时发射，参数为新的文本值。
• 使用场景：适用于需要从预定义选项中选择一个的场景，如性别、国家等。

7. QFontComboBox（字体组合框）

• 功能：允许用户从下拉列表中选择字体。
• 常用方法：
  • currentFont()：获取当前选中的字体。
  • setFontFilters(const QFontFilters &filters)：设置字体过滤器，以限制可选的字体。
• 信号：
  • currentFontChanged(const QFont &f)：当选中字体发生变化时发射。
• 使用场景：适用于需要用户选择字体的场景，如文本编辑器、图形设计工具等。

8. QDateTimeEdit、QDateEdit、QTimeEdit（日期时间、日期、时间编辑框）

• 功能：分别用于编辑日期时间、日期和时间。
• 常用方法：
  • setDate(const QDate &date)：设置日期。
  • setTime(const QTime &time)：设置时间。
  • setDateTime(const QDateTime &dateTime)：设置日期和时间。
  • date()、time()、dateTime()：分别获取当前日期、时间和日期时间。
• 信号：
  • dateChanged(const QDate &date)：当日期发生变化时发射。
  • timeChanged(const QTime &time)：当时间发生变化时发射。
  • dateTimeChanged(const QDateTime &dateTime)：当日期时间发生变化时发射。
• 使用场景：适用于需要用户输入日期、时间或日期时间的场景，如日历、任务管理器等。

这些Input Widgets控件为Qt应用程序提供了丰富的用户输入方式，开发者可以根据具体需求选择合适的控件来构建用户界面。

display widget

在Qt框架中，Display Widgets（显示控件）是用于展示和呈现数据给用户查看的界面元素。这些控件不直接接收用户输入，而是将程序内部的数据以图形化的方式展示出来。以下是对Qt中常见Display Widgets控件的详细讲解：

1. QLabel（标签）

• 功能：用于显示文本、图片或动画。QLabel是Qt中最基本也是最常用的显示控件之一。

• 常用方法

  ：

  • setText(const QString &text)：设置显示的文本内容。
  • setPixmap(const QPixmap &pixmap)：设置显示的图片。
  • setAlignment(Qt::Alignment flag)：设置文本或图片的对齐方式。

• 信号：QLabel本身不直接提供用于内容变化的信号，但可以通过与其他控件的交互来间接触发信号。

• 使用场景：适用于需要显示静态文本、图片或简单动画的场景，如标题栏、提示信息等。

2. QTextBrowser（文本浏览器）

• 功能：用于显示和编辑富文本内容，支持HTML格式。

• 常用方法

  ：

  • setText(const QString &text)：设置显示的文本内容。
  • setHtml(const QString &html)：设置显示的HTML内容。
  • anchorClicked(const QUrl &url)：当用户点击HTML中的链接时发射的信号。

• 使用场景：适用于需要显示复杂文本格式（如带有超链接、图片、格式化的文本等）的场景，如帮助文档、新闻阅读器等。

3. QGraphicsView（图形视图）

• 功能：用于显示和管理QGraphicsScene（场景）中的图形项（如线条、形状、图像等）。

• 特点：QGraphicsView和QGraphicsScene一起构成了Qt中强大的二维图形框架，支持复杂的图形交互和渲染。

• 常用方法

  ：

  • setScene(QGraphicsScene *scene)：设置要显示的场景。
  • scene()：获取当前显示的场景。

• 使用场景：适用于需要展示复杂图形界面、进行图形交互（如拖拽、缩放、旋转等）的场景，如绘图软件、游戏界面等。

4. QCalendarWidget（日历控件）

• 功能：提供一个日历视图，允许用户选择日期。

• 常用方法

  ：

  • setSelectedDate(const QDate &date)：设置选中的日期。
  • selectedDate()：获取当前选中的日期。

• 信号

  ：

  • selectionChanged()：当选中日期发生变化时发射。

• 使用场景：适用于需要用户选择日期的场景，如日程安排、事件提醒等。

5. QProgressBar（进度条）

• 功能：用于显示任务的进度。

• 常用方法

  ：

  • setValue(int value)：设置进度条的值。
  • value()：获取进度条当前的值。

• 信号

  ：

  • valueChanged(int value)：当进度条的值发生变化时发射。

• 使用场景：适用于需要展示任务进度的场景，如下载进度、加载进度等。

6. QLCDNumber（液晶数字显示）

• 功能：模仿液晶显示屏的数字显示方式，用于显示数字。

• 常用方法

  ：

  • display(const QString &text)：设置显示的文本（数字）。
  • setNum(int num)：直接设置要显示的整数。

• 使用场景：适用于需要以特殊方式（如液晶显示风格）展示数字的场景，如计时器、温度计等模拟界面。

7. 其他Display Widgets

Qt还提供了其他一些Display Widgets控件，如QHorizontalLine（水平线）、QVerticalLine（垂直线）、QOpenGLWidget（OpenGL图形渲染控件）、QQuickWidget（QML嵌入控件）等。这些控件各有特色，适用于不同的显示需求。例如，水平线和垂直线用于分隔界面元素；QOpenGLWidget用于集成OpenGL渲染管线到Qt应用程序中；QQuickWidget允许将基于QML的用户界面组件集成到传统的Qt Widgets应用中。

综上所述，Qt中的Display Widgets控件为开发者提供了丰富的界面展示手段，可以根据具体需求选择合适的控件来构建用户友好的界面。