7天上手PyQt6 Python 桌面应用开发之PyQt6 常用基本控件

1. setText ()：设置标签要显示的文本内容，传入普通字符串即可，是 QLabel 最基础的用法。

2. text ()：获取标签当前显示的文本内容，返回值为字符串类型，常用于读取用户 / 程序设置的标签文本。

3. setPixmap ()：设置标签显示图片，需结合QPixmap类使用（如label.setPixmap(QPixmap("图片路径.png"))），用于在标签位置展示图片资源。

4. setAlignment ()：设置标签内文本 / 图片的对齐方式，常用值有Qt.AlignCenter（居中）、Qt.AlignLeft（左对齐）、Qt.AlignRight（右对齐）等。

5. setWordWrap ()：设置文本是否自动换行，参数为True（自动换行）或False（不换行），适合展示长文本时避免内容超出标签范围。

6. setOpenExternalLinks ()：设置是否允许点击标签内的超链接跳转到外部浏览器，参数为True（允许）/False（禁止），需先通过setText()设置带超链接的文本（如[链接](https://xxx.com)）。

7. setStyleSheet ()：通过 CSS 样式表设置标签样式，比如背景色（background-color: yellow）、字体大小（font-size: 16px）、边框（border: 1px solid black）等。

8. setToolTip ()：设置鼠标悬停在标签上时显示的提示文本，提升界面交互性（如label.setToolTip("这是一个提示")）。

9. clear ()：清空标签的所有内容（包括文本、图片），将标签恢复为空白状态。

10. setBuddy ()：将标签与其他控件（如 QLineEdit 单行输入框）绑定，按下标签的快捷键可快速聚焦到绑定的控件，提升操作效率。

11. setTextInteractionFlags ()：设置文本交互权限，常用值有Qt.TextSelectableByMouse（允许鼠标选中文本）、Qt.TextEditable（允许编辑文本）等。

12. setScaledContents ()：设置图片是否随标签尺寸自动缩放，参数为True（缩放）/False（不缩放），避免图片超出标签显示区域。

1. QLabel 核心用法：setText()/text()处理文本，setPixmap()展示图片，是最基础且高频的操作；

2. 样式与交互：setStyleSheet()美化标签、setOpenExternalLinks()处理超链接，能满足大部分界面交互需求；

1. setText ()：设置单行文本框的显示 / 输入内容，传入字符串即可，是最基础的文本设置方法。

2. text ()：获取文本框当前输入 / 显示的文本内容，返回字符串类型，用于读取用户输入。

3. clear ()：清空文本框内所有内容，快速恢复空白状态，常用于重置输入框。

4. setPlaceholderText ()：设置占位提示文本（无输入时显示的灰色提示），提示用户输入用途（如 “请输入手机号”）。

5. setEchoMode ()：设置文本显示模式，常用值有 QLineEdit.Normal（正常显示）、QLineEdit.Password（密码隐藏为圆点），适配密码输入等场景。

6. setReadOnly ()：设置文本框是否只读，True 为只读（无法修改）、False 为可编辑，用于展示无需修改的文本。

7. setMaxLength ()：设置允许输入的最大字符数，限制输入长度（如手机号限制 11 位）。

8. setStyleSheet ()：通过 CSS 样式表美化文本框，如设置边框、背景色、字体大小等。

9. setAlignment ()：设置文本框内文本的对齐方式，如 Qt.AlignCenter（居中）、Qt.AlignLeft（左对齐）。

10. setEnabled ()：设置文本框是否可用，True 为可用、False 为禁用（灰显，无法输入），控制交互状态。

11. setValidator ()：设置输入验证器，限制输入格式（如仅允许输入数字、邮箱格式），需结合 QIntValidator 等使用。

12. selectAll ()：选中文本框内所有内容，方便用户快速修改 / 复制输入内容。

1. setPlainText ()：设置文本框的纯文本内容，覆盖原有内容，仅处理无格式的纯文本数据。

2. toPlainText ()：获取文本框中的纯文本内容（忽略富文本格式），返回字符串类型，用于读取无格式的文本内容。

3. setHtml ()：设置文本框的富文本内容，支持 HTML 格式（如字体颜色、大小、超链接、列表等），覆盖原有内容。

4. toHtml ()：获取文本框中的富文本内容，以 HTML 格式返回，保留所有格式信息。

5. append ()：在文本框末尾追加文本（支持纯文本或富文本），自动换行，适合日志输出、内容追加等场景。

6. insertPlainText ()：在光标当前位置插入纯文本内容，不覆盖原有内容，精准控制无格式文本的插入位置。

7. insertHtml ()：在光标当前位置插入 HTML 格式的富文本内容，支持格式化文本的精准插入。

8. clear ()：清空文本框内所有内容（包括纯文本、富文本），快速恢复空白状态。

9. setReadOnly ()：设置文本框是否为只读状态，True 为只读（无法编辑）、False 为可编辑，控制文本修改权限。

10. setStyleSheet ()：通过 CSS 样式表美化控件，如设置背景色、字体大小、边框样式、文本颜色等。

11. setEnabled ()：设置文本框是否可用，True 为正常交互、False 为禁用（灰显，无法操作），控制控件的交互状态。

12. setWordWrapMode ()：设置文本换行模式，控制长文本的换行规则，适配不同宽度的展示场景。

13. undo ()：撤销上一步的编辑操作，恢复到修改前的文本状态，提升编辑体验。

14. redo ()：重做之前撤销的操作，恢复被撤销的文本修改，与 undo () 配合使用。

15. selectAll ()：选中文本框内所有内容，方便用户快速复制、删除或修改全部文本。

16. find ()：在文本框中检索指定字符串，返回布尔值表示是否找到，支持富文本内容的检索。

17. setAcceptRichText ()：设置是否接受富文本输入，True 允许（默认）、False 仅接受纯文本，限制输入内容的格式类型。

18. copy ()/cut ()/paste ()：分别实现文本的复制、剪切、粘贴操作，模拟手动编辑的快捷键功能。

1. setPlainText ()：设置文本框的纯文本内容，覆盖原有内容，是设置文本最基础的方法。

2. toPlainText ()：获取文本框中所有的纯文本内容，返回字符串类型，用于读取用户输入或展示的文本。

3. appendPlainText ()：在文本框末尾追加纯文本内容，自动换行，适合日志输出、内容追加等场景。

4. insertPlainText ()：在光标当前位置插入纯文本内容，不覆盖原有内容，精准控制文本插入位置。

5. clear ()：清空文本框内所有内容，快速恢复空白状态，常用于重置文本编辑区域。

6. setReadOnly ()：设置文本框是否为只读状态，True 为只读（无法编辑）、False 为可编辑，控制文本修改权限。

7. setPlaceholderText ()：设置占位提示文本，无内容时显示灰色提示语（如 “请输入日志内容”），提示用户输入用途。

8. setStyleSheet ()：通过 CSS 样式表美化控件，如设置背景色、字体大小、边框样式、文本颜色等。

9. setEnabled ()：设置文本框是否可用，True 为可用（正常交互）、False 为禁用（灰显，无法操作），控制控件交互状态。

10. setLineWrapMode ()：设置文本换行模式，常用值有 QPlainTextEdit.NoWrap（不换行）、QPlainTextEdit.WidgetWidth（按控件宽度换行），适配不同文本展示需求。

11. undo ()：撤销上一步的编辑操作，恢复到之前的文本状态，提升编辑体验。

12. redo ()：重做之前撤销的操作，恢复被撤销的文本修改，与 undo () 配合使用。

13. selectAll ()：选中文本框内所有内容，方便用户快速复制、删除或修改全部文本。

14. find ()：在文本框中查找指定的字符串，返回布尔值表示是否找到，支持文本检索功能。

15. setMaximumBlockCount ()：设置文本框最大显示的文本块数量，超出则自动删除最早的内容，适合日志展示等需限制内容量的场景。

1. setValue ()：设置 SpinBox 的当前整数值，直接覆盖原有数值，是设置数值最基础的方法。

2. value ()：获取 SpinBox 当前选中的整数值，返回 int 类型，用于读取用户选择的数字。

3. setRange ()：设置数值的可选范围，传入最小值和最大值（如setRange(0, 100)），限制用户可选择的数值区间。

4. setSingleStep ()：设置每次点击增减按钮时数值的步长，默认步长为 1，可自定义（如步长 5、10）。

5. setPrefix ()：设置数值前缀文本，如 “￥”“第”，显示为 “￥10”“第 5 项”，增强数值的语义（如金额、序号）。

6. setSuffix ()：设置数值后缀文本，如 “个”“%”“℃”，显示为 “10 个”“80%”，补充数值的单位说明。

7. clear ()：清空 SpinBox 的数值（重置为最小值），快速恢复到数值范围的初始最小值状态。

8. setReadOnly ()：设置 SpinBox 是否为只读状态，True 为只读（无法手动修改数值）、False 为可编辑，控制数值修改权限。

9. setStyleSheet ()：通过 CSS 样式表美化控件，如设置背景色、字体大小、边框样式、增减按钮样式等。

10. setEnabled ()：设置 SpinBox 是否可用，True 为正常交互、False 为禁用（灰显，无法操作），控制控件的交互状态。

11. setWrapping ()：设置数值是否循环，True 为循环（最大值 + 1 跳转到最小值，反之亦然）、False 为不循环，适配循环选择数值的场景。

12. minimum ()：获取设置的数值最小值，返回 int 类型，用于校验或展示数值范围的下限。

13. maximum ()：获取设置的数值最大值，返回 int 类型，用于校验或展示数值范围的上限。

14. stepUp ()：手动触发数值增加一步（等同于点击增加按钮），程序化控制数值递增。

15. stepDown ()：手动触发数值减少一步（等同于点击减少按钮），程序化控制数值递减。

16. setSpecialValueText ()：设置最小值对应的特殊文本，如最小值 0 时显示 “无”“默认值”，替代数字展示，适配特殊语义场景。

1. setValue ()：设置 DoubleSpinBox 的当前浮点数值，直接覆盖原有数值，是设置小数数值最基础的方法。

2. value ()：获取 DoubleSpinBox 当前选中的浮点数值，返回 float 类型，用于读取用户选择的小数。

3. setRange ()：设置浮点数值的可选范围，传入最小值和最大值（如setRange(0.0, 100.0)），限制用户可选择的数值区间。

4. setDecimals ()：设置显示的小数位数，默认是 2 位，可自定义（如 1 位、3 位），控制数值的精度展示。

5. setSingleStep ()：设置每次点击增减按钮时数值的步长，默认步长为 1.0，可自定义（如 0.5、2.0），适配不同精度的数值调整。

6. setPrefix ()：设置数值前缀文本，如 “￥”“长度：”，显示为 “￥10.5”“长度：5.2cm”，增强数值的语义（如金额、长度）。

7. setSuffix ()：设置数值后缀文本，如 “kg”“m/s”“℃”，显示为 “8.5kg”“10.0m/s”，补充数值的单位说明。

8. clear ()：清空 DoubleSpinBox 的数值（重置为最小值），快速恢复到数值范围的初始最小值状态。

9. setReadOnly ()：设置 DoubleSpinBox 是否为只读状态，True 为只读（无法手动修改数值）、False 为可编辑，控制数值修改权限。

10. setStyleSheet ()：通过 CSS 样式表美化控件，如设置背景色、字体大小、边框样式、增减按钮样式等。

11. setEnabled ()：设置 DoubleSpinBox 是否可用，True 为正常交互、False 为禁用（灰显，无法操作），控制控件的交互状态。

12. setWrapping ()：设置数值是否循环，True 为循环（最大值 + 步长跳转到最小值，反之亦然）、False 为不循环，适配循环选择小数的场景。

13. minimum ()：获取设置的数值最小值，返回 float 类型，用于校验或展示数值范围的下限。

14. maximum ()：获取设置的数值最大值，返回 float 类型，用于校验或展示数值范围的上限。

15. stepUp ()：手动触发数值增加一步（等同于点击增加按钮），程序化控制数值递增。

16. stepDown ()：手动触发数值减少一步（等同于点击减少按钮），程序化控制数值递减。

17. setSpecialValueText ()：设置最小值对应的特殊文本，如最小值 0.0 时显示 “无”“默认值”，替代小数展示，适配特殊语义场景。

1. display ()：设置并显示数值（支持 int、float、str 类型），覆盖原有显示内容，是液晶数字展示最核心的方法。

2. value ()：获取当前显示的数值（仅对数字格式内容有效），返回 float 类型，用于读取展示的数字。

3. setDigitCount ()：设置显示的数字位数（如 4 位、6 位），限制可展示的数字长度，位数不足时自动补零。

4. setSegmentStyle ()：设置液晶段码的显示样式，可选值有 QLCDNumber.Flat（扁平）、QLCDNumber.Filled（填充，默认）、QLCDNumber.Outline（轮廓），调整视觉呈现效果。

5. setSmallDecimalPoint ()：设置小数点的显示样式，True 为小尺寸小数点（占半位）、False 为标准尺寸（占一位），优化小数展示的布局。

6. checkOverflow ()：检查指定数值是否超出设置的数字位数，返回布尔值，用于校验数值能否完整显示。

7. clear ()：清空液晶显示的所有内容，快速恢复为空白状态，重置显示效果。

8. setStyleSheet ()：通过 CSS 样式表美化控件，如设置背景色、数字颜色、边框样式、控件大小等。

9. setEnabled ()：设置控件是否可用，True 为正常显示交互、False 为禁用（灰显，无交互），控制控件的使用状态。

10. setMode ()：设置数字显示进制模式，可选值有 QLCDNumber.Dec（十进制）、QLCDNumber.Hex（十六进制）、QLCDNumber.Oct（八进制）、QLCDNumber.Bin（二进制），切换数字展示进制。

11. setBinMode ()：快速切换为二进制显示模式，等同于setMode(QLCDNumber.Bin)，简化进制切换操作。

12. setDecMode ()：快速切换为十进制显示模式（默认），等同于setMode(QLCDNumber.Dec)。

13. setHexMode ()：快速切换为十六进制显示模式，等同于setMode(QLCDNumber.Hex)。

14. setOctMode ()：快速切换为八进制显示模式，等同于setMode(QLCDNumber.Oct)。

15. setRange ()：设置可显示的数值范围，超出范围会触发溢出提示，限制展示的数值区间。

16. minimum ()：获取通过 setRange 设置的数值最小值，返回 float 类型，用于数值范围校验。

17. maximum ()：获取通过 setRange 设置的数值最大值，返回 float 类型，用于数值范围校验。

1. setText ()：设置按钮显示的文本内容，覆盖原有文本，是按钮最基础的文本设置方法。

2. text ()：获取按钮当前显示的文本内容，返回字符串类型，用于读取按钮文本信息。

3. setIcon ()：设置按钮上显示的图标，需结合 QIcon 类使用（如setIcon(QIcon("icon.png"))），丰富按钮的视觉呈现效果。

4. setIconSize ()：设置按钮上图标的尺寸，传入 QSize 对象（如QSize(24, 24)），精准控制图标显示大小。

5. setEnabled ()：设置按钮是否可用，True 为正常交互（可点击）、False 为禁用（灰显，无法点击），核心的交互状态控制方法。

6. setStyleSheet ()：通过 CSS 样式表美化按钮，支持设置背景色、字体大小、边框样式、悬停 / 点击态样式等，自定义按钮视觉效果。

7. setToolTip ()：设置鼠标悬停在按钮上时显示的提示文本（如 “点击提交数据”），提升界面交互的友好性。

8. setCheckable ()：设置按钮是否为可勾选状态，True 为可勾选（点击后保持选中 / 未选中状态）、False 为普通按钮，适配开关类使用场景。

9. isChecked ()：判断按钮是否处于勾选状态，返回布尔值，用于获取勾选型按钮的状态。

10. setChecked ()：设置按钮的勾选状态，True 为选中、False 为未选中，程序化控制勾选状态。

11. setFlat ()：设置按钮是否为扁平样式，True 为扁平（无默认边框和背景）、False 为默认样式，适配简约风格的界面设计。

12. click ()：手动触发按钮的点击事件，等同于用户点击按钮，可程序化触发按钮绑定的槽函数。

13. setDefault ()：设置按钮为默认按钮，按下 Enter 键时自动触发该按钮的点击事件，提升操作便捷性。

14. setAutoDefault ()：设置按钮是否为自动默认按钮，按钮获得焦点时自动成为默认按钮，适配多按钮交互场景。

15. setFixedSize ()：设置按钮的固定尺寸，传入宽和高（如setFixedSize(120, 40)），固定按钮大小不随布局变化。

16. setMinimumSize ()：设置按钮的最小尺寸，防止按钮被布局过度压缩，保障基础显示效果。

17. setMaximumSize ()：设置按钮的最大尺寸，限制按钮的最大显示大小，适配布局约束要求。

18. setVisible ()：设置按钮是否可见，True 为显示、False 为隐藏，控制按钮在界面中的显示状态。

1. setText ()：设置工具按钮显示的文本内容，覆盖原有文本，基础的文本配置方法（默认工具按钮优先显示图标，需配合样式 / 模式显示文本）。

2. text ()：获取工具按钮当前显示的文本内容，返回字符串类型，用于读取按钮文本信息。

3. setIcon ()：设置工具按钮的核心图标，需结合 QIcon 类使用（如setIcon(QIcon("tool_icon.png"))），是工具按钮最核心的视觉配置方法。

4. setIconSize ()：设置按钮图标的尺寸，传入 QSize 对象（如QSize(32, 32)），精准控制图标显示大小，适配不同界面尺寸需求。

5. setToolButtonStyle ()：设置按钮文本与图标的显示样式，常用值有 Qt.ToolButtonIconOnly（仅显示图标）、Qt.ToolButtonTextOnly（仅显示文本）、Qt.ToolButtonTextBesideIcon（文本在图标旁）、Qt.ToolButtonTextUnderIcon（文本在图标下），灵活调整展示形式。

6. setPopupMode ()：设置下拉菜单的弹出模式，常用值有 QToolButton.InstantPopup（点击按钮直接弹出菜单）、QToolButton.MenuButtonPopup（点击右侧小箭头弹出菜单），适配带下拉菜单的工具按钮场景。

7. setMenu ()：为工具按钮绑定 QMenu 下拉菜单，实现 “按钮 + 菜单” 的组合交互，拓展按钮功能。

8. setEnabled ()：设置按钮是否可用，True 为正常交互（可点击 / 弹出菜单）、False 为禁用（灰显，无交互），核心的交互状态控制方法。

9. setStyleSheet ()：通过 CSS 样式表美化按钮，支持设置背景色、边框、图标大小、悬停 / 点击态样式等，自定义工具按钮视觉效果。

10. setToolTip ()：设置鼠标悬停时的提示文本（如 “保存文件”），提升交互友好性，适配工具按钮图标化的使用场景。

11. setCheckable ()：设置按钮是否可勾选，True 为点击后保持选中状态，False 为普通点击态，适配开关类工具按钮需求。

12. isChecked ()：判断按钮是否处于勾选状态，返回布尔值，用于获取勾选型工具按钮的状态。

13. setChecked ()：设置按钮的勾选状态，True 为选中、False 为未选中，程序化控制勾选状态。

14. setAutoRaise ()：设置按钮是否自动凸起，True 为无操作时隐藏边框，鼠标悬停 / 点击时显示，适配简约的工具栏风格。

15. click ()：手动触发按钮的点击事件，等同于用户点击按钮，可程序化触发绑定的槽函数或弹出下拉菜单。

16. setFixedSize ()：设置工具按钮的固定尺寸，传入宽和高（如setFixedSize(40, 40)），固定按钮大小不随布局变化。

17. setVisible ()：设置按钮是否可见，True 为显示、False 为隐藏，控制工具按钮在工具栏 / 界面中的显示状态。

18. menu ()：获取按钮绑定的 QMenu 对象，返回 QMenu 实例，用于动态修改下拉菜单的内容或样式。

1. setText ()：设置命令链接按钮的主文本内容，覆盖原有主文本，是按钮核心文本的基础设置方法。

2. text ()：获取按钮当前显示的主文本内容，返回字符串类型，用于读取核心文本信息。

3. setDescription ()：设置按钮的辅助描述文本，显示在主文本下方，用于补充说明按钮功能（如 “点击后将跳转到设置页面”）。

4. description ()：获取按钮的辅助描述文本，返回字符串类型，读取补充说明信息。

5. setIcon ()：设置按钮左侧显示的图标，需结合 QIcon 类使用（如setIcon(QIcon("link_icon.png"))），增强视觉指引效果。

6. setIconSize ()：设置按钮图标的尺寸，传入 QSize 对象（如QSize(24, 24)），精准控制图标显示大小。

7. setEnabled ()：设置按钮是否可用，True 为正常交互（可点击）、False 为禁用（灰显，无法点击），核心的交互状态控制方法。

8. setStyleSheet ()：通过 CSS 样式表美化按钮，支持设置主文本 / 描述文本的字体、颜色，按钮背景色、边框样式等，自定义视觉效果。

9. setToolTip ()：设置鼠标悬停在按钮上时显示的提示文本，提升交互友好性，补充按钮功能说明。

10. setCheckable ()：设置按钮是否为可勾选状态，True 为点击后保持选中 / 未选中状态、False 为普通按钮，适配开关型命令链接场景。

11. isChecked ()：判断按钮是否处于勾选状态，返回布尔值，用于获取勾选型按钮的状态。

12. setChecked ()：设置按钮的勾选状态，True 为选中、False 为未选中，程序化控制勾选状态。

13. click ()：手动触发按钮的点击事件，等同于用户点击按钮，可程序化触发按钮绑定的槽函数。

14. setFlat ()：设置按钮是否为扁平样式，True 为扁平（无默认边框和背景）、False 为默认样式，适配简约风格的界面设计。

15. setDefault ()：设置按钮为默认按钮，按下 Enter 键时自动触发该按钮的点击事件，提升操作便捷性。

16. setFixedSize ()：设置按钮的固定尺寸，传入宽和高（如setFixedSize(200, 80)），固定按钮大小不随布局变化。

17. setMinimumSize ()：设置按钮的最小尺寸，防止按钮被布局过度压缩，保障主文本和描述文本完整显示。

18. setVisible ()：设置按钮是否可见，True 为显示、False 为隐藏，控制按钮在界面中的显示状态。

19. setAutoDefault ()：设置按钮是否为自动默认按钮，按钮获得焦点时自动成为默认按钮，适配多按钮交互场景。

1. setText ()：设置单选按钮显示的文本内容，覆盖原有文本，是单选按钮最基础的文本配置方法。

2. text ()：获取单选按钮当前显示的文本内容，返回字符串类型，用于读取按钮文本信息。

3. setChecked ()：设置单选按钮的选中状态，True 为选中、False 为未选中，程序化控制单选状态（同一组内仅一个可选中）。

4. isChecked ()：判断单选按钮是否处于选中状态，返回布尔值，是获取单选按钮状态最核心的方法。

5. setEnabled ()：设置单选按钮是否可用，True 为正常交互（可点击选中）、False 为禁用（灰显，无法操作），控制交互状态。

6. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置文本颜色、选中 / 未选中态样式、边框、背景色等，自定义视觉效果。

7. setToolTip ()：设置鼠标悬停时的提示文本（如 “选择该选项将启用 XX 功能”），提升交互友好性。

8. setIcon ()：设置单选按钮旁显示的图标，需结合 QIcon 类使用（如setIcon(QIcon("radio_icon.png"))），增强视觉辨识度。

9. setIconSize ()：设置图标的显示尺寸，传入 QSize 对象（如QSize(16, 16)），精准控制图标大小。

10. setAutoExclusive ()：设置是否启用自动互斥，True 为开启（同一父控件下仅一个可选中，默认开启）、False 为关闭，控制单选组规则。

11. click ()：手动触发单选按钮的点击事件，等同于用户点击，可程序化选中该按钮并取消同组其他按钮。

12. setVisible ()：设置单选按钮是否可见，True 为显示、False 为隐藏，控制控件在界面中的展示状态。

13. setMinimumSize ()：设置按钮的最小尺寸，防止文本过长时被压缩，保障文本完整显示。

14. setMaximumSize ()：设置按钮的最大尺寸，限制控件占用过多界面空间。

15. setFlat ()：设置按钮是否为扁平样式，True 为扁平（无默认背景边框）、False 为默认样式，适配简约界面设计。

16. setFocusPolicy ()：设置焦点获取策略，如 Qt.NoFocus（无焦点）、Qt.ClickFocus（点击获取焦点），控制按钮的焦点交互规则。

1. setText ()：设置复选框显示的文本内容，覆盖原有文本，是复选框最基础的文本配置方法。

2. text ()：获取复选框当前显示的文本内容，返回字符串类型，用于读取复选框文本信息。

3. setChecked ()：设置复选框的选中状态，True 为选中、False 为未选中，程序化控制勾选状态。

4. isChecked ()：判断复选框是否处于选中状态，返回布尔值，是获取复选框核心状态的方法。

5. setCheckState ()：设置复选框的勾选状态（支持三态），可选值有 Qt.Unchecked（未选中）、Qt.Checked（选中）、Qt.PartiallyChecked（半选中），适配多级勾选场景。

6. checkState ()：获取复选框的勾选状态（三态），返回对应的状态枚举值，用于读取半选中 / 全选中 / 未选中状态。

7. setTristate ()：设置复选框是否支持三态模式，True 为开启（支持半选中）、False 为普通二态（默认），拓展勾选状态维度。

8. setEnabled ()：设置复选框是否可用，True 为正常交互（可点击勾选）、False 为禁用（灰显，无法操作），控制交互状态。

9. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置文本颜色、选中 / 未选中 / 半选中态样式、边框、背景色等，自定义视觉效果。

10. setToolTip ()：设置鼠标悬停时的提示文本（如 “勾选后启用自动保存功能”），提升交互友好性。

11. setIcon ()：设置复选框旁显示的图标，需结合 QIcon 类使用（如setIcon(QIcon("check_icon.png"))），增强视觉辨识度。

12. setIconSize ()：设置图标的显示尺寸，传入 QSize 对象（如QSize(16, 16)），精准控制图标大小。

13. click ()：手动触发复选框的点击事件，等同于用户点击，可程序化切换勾选状态。

14. setVisible ()：设置复选框是否可见，True 为显示、False 为隐藏，控制控件在界面中的展示状态。

15. setMinimumSize ()：设置复选框的最小尺寸，防止文本过长时被压缩，保障文本完整显示。

16. setFlat ()：设置复选框是否为扁平样式，True 为扁平（无默认背景边框）、False 为默认样式，适配简约界面设计。

17. setFocusPolicy ()：设置焦点获取策略，如 Qt.NoFocus（无焦点）、Qt.ClickFocus（点击获取焦点），控制复选框的焦点交互规则。

1. addButton ()：向按钮盒中添加按钮，支持两种方式 —— 传入预设按钮类型（如 QDialogButtonBox.Ok）或自定义 QPushButton 对象，是构建按钮盒的核心方法。

2. button ()：根据预设按钮类型（如 QDialogButtonBox.Cancel）获取对应的按钮对象，返回 QAbstractButton 实例，用于单独配置某一按钮的样式 / 状态。

3. buttons ()：获取按钮盒中所有按钮的列表，返回 List [QAbstractButton] 类型，用于批量操作按钮（如批量禁用、修改样式）。

4. setStandardButtons ()：一次性设置按钮盒的预设标准按钮组合（如 QDialogButtonBox.Ok | QDialogButtonBox.Cancel），快速构建常用按钮组（确定 / 取消、保存 / 取消等）。

5. standardButtons ()：获取当前按钮盒中设置的预设标准按钮组合，返回对应的枚举值，用于校验已配置的按钮类型。

6. removeButton ()：从按钮盒中移除指定的按钮对象，支持动态删减按钮，适配不同业务场景的按钮需求。

7. clicked ()：按钮盒的点击信号，可绑定槽函数并通过参数区分点击的按钮类型，是处理按钮交互的核心信号关联方式。

8. accepted ()：绑定 “确认类” 按钮（Ok/Yes/Apply 等）的点击信号，触发时执行确认逻辑，简化确认操作的信号绑定。

9. rejected ()：绑定 “取消类” 按钮（Cancel/No 等）的点击信号，触发时执行取消逻辑，简化取消操作的信号绑定。

10. setCenterButtons ()：设置按钮是否居中显示，True 为居中、False 为默认对齐（通常右对齐），调整按钮盒的布局对齐方式。

11. setOrientation ()：设置按钮盒的排列方向，可选 Qt.Horizontal（水平排列，默认）、Qt.Vertical（垂直排列），适配不同界面布局。

12. setButtonRole ()：为自定义按钮设置角色（如 QDialogButtonBox.AcceptRole、QDialogButtonBox.RejectRole），让自定义按钮也能触发 accepted ()/rejected () 信号。

13. buttonRole ()：获取指定按钮的角色类型，返回对应的枚举值，用于判断按钮的功能分类。

14. setStyleSheet ()：通过 CSS 样式表美化按钮盒及内部按钮，支持统一设置按钮的背景色、字体、边框等样式，批量美化按钮。

15. setEnabled ()：设置按钮盒整体是否可用，True 为所有按钮正常交互、False 为所有按钮禁用（灰显），批量控制按钮交互状态。

16. clear ()：清空按钮盒中所有按钮，快速重置按钮盒的按钮配置，适配动态切换按钮组的场景。

17. setVisible ()：设置按钮盒是否可见，True 为显示、False 为隐藏，控制按钮盒在对话框中的展示状态。

1. addItem ()：向下拉框中添加单个选项，可仅传文本（如addItem("选项1")），也可传文本 + 关联数据（如addItem("选项1", 100)），是添加选项最基础的方法。

2. addItems ()：一次性添加多个选项，传入字符串列表（如addItems(["选项1", "选项2", "选项3"])），批量添加效率更高。

3. insertItem ()：在指定索引位置插入单个选项，参数为(索引, 文本, 关联数据)（可选），精准控制选项插入位置。

4. setCurrentIndex ()：设置下拉框当前选中的选项索引，传入整数（如setCurrentIndex(0)选中第一个选项），程序化控制选中状态。

5. currentIndex ()：获取当前选中选项的索引，返回 int 类型，是读取选中位置最核心的方法。

6. setCurrentText ()：设置下拉框当前选中的选项文本，传入字符串（如setCurrentText("选项2")），按文本匹配选中。

7. currentText ()：获取当前选中选项的文本内容，返回字符串类型，用于读取用户选择的选项文本。

8. itemText ()：根据索引获取对应位置的选项文本，传入索引值（如itemText(1)），读取指定位置的选项内容。

9. itemData ()：根据索引获取选项关联的自定义数据，传入索引值，读取 addItem/insertItem 时绑定的额外数据。

10. clear ()：清空下拉框中所有选项，快速恢复空白状态，常用于重置下拉框选项。

11. removeItem ()：删除指定索引位置的选项，传入索引值（如removeItem(2)），动态删减不需要的选项。

12. count ()：获取下拉框中选项的总数，返回 int 类型，用于校验选项数量或遍历选项。

13. setEditable ()：设置下拉框是否可编辑，True 为可输入自定义文本、False 为仅可选择预设选项（默认），拓展输入方式。

14. setEnabled ()：设置下拉框是否可用，True 为正常交互（可展开 / 选择）、False 为禁用（灰显，无法操作），控制交互状态。

15. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置下拉框边框、背景色、下拉列表样式、选中项样式等，自定义视觉效果。

16. setPlaceholderText ()：设置占位提示文本（仅可编辑模式下生效），无选中 / 输入时显示灰色提示（如 “请选择选项”）。

17. setMaxCount ()：设置下拉框允许的最大选项数量，传入整数，限制选项总数，避免下拉列表过长。

18. setIconSize ()：设置选项图标的显示尺寸（若添加了图标），传入 QSize 对象（如QSize(20, 20)），控制图标大小。

19. addItem (QIcon, text)：添加带图标的选项，传入 QIcon 对象 + 文本，让选项带视觉标识（如addItem(QIcon("icon.png"), "选项1")）。

20. setVisible ()：设置下拉框是否可见，True 为显示、False 为隐藏，控制控件在界面中的展示状态。

1. setCurrentFont ()：设置字体下拉框当前选中的字体，传入 QFont 对象（如setCurrentFont(QFont("Microsoft YaHei"))），程序化指定选中字体。

2. currentFont ()：获取当前选中的字体对象，返回 QFont 类型，是读取选中字体最核心的方法（可进一步获取字体名称、大小等属性）。

3. currentText ()：直接获取当前选中字体的名称（字符串类型，如 “Arial”“微软雅黑”），是 QComboBox 继承来的高频方法，比 currentFontName () 更通用。

4. currentFontName ()：获取当前选中字体的名称（部分版本等效于 currentText ()），返回字符串类型，专门用于读取字体名称。

5. setFontFilters ()：设置字体过滤规则，可选值有 QFontComboBox.AllFonts（显示所有字体）、QFontComboBox.ScalableFonts（仅缩放字体）、QFontComboBox.MonospacedFonts（仅等宽字体）等，筛选展示的字体列表。

6. fontFilters ()：获取当前设置的字体过滤规则，返回对应的枚举值，用于校验过滤条件。

7. setEditable ()：设置下拉框是否可编辑，True 为可手动输入字体名称、False 为仅可选择预设字体（默认），拓展字体选择方式。

8. setEnabled ()：设置字体下拉框是否可用，True 为正常交互（可展开 / 选择）、False 为禁用（灰显，无法操作），控制交互状态。

9. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置下拉框边框、背景色、字体列表样式、选中项样式等，自定义视觉效果。

10. clear ()：清空字体下拉框的自定义筛选状态（恢复默认字体列表），重置下拉框展示内容。

11. count ()：获取字体下拉框中展示的字体总数，返回 int 类型，用于校验字体列表数量。

12. setMaxVisibleItems ()：设置下拉列表中最多可见的字体项数量，传入整数（如setMaxVisibleItems(10)），避免下拉列表过长。

13. itemText ()：根据索引获取对应位置的字体名称，传入索引值（如itemText(5)），读取指定位置的字体名称。

14. currentIndex ()：获取当前选中字体的索引，返回 int 类型，用于读取选中位置。

15. setCurrentIndex ()：根据索引设置选中的字体，传入整数（如setCurrentIndex(0)选中第一个字体），按位置选择字体。

16. setVisible ()：设置字体下拉框是否可见，True 为显示、False 为隐藏，控制控件在界面中的展示状态。

17. setPlaceholderText ()：设置占位提示文本（仅可编辑模式下生效），无选中 / 输入时显示灰色提示（如 “请选择字体”）。

• addItem ()：向列表中添加项

• addItems ()：一次向列表中添加多项

• insertItem ()：在指定索引处插入项

• setCurrentItem ()：设置当前选择项

• item.setToolTip ()：设置提示内容

• item.isSelected ()：判断项是否选中

• setSelectionMode ()：设置列表的选择模式，支持以下 5 种模式。

• QAbstractItemView.NoSelection: 不能选择；QAbstractItemView.SingleSelection: 单选；QAbstractItemView.MultiSelection: 多选；QAbstractItemView.ExtendedSelection: 正常单选，按 Ctrl 或者 Shift 键后，可以多选；QAbstractItemView.ContiguousSelection: 与 ExtendedSelection 类似

• setSelectionBehavior ()：设置选择项的方式，支持以下 3 种方式。

• QAbstractItemView.SelectItems: 选中当前项；QAbstractItemView.SelectRows: 选中整行；QAbstractItemView.SelectColumns: 选中整列

• setWordWrap ()：设置是否自动换行，True 表示自动换行，False 表示不自动换行

• setViewMode ()：设置显示模式，有以下两种显示模式。QListView.ListMode: 以列表形式显示；QListView.IconMode: 以图表形式显示

• item.text ()：获取项的文本

• clear ()：删除所有列表项

1. setTitle ()：设置分组框的标题文本，覆盖原有标题，是标识分组内容的核心方法（如 “用户信息”“参数设置”）。

2. title ()：获取分组框当前的标题文本，返回字符串类型，用于读取分组的标识信息。

3. setCheckable ()：设置分组框是否带复选框，True 为带复选框（可控制分组启用 / 禁用）、False 为普通分组框（默认），拓展分组的交互模式。

4. isCheckable ()：判断分组框是否启用复选框模式，返回布尔值，校验分组框的展示模式。

5. setChecked ()：设置分组框复选框的选中状态（仅 checkable=True 时生效），True 为选中（分组内控件可用）、False 为未选中（分组内控件禁用），控制分组整体交互状态。

6. isChecked ()：判断分组框复选框的选中状态，返回布尔值，读取分组的启用状态。

7. setAlignment ()：设置标题文本的对齐方式，可选 Qt.AlignLeft（左对齐）、Qt.AlignCenter（居中）、Qt.AlignRight（右对齐）等，调整标题展示位置。

8. setFlat ()：设置分组框是否为扁平样式，True 为扁平（无边框，仅显示标题）、False 为默认样式（带边框），适配简约 / 常规界面风格。

9. isFlat ()：判断分组框是否为扁平样式，返回布尔值，校验分组框的视觉样式。

10. setEnabled ()：设置分组框整体是否可用，True 为分组及内部控件正常交互、False 为全部禁用（灰显），批量控制分组内控件状态。

11. setStyleSheet ()：通过 CSS 样式表美化分组框，支持设置标题字体 / 颜色、边框样式、背景色等，自定义分组框视觉效果。

12. setVisible ()：设置分组框是否可见，True 为显示、False 为隐藏，控制分组框及内部所有控件的展示状态。

13. setLayout ()：为分组框绑定布局管理器（如 QVBoxLayout、QHBoxLayout），是分组框容纳子控件的核心方法，需先设布局再添加子控件。

14. layout ()：获取分组框当前的布局管理器，返回 QLayout 实例，用于动态调整分组内控件的布局结构。

15. setMinimumSize ()：设置分组框的最小尺寸，防止布局压缩导致内部控件显示不全。

16. setMaximumSize ()：设置分组框的最大尺寸，限制分组框占用过多界面空间。

17. setObjectName ()：设置分组框的唯一标识名，用于样式表精准定位或代码中快速查找该控件。

1. addTab ()：向标签栏添加新标签页，传入待挂载的页面控件 + 标签文本（可选搭配 QIcon 设置图标），如addTab(QWidget(), "首页")，是创建标签页最核心的方法。

2. insertTab ()：在指定索引位置插入新标签页，参数为(索引, 页面控件, 标签文本)，精准控制标签页的插入位置（如在第 2 位插入新标签）。

3. setCurrentIndex ()：设置当前选中的标签页索引，传入整数（如setCurrentIndex(0)选中第一个标签），程序化切换标签页。

4. currentIndex ()：获取当前选中标签页的索引，返回 int 类型，是读取选中位置最基础的方法。

5. setCurrentWidget ()：根据页面控件设置当前选中的标签页，传入 QWidget 实例（如setCurrentWidget(setting_widget)），按控件对象切换标签。

6. currentWidget ()：获取当前选中标签页对应的控件对象，返回 QWidget 类型，用于操作选中标签页内的子控件。

7. tabText ()：根据索引获取对应标签页的文本，传入索引值（如tabText(1)），读取标签页的名称。

8. setTabText ()：修改指定索引标签页的文本，参数为(索引, 新文本)（如setTabText(0, "主页")），动态更新标签名称。

9. removeTab ()：删除指定索引位置的标签页，传入索引值，动态删减不需要的标签页。

10. count ()：获取标签栏中标签页的总数，返回 int 类型，用于校验标签页数量或遍历标签。

11. clear ()：清空所有标签页（删除所有页面控件和标签文本），快速重置标签栏的配置。

12. setTabIcon ()：为指定索引标签页设置图标，传入(索引, QIcon对象)（如setTabIcon(0, QIcon("home.png"))），增强标签的视觉辨识度。

13. tabIcon ()：根据索引获取标签页的图标，返回 QIcon 对象，读取标签页的图标配置。

14. setTabToolTip ()：为指定索引标签页设置悬停提示文本，传入(索引, 提示文本)（如setTabToolTip(1, "系统设置页面")），提升交互友好性。

15. setTabsClosable ()：设置标签页是否显示关闭按钮，True 为显示（点击 × 可关闭标签）、False 为隐藏（默认），支持手动关闭标签页。

16. setMovable ()：设置标签页是否可拖动，True 为可拖动调整标签顺序、False 为固定顺序（默认），提升标签操作灵活性。

17. setEnabled ()：设置整个标签控件是否可用，True 为所有标签页正常交互、False 为全部禁用（灰显），批量控制标签页的交互状态。

18. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置标签栏背景、选中标签样式、标签文本字体 / 颜色、关闭按钮样式等，自定义视觉效果。

19. setVisible ()：设置标签控件是否可见，True 为显示、False 为隐藏，控制整个标签栏及所有标签页的展示状态。

20. setTabPosition ()：设置标签栏的显示位置，可选QTabWidget.North（顶部，默认）、South（底部）、East（右侧）、West（左侧），适配不同界面布局需求。

1. addItem ()：向工具箱添加新的选项卡，传入待挂载的页面控件 + 选项卡文本（可选搭配 QIcon 设置图标），如addItem(QWidget(), "基础设置")，是创建选项卡最核心的方法。

2. insertItem ()：在指定索引位置插入新选项卡，参数为(索引, 页面控件, 选项卡文本)，精准控制选项卡的插入位置（如在第 1 位插入新选项卡）。

3. setCurrentIndex ()：设置当前选中的选项卡索引，传入整数（如setCurrentIndex(0)选中第一个选项卡），程序化切换选项卡。

4. currentIndex ()：获取当前选中选项卡的索引，返回 int 类型，是读取选中位置最基础的方法。

5. currentWidget ()：获取当前选中选项卡对应的控件对象，返回 QWidget 类型，用于操作选中选项卡内的子控件。

6. itemText ()：根据索引获取对应选项卡的文本，传入索引值（如itemText(1)），读取选项卡的名称。

7. setItemText ()：修改指定索引选项卡的文本，参数为(索引, 新文本)（如setItemText(0, "系统基础设置")），动态更新选项卡名称。

8. removeItem ()：删除指定索引位置的选项卡，传入索引值，动态删减不需要的选项卡。

9. count ()：获取工具箱中选项卡的总数，返回 int 类型，用于校验选项卡数量或遍历选项卡。

10. setItemIcon ()：为指定索引选项卡设置图标，传入(索引, QIcon对象)（如setItemIcon(0, QIcon("setting.png"))），增强选项卡的视觉辨识度。

11. itemIcon ()：根据索引获取选项卡的图标，返回 QIcon 对象，读取选项卡的图标配置。

12. setItemToolTip ()：为指定索引选项卡设置悬停提示文本，传入(索引, 提示文本)（如setItemToolTip(1, "个性化外观设置")），提升交互友好性。

13. itemToolTip ()：根据索引获取选项卡的悬停提示文本，返回字符串类型，读取提示信息。

14. setEnabled ()：设置整个工具箱是否可用，True 为所有选项卡正常交互、False 为全部禁用（灰显），批量控制交互状态。

15. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置选项卡文本字体 / 颜色、选中项样式、背景色、边框等，自定义视觉效果。

16. setVisible ()：设置工具箱是否可见，True 为显示、False 为隐藏，控制整个控件及所有选项卡的展示状态。

17. setItemEnabled ()：设置指定索引选项卡是否可用，参数为(索引, 布尔值)（如setItemEnabled(2, False)禁用第 3 个选项卡），单独控制单个选项卡的交互状态。

18. isItemEnabled ()：判断指定索引选项卡是否可用，返回布尔值，校验单个选项卡的启用状态。

19. widget ()：根据索引获取对应选项卡的控件对象，返回 QWidget 类型，用于操作指定选项卡内的子控件。

1. setDateTime ()：设置控件显示的日期时间，传入 QDateTime 对象（如setDateTime(QDateTime.currentDateTime())），是配置完整日期时间最核心的方法。

2. dateTime ()：获取控件当前显示的日期时间，返回 QDateTime 对象，用于读取完整的日期时间信息。

3. setDate ()：单独设置日期部分，传入 QDate 对象（如setDate(QDate(2026, 3, 22))），仅修改日期不影响时间。

4. date ()：获取控件当前显示的日期部分，返回 QDate 对象，专门读取日期信息。

5. setTime ()：单独设置时间部分，传入 QTime 对象（如setTime(QTime(14, 30, 0))），仅修改时间不影响日期。

6. time ()：获取控件当前显示的时间部分，返回 QTime 对象，专门读取时间信息。

7. setDisplayFormat ()：设置日期时间的显示格式，传入格式字符串（如setDisplayFormat("yyyy-MM-dd HH:mm:ss")），常用格式符：yyyy（年）、MM（月）、dd（日）、HH（时）、mm（分）、ss（秒），自定义展示样式。

8. displayFormat ()：获取当前的显示格式字符串，返回字符串类型，读取格式配置。

9. setMinimumDateTime ()：设置可选择的最小日期时间，传入 QDateTime 对象，限制用户选择的时间下限。

10. minimumDateTime ()：获取设置的最小日期时间，返回 QDateTime 对象，校验时间下限。

11. setMaximumDateTime ()：设置可选择的最大日期时间，传入 QDateTime 对象，限制用户选择的时间上限。

12. maximumDateTime ()：获取设置的最大日期时间，返回 QDateTime 对象，校验时间上限。

13. setRange ()：一次性设置日期时间可选范围，传入最小和最大 QDateTime 对象（如setRange(min_dt, max_dt)），快速配置时间区间。

14. setCalendarPopup ()：设置是否显示日历弹窗，True 为点击日期弹出日历选择器、False 为仅通过上下键调整（默认），大幅提升日期选择便捷性。

15. isCalendarPopup ()：判断是否启用日历弹窗模式，返回布尔值，校验选择模式。

16. setReadOnly ()：设置控件是否为只读状态，True 为仅可查看、False 为可编辑（默认），控制日期时间修改权限。

17. setEnabled ()：设置控件是否可用，True 为正常交互（可选择 / 修改）、False 为禁用（灰显），控制核心交互状态。

18. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置边框、背景色、字体、选中部分样式、日历弹窗样式等，自定义视觉效果。

19. stepUp ()：手动触发时间递增（按当前步长，如分钟 + 1），程序化调整时间。

20. stepDown ()：手动触发时间递减（按当前步长，如小时 - 1），程序化调整时间。

21. setTimeSpec ()：设置时间标准（如 UTC、本地时间），传入 Qt.TimeSpec 枚举值，适配不同时区 / 时间标准需求。

22. timeSpec ()：获取当前的时间标准，返回对应的枚举值，读取时间标准配置。

23. clear ()：清空当前日期时间（重置为默认值），快速重置控件内容。

24. setVisible ()：设置控件是否可见，True 为显示、False 为隐藏，控制控件在界面中的展示状态。

1. setDate ()：设置控件显示的日期，传入 QDate 对象（如setDate(QDate(2026, 3, 22))），是配置日期最核心的方法，直接覆盖原有日期。

2. date ()：获取控件当前显示的日期，返回 QDate 对象，可进一步提取年、月、日（如date().year()），是读取日期最基础的方法。

3. setDisplayFormat ()：设置日期的显示格式，传入格式字符串（如setDisplayFormat("yyyy-MM-dd")），常用格式符：yyyy（4 位年）、MM（2 位月）、dd（2 位日）、MMM（月份缩写）等，自定义日期展示样式。

4. displayFormat ()：获取当前的日期显示格式字符串，返回字符串类型，用于读取或校验格式配置。

5. setMinimumDate ()：设置可选择的最小日期，传入 QDate 对象（如setMinimumDate(QDate(2020, 1, 1))），限制用户选择的日期下限。

6. minimumDate ()：获取设置的最小日期，返回 QDate 对象，用于校验日期选择的下限范围。

7. setMaximumDate ()：设置可选择的最大日期，传入 QDate 对象（如setMaximumDate(QDate(2030, 12, 31))），限制用户选择的日期上限。

8. maximumDate ()：获取设置的最大日期，返回 QDate 对象，用于校验日期选择的上限范围。

9. setRange ()：一次性设置日期可选范围，传入最小和最大 QDate 对象（如setRange(min_date, max_date)），快速配置完整的日期区间。

10. setCalendarPopup ()：设置是否显示日历弹窗，True 为点击日期区域弹出日历选择器、False 为仅通过上下键调整（默认），大幅提升日期选择的便捷性。

11. isCalendarPopup ()：判断是否启用日历弹窗模式，返回布尔值，校验日期选择的交互模式。

12. setReadOnly ()：设置控件是否为只读状态，True 为仅可查看日期、False 为可编辑（默认），控制日期的修改权限。

13. isReadOnly ()：判断控件是否为只读状态，返回布尔值，校验日期的编辑权限。

14. setEnabled ()：设置控件是否可用，True 为正常交互（可选择 / 修改日期）、False 为禁用（灰显，无法操作），核心的交互状态控制方法。

15. stepUp ()：手动触发日期递增（默认步长为 1 天），等同于点击控件的向上调整按钮，程序化调整日期。

16. stepDown ()：手动触发日期递减（默认步长为 1 天），等同于点击控件的向下调整按钮，程序化调整日期。

17. stepBy ()：按指定步长调整日期，传入整数（如stepBy(7)增加 7 天、stepBy(-1)减少 1 天），精准控制日期调整幅度。

18. setStepType ()：设置日期调整的步长类型，可选QDateEdit.DefaultStepType（按天调整，默认）、QDateEdit.MonthStepType（按月调整）、QDateEdit.YearStepType（按年调整），适配不同粒度的日期调整需求。

19. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置边框、背景色、字体大小 / 颜色、选中区域样式、日历弹窗样式等，自定义视觉效果。

20. clear ()：清空当前显示的日期（重置为控件默认日期），快速恢复初始状态。

21. setVisible ()：设置控件是否可见，True 为显示、False 为隐藏，控制控件在界面中的展示状态。

1. setTime ()：设置控件显示的时间，传入 QTime 对象（如setTime(QTime(14, 30, 0))），直接覆盖原有时间，是配置时间最核心的方法。

2. time ()：获取控件当前显示的时间，返回 QTime 对象，可进一步提取时、分、秒（如time().hour()），是读取时间最基础的方法。

3. setDisplayFormat ()：设置时间的显示格式，传入格式字符串（如setDisplayFormat("HH:mm:ss")），常用格式符：HH（24 小时制时）、hh（12 小时制时）、mm（分）、ss（秒）、zzz（毫秒），自定义时间展示样式。

4. displayFormat ()：获取当前的时间显示格式字符串，返回字符串类型，用于读取或校验格式配置。

5. setMinimumTime ()：设置可选择的最小时间，传入 QTime 对象（如setMinimumTime(QTime(0, 0, 0))），限制用户选择的时间下限。

6. minimumTime ()：获取设置的最小时间，返回 QTime 对象，用于校验时间选择的下限范围。

7. setMaximumTime ()：设置可选择的最大时间，传入 QTime 对象（如setMaximumTime(QTime(23, 59, 59))），限制用户选择的时间上限。

8. maximumTime ()：获取设置的最大时间，返回 QTime 对象，用于校验时间选择的上限范围。

9. setRange ()：一次性设置时间可选范围，传入最小和最大 QTime 对象（如setRange(min_time, max_time)），快速配置完整的时间区间。

10. setReadOnly ()：设置控件是否为只读状态，True 为仅可查看时间、False 为可编辑（默认），控制时间的修改权限。

11. isReadOnly ()：判断控件是否为只读状态，返回布尔值，校验时间的编辑权限。

12. setEnabled ()：设置控件是否可用，True 为正常交互（可选择 / 修改时间）、False 为禁用（灰显，无法操作），核心的交互状态控制方法。

13. stepUp ()：手动触发时间递增（默认步长为 1 分钟），等同于点击控件的向上调整按钮，程序化调整时间。

14. stepDown ()：手动触发时间递减（默认步长为 1 分钟），等同于点击控件的向下调整按钮，程序化调整时间。

15. stepBy ()：按指定步长调整时间，传入整数（如stepBy(5)增加 5 分钟、stepBy(-1)减少 1 分钟），精准控制时间调整幅度。

16. setStepType ()：设置时间调整的步长类型，可选QTimeEdit.DefaultStepType（按分钟调整，默认）、QTimeEdit.SecondStepType（按秒调整）、QTimeEdit.HourStepType（按小时调整），适配不同粒度的时间调整需求。

17. setCurrentSection ()：设置当前可编辑的时间段（如QTimeEdit.HourSection（小时段）、MinuteSection（分钟段）、SecondSection（秒段）），精准定位编辑焦点位置。

18. currentSection ()：获取当前可编辑的时间段，返回对应的枚举值，读取编辑焦点所在的时间维度。

19. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置边框、背景色、字体大小 / 颜色、选中区域样式等，自定义视觉效果。

20. clear ()：清空当前显示的时间（重置为控件默认时间），快速恢复初始状态。

21. setVisible ()：设置控件是否可见，True 为显示、False 为隐藏，控制控件在界面中的展示状态。

1. setSelectedDate ()：设置日历当前选中的日期，传入 QDate 对象（如setSelectedDate(QDate(2026, 3, 22))），是控制日期选中状态最核心的方法。

2. selectedDate ()：获取日历当前选中的日期，返回 QDate 对象，可提取年、月、日（如selectedDate().year()），是读取选中日期最基础的方法。

3. setMinimumDate ()：设置日历可选择的最小日期，传入 QDate 对象（如setMinimumDate(QDate(2020, 1, 1))），限制用户选择的日期下限。

4. minimumDate ()：获取设置的最小可选日期，返回 QDate 对象，用于校验日期选择的下限范围。

5. setMaximumDate ()：设置日历可选择的最大日期，传入 QDate 对象（如setMaximumDate(QDate(2030, 12, 31))），限制用户选择的日期上限。

6. maximumDate ()：获取设置的最大可选日期，返回 QDate 对象，用于校验日期选择的上限范围。

7. setRange ()：一次性设置日期可选范围，传入最小和最大 QDate 对象（如setRange(min_date, max_date)），快速配置完整的日期区间。

8. setCurrentPage ()：设置日历当前展示的年月，传入年和月（如setCurrentPage(2026, 3)），直接切换日历的展示页面（不改变选中状态）。

9. yearShown ()：获取当前日历展示的年份，返回 int 类型，单独读取展示页的年份信息。

10. monthShown ()：获取当前日历展示的月份，返回 int 类型，单独读取展示页的月份信息。

11. showToday ()：快速跳转到今日日期，自动选中今日并切换到今日所在的年月页，是便捷的日历重置操作。

12. gotoDate ()：跳转到指定日期并展示其所在年月页，传入 QDate 对象（如gotoDate(QDate(2026, 5, 1))），等同于 “切换展示页 + 选中日期” 的组合操作。

13. setFirstDayOfWeek ()：设置一周的第一天，传入 Qt.DayOfWeek 枚举值（如Qt.Monday（周一）、Qt.Sunday（周日）），适配不同地区的日历显示习惯。

14. firstDayOfWeek ()：获取设置的一周第一天，返回对应的枚举值，校验日历的显示规则。

15. setGridVisible ()：设置是否显示日历网格线，True 为显示、False 为隐藏（默认），优化日历的视觉布局清晰度。

16. isGridVisible ()：判断是否显示网格线，返回布尔值，校验网格的显示状态。

17. setSelectionMode ()：设置日期选择模式，可选QCalendarWidget.NoSelection（不可选）、SingleSelection（单选，默认），控制日期的选择权限。

18. selectionMode ()：获取当前的选择模式，返回对应的枚举值，校验日期选择的权限配置。

19. setHorizontalHeaderFormat ()：设置水平表头（星期）的显示格式，可选ShortDayNames（短名称，如 Mon）、LongDayNames（长名称，如 Monday）、NoHorizontalHeader（隐藏表头），自定义表头展示样式。

20. horizontalHeaderFormat ()：获取水平表头的显示格式，返回枚举值，读取表头配置信息。

21. setVerticalHeaderFormat ()：设置垂直表头的显示格式，可选ISOWeekNumbers（显示周数）、NoVerticalHeader（隐藏表头），自定义垂直方向的表头展示。

22. verticalHeaderFormat ()：获取垂直表头的显示格式，返回枚举值，读取垂直表头配置。

23. setDateTextFormat ()：为指定日期设置文本样式，传入 QDate 对象和 QTextCharFormat（如设置字体颜色、大小、背景色），用于高亮重要日期（如节假日、纪念日）。

24. dateTextFormat ()：获取指定日期的文本样式，返回 QTextCharFormat 对象，读取自定义的日期样式配置。

25. selectedDates ()：获取选中的日期列表（单选模式下仅含一个日期），返回List[QDate]类型，适配潜在的多选场景。

26. setEnabled ()：设置日历是否可用，True 为正常交互（可选择日期、切换年月）、False 为禁用（灰显，无交互），核心的交互状态控制方法。

27. setStyleSheet ()：通过 CSS 样式表美化控件，支持设置日历背景色、选中日期样式、表头字体 / 颜色、网格颜色等，自定义整体视觉效果。

28. refresh ()：刷新日历的显示内容，重新渲染所有元素，适配动态修改样式 / 日期规则后的即时更新。

29. setVisible ()：设置日历控件是否可见，True 为显示、False 为隐藏，控制控件在界面中的展示状态。

后续我会持续输出优质、实用的内容，也欢迎大家在评论区留言，说说你们最想学习的内容、遇到的困惑，我们一起交流、一起进步。

愿每一位软件人，都能在这里收获知识、突破自我，在自己的赛道上发光发热✨