基本Widgets(13)：【类】QAbstractSpinBox [官翻]

最新推荐文章于 2024-05-10 21:10:28 发布
最新推荐文章于 2024-05-10 21:10:28 发布
阅读量683 收藏 1
点赞数
分类专栏： # Qt Widgets
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hitzsf/article/details/113107926
版权

文章目录

QAbstractSpinBox Class

QAbstractSpinBox类提供了一个选择框和一个行编辑来显示值。

Header#include < QAbstractSpinBox >
qmakeQT += widgets
InheritsQWidget
Inherited ByQDateTimeEdit, QDoubleSpinBox, and QSpinBox

详细说明

该类被设计为QSpinBox、QDoubleSpinBox和QDateTimeEdit等小部件的通用超类。

以下是类的主要属性:

  1. text: QAbstractSpinBox中显示的文本。
  2. alignment:QAbstractSpinBox中文本的对齐方式。
  3. wrapping: QAbstractSpinBox是否从最小值包装到最大值，反之亦然。

QAbstractSpinBox提供了stepBy(int) 虚函数，每当用户触发一个步骤时都会调用该函数。此函数采用整数值表示执行了多少步。例如：按下Qt::键将触发对stepBy(-1）的调用。

当用户在按住Qt::ControlModifier的同时触发一个步骤时，QAbstractSpinBox将按10步执行，而不是执行一个步骤。此步骤修改器影响控制盘事件、关键点事件以及与spinbox按钮的交互。注意，在macOS上，Control对应于Command键。

从Qt5.12开始，可以使用 QStyle::SH_SpinBox_StepModifier 来选择哪个Qt::KeyboardModifier增加步进速率。NoModifier禁用此功能。

QAbstractSpinBox还提供了一个虚拟函数stepEnabled() ，用于确定是否允许在任何点上执行递增/递减操作。此函数返回StepEnabled的位集。

公共类型

enum ButtonSymbols

此枚举类型描述可以在数字调整框中的按钮上显示的符号。
imgimg

ConstantValueDescription
UpDownArrows0经典风格的小箭头。
PlusMinus1+和-符号。
NoButtons2不显示按钮。

enum CorrectionMode

此枚举类型描述在编辑完成时spinbox将用于更正中间值的模式。

ConstantValueDescription
CorrectToPreviousValue0spinbox将还原为最后一个有效值。
CorrectToNearestValue1spinbox将还原为最接近的有效值。

enum StepEnabledFlag

flags StepEnabled

ConstantValue
StepNone0x00
StepUpEnabled0x01
StepDownEnabled0x02

enum StepType

ConstantValue
DefaultStepType0
AdaptiveDecimalStepType1

属性

  1. accelerated: bool 在按下“向上/向下步进”按钮时数字调整框是否会加快步进频率
    如果启用，按住按钮的时间越长，数字调整框将更快地增加/减少值。

    Access functions:

    • bool isAccelerated() const
    • void setAccelerated(bool on)

  2. acceptableInput: const bool 输入是否满足当前验证

    Access functions:

    • bool hasAcceptableInput() const

  3. alignment: Qt::Alignment 数字调整框的对齐方式
    可能的值有Qt:：AlignLeft、Qt:：AlignRight和Qt:：AlignHCenter。
    默认情况下，为Qt:：AlignLeft
    尝试将对齐方式设置为非法的标志组合不会产生任何效果。

    Access functions:

    • Qt::Alignment alignment() const

    • void setAlignment(Qt::Alignment flag)

    • 参考：Qt::Alignment

  4. buttonSymbols: ButtonSymbols 当前按钮符号模式
    可能的值可以是上下箭头或PlusMinus。默认设置为上下箭头。
    请注意，某些样式可能会以相同的方式呈现PlusMinus和UpDownArrows。

    Access functions:

    • QAbstractSpinBox::ButtonSymbols buttonSymbols() const
    • void setButtonSymbols(QAbstractSpinBox::ButtonSymbols bs)

  5. correctionMode: CorrectionMode 编辑完成时更正中间值的模式

    Access functions:

    • QAbstractSpinBox::CorrectionMode correctionMode() const
    • void setCorrectionMode(QAbstractSpinBox::CorrectionMode cm)

  6. frame: bool 数字调整框是否使用框架绘制自身
    如果启用（默认设置），数字调整框将在帧内绘制自身，否则数字调整框将在没有任何帧的情况下绘制自身。

    Access functions:

    • bool hasFrame() const

    • void setFrame(bool)

  7. keyboardTracking: bool 是否为spinbox启用键盘跟踪
    如果启用键盘跟踪（默认），则在从键盘输入新值时，spinbox会发出valueChanged() 和textChanged() 信号。

    例如.当用户通过键入6、0和0来输入值600时，spinbox将发出3个分别为6、60和600的信号。

    如果禁用键盘跟踪，则在键入时spinbox不会发出valueChanged() 和textChanged() 信号。稍后，当按下返回键、键盘焦点丢失或使用其他spinbox功能（如按箭头键）时，它会发出信号。

    Access functions:

    • bool keyboardTracking() const
    • void setKeyboardTracking(bool kt)

  8. readOnly: bool 数字调整框是否为只读
    在只读模式下，用户仍然可以将文本复制到剪贴板，或拖放文本；但不能编辑文本。
    QAbstractSpinBox中的QLineEdit在只读模式下不显示光标。

    Access functions:

    • bool isReadOnly() const
    • void setReadOnly(bool r)

  9. showGroupSeparator: bool 是否启用了千位分隔符
    默认情况下，此属性为false。

    Access functions:

    • bool isGroupSeparatorShown() const

    • void setGroupSeparatorShown(bool shown)

  10. specialValueText: QString 特殊值文本
    如果设置，每当当前值等于minimum() 时，数字调整框将显示此文本而不是数字值。典型的用法是表示此选项具有特殊（默认）含义。

    例如，如果数字调整框允许用户选择用于显示图像的比例因子（或缩放级别），并且应用程序能够自动选择一个使图像完全适合显示窗口的比例因子，则可以如下设置数字调整框：

    Access functions:

    • QString specialValueText() const
    • void setSpecialValueText(const QString &txt)

  11. text: const QString 数字调整框的文本，包括任何前缀和后缀
    没有默认文本。

    Access functions:

    • QString text() const

  12. wrapping: bool 确定数字调整框是否为环形
    如果wrapping为true，则从maximum() 值递增将带您到minimum() 值，反之亦然。只有在设置了minimum() 和maximum() 值时，包装才有意义。

    Access functions:

    • bool wrapping() const
    • void setWrapping(bool w)

公共函数

构造和析构

  1. QAbstractSpinBox(QWidget *parent = nullptr)
  2. virtual ~QAbstractSpinBox()

属性相关

  1. bool isAccelerated() const
  2. void setAccelerated(bool on)
  3. bool hasAcceptableInput() const
  4. Qt::Alignment alignment() const
  5. void setAlignment(Qt::Alignment flag)
  6. QAbstractSpinBox::ButtonSymbols buttonSymbols() const
  7. void setButtonSymbols(QAbstractSpinBox::ButtonSymbols bs)
  8. QAbstractSpinBox::CorrectionMode correctionMode() const
  9. void setCorrectionMode(QAbstractSpinBox::CorrectionMode cm)
  10. bool hasFrame() const
  11. void setFrame(bool)
  12. bool keyboardTracking() const
  13. void setKeyboardTracking(bool kt)
  14. bool isReadOnly() const
  15. void setReadOnly(bool r)
  16. bool isGroupSeparatorShown() const
  17. void setGroupSeparatorShown(bool shown)
  18. QString specialValueText() const
  19. void setSpecialValueText(const QString &txt)
  20. QString text() const
  21. bool wrapping() const
  22. void setWrapping(bool w)

特殊

  1. virtual void fixup(QString &input) const 尝试更改文本以使其有效

    如果按下Return或调用interpretatText() 时输入未验证为QValidator::Acceptable，则QAbstractSpinBox将调用此虚拟函数。它将尝试更改文本以使其有效。在不同的子类中重新实现。

  2. void interpretText() 此函数用于解释数字调整框的文本
    如果值自上次解释后发生变化，它将发出信号。

  3. virtual void stepBy(int steps) 每当用户触发一个步骤时调用的虚函数

    steps参数指示执行了多少步。例如，按下Qt::Key_Down将触发对stepBy（-1）的调用，而按下Qt:：Key_PageUp将触发对stepBy（10）的调用。

    如果将QAbstractSpinBox子类化，则必须重新实现此函数。请注意，即使结果值超出最小值和最大值的界限，也会调用此函数。这个函数的工作就是处理这些情况。

  4. virtual QValidator::State validate(QString &input, int &pos) const 调用此虚拟函数以确定输入是否有效

    pos参数表示字符串中的位置。在不同的子类中重新实现。

重写的公共函数

  1. virtual bool event(QEvent *event) override
  2. virtual QVariant inputMethodQuery(Qt::InputMethodQuery query) const override
  3. virtual QSize minimumSizeHint() const override
  4. virtual QSize sizeHint() const override

公共槽

  1. virtual void clear() 清除除前缀和后缀之外的所有文本
  2. void selectAll() 选择微调框中除前缀和后缀之外的所有文本
  3. void stepDown() 调用这个插槽类似于调用stepBy（-1）
  4. void stepUp() 调用这个插槽类似于调用stepBy（1）

信号

  1. void editingFinished() 当编辑完成时，发出该信号。

    当spinbox失去焦点并且按下enter键时，会发生这种情况。

受保护的函数

  1. void initStyleOption(QStyleOptionSpinBox *option) const
  2. QLineEdit * lineEdit() const
  3. void setLineEdit(QLineEdit *lineEdit)
  4. virtual QAbstractSpinBox::StepEnabled stepEnabled() const

重写的受保护的函数

  1. virtual void changeEvent(QEvent *event) override
  2. virtual void closeEvent(QCloseEvent *event) override
  3. virtual void contextMenuEvent(QContextMenuEvent *event) override
  4. virtual void focusInEvent(QFocusEvent *event) override
  5. virtual void focusOutEvent(QFocusEvent *event) override
  6. virtual void hideEvent(QHideEvent *event) override
  7. virtual void keyPressEvent(QKeyEvent *event) override
  8. virtual void keyReleaseEvent(QKeyEvent *event) override
  9. virtual void mouseMoveEvent(QMouseEvent *event) override
  10. virtual void mousePressEvent(QMouseEvent *event) override
  11. virtual void mouseReleaseEvent(QMouseEvent *event) override
  12. virtual void paintEvent(QPaintEvent *event) override
  13. virtual void resizeEvent(QResizeEvent *event) override
  14. virtual void showEvent(QShowEvent *event) override
  15. virtual void timerEvent(QTimerEvent *event) override
  16. virtual void wheelEvent(QWheelEvent *event) override

参考

  • Spin Boxes Example
hitzsf
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
iOS-Widgets:iOS小工具
05-26
iOS小工具（可编写脚本）空气质量 世界空气质量指数项目是一个非营利性项目，始于2007年。其任务是提高公民的空气污染意识，并提供统一的全球空气质量信息。 该项目通过aqicn.org和waqi.info这两个网站为130多个国家...
Qt开发：Qt Widgets模块——QAbstractSpinBox类
一世豁然的专栏
05-17 4196
QAbstractSpinBox类提供了一个spinbox和一个行编辑来显示值。头文件：#include &lt;QAbstractSpinBox&gt; qmake：QT += widgets继承：QWidget被继承：QDateTimeEdit，QDoubleSpinBox和QSpinBox该类被设计为一个常见的超类，如QSpinBox，QDoubleSpinBox和QDateTimeEdit...
第15.43节、PyQt输入部件：QAbstractSpinBox派生类QSpinBox、 QDoubleSpinBox、QDateTimeEdit、QDateEdit和QTimeEdit功能简介
老猿Python
04-25 1245
专栏：Python基础教程目录 专栏：使用PyQt开发图形界面Python应用 专栏：PyQt入门学习 老猿Python博文目录 老猿学5G博文目录 一、概述 Designer输入部件中的Spin Box、Double Spin Box、Time Edit、Date Edit、Date/Time Edit分别对应类QSpinBox、 QDoubleSpinBox、QDateTimeEdit、Q...
Qt | 旋转框(微调按钮)QAbstractSpinBox基类
最新发布
m0_45463480的博客
05-10 47
一、QAbstractSpinBox 类(旋转框或微调框)1、QAbstractSpinBox 类是 QWidget 类的直接子类，虽然该类不是抽象类，但该类并未提供实际的功能，仅为旋转框提供了一些外观的形式以及需要子类实现了成员，也就是说点击微调按钮的上/下按钮，不会使其中的数值有变化。实际的功能是由该类的子类提供的，用户也可继承该类实现自定义的功能。2、旋转框是由微调按钮(用于调整值)和行编辑器(用于显示值)组成的(见右图)
(三十六)Model/View Programming (二)
早起的虫儿灬
02-25 1187
四、Delegate类 1、Delegate类简介     不同于MVC模式，模型/视图设计并不包含用于处理与用户交互的完全独立的组件。 通常，视图负责把模型数据显示给用户，以及处理用户的输入。为了让这种输入有灵活性，这种交互由Delegates来完成。这些组件在视图中提供输入功能，同时负责传递视图中的单个项。控制Delegates的标准接口在 QAbstractItemDelegate类中定
QAbstractSpinBox
友善啊，朋友的博客
01-09 1334
一、描述 此类为 QSpinBox、QDoubleSpinBox 和 QDateTimeEdit 等小部件的通用超类。 QAbstractSpinBox 提供了一个虚函数 stepBy() ，只要用户触发一个步骤，就会调用该函数。该函数采用一个整数值来表示采取了多少步。例如。按下 Qt::Key_Down 将触发对 stepBy(-1) 的调用。 当用户在按住 Qt::ControlModifier 的同时触发一个步骤时，QAbstractSpinBox 会步进 10 而不是单步。此步进修饰符影响滚轮
QSpinBox、QDoubleSpinBox
友善啊，朋友的博客
01-11 1912
QSpinBox 一、描述 QSpinBox 继承自QAbstractSpinBox旨在处理整数和离散值。 子类化 QSpinBox 如果使用 prefix()、suffix() 和 specialValueText() 不能提供足够的控制，则将 QSpinBox 子类化并重新实现 valueFromText() 和 textFromValue()。 例如，这是一个自定义旋转框的代码，它允许用户输入图标大小（例如，“32 x 32”）： 二、属性成员 1、【只读】cleanText : c...
Widgets类关系.docx
06-13
整理的QT widgets 库中 类的关系图，可以从类层次上了解一下widgets应用
iOS-Widgets:iOS小部件集合
03-18
iOS小工具 这是脚本的集合，可以与可编写脚本的应用程序一起使用来创建iOS窗口小部件。 要使用脚本，您必须从App Store下载“可编写脚本”的应用程序： : 所有小部件都可以通过轻松安装： 路线图 ...
WidgetsApp:Mapremière应用程式Flutter
04-02
widgets_app 一个新的Flutter应用程序。入门该项目是Flutter应用程序的起点。 如果这是您的第一个Flutter项目，那么有一些资源可以帮助您入门：要获得Flutter入门方面的帮助，请查看我们的，其中提供了教程，示例，...
habpanel-widgets:Habpanel的小部件
05-23
**habpanel-widgets: Habpanel的小部件** Habpanel是一款强大的用户界面工具，专为开源智能家居平台OpenHAB设计。它允许用户自定义和控制家中的智能设备，提供了一个直观、可定制化的操作面板。"Habpanel的小部件...
qspinbox 和qdateTimeEdit
u012803067的博客
07-29 1949
版权声明：本文为博主原创文章，未经博主允许不得转载。 目录(?)[+] 继承关系如下： QAbstractSpinBox QDateTimeEdit QDateEdit QTimeEdit QDoubleSpinBox QSpinBox 默认外观分别如下（win7，与上述顺序对应）：
Qt应用开发(基础篇)——数值微调输入框 QAbstractSpinBox、QSpinBox、QDoubleSpinBox
波塞冬的博客
08-02 1352
QAbstractSpinBox是全部微调输入框的父类，这是一种允许用户通过点击上下箭头按钮或输入数字来调整数值的图形用户界面控件，父类主要提供了当前值text、对齐方式align、只读readOnly等通用属性和方法。QSpinBox整数微调输入框，设计用来处理整数的输入。双精度微调输入框，设计用来处理float型和double型的输入。时间日期微调输入框，设计用来处理时间和日期的输入。QDateEdit日期微调输入框，设计用来处理日期的输入。QTimeEdit。
使QSpinBox在输入完整的数据后响应
freemoon123的博客
03-17 7602
使QSpinBox在输入完整的数据后响应问题描述方法一方法二 问题描述 Qt的QSpinBox和QDoubleSpinBox两个控件在默认情况下是valueChanged信号，会响应每次输入栏的改变，加入你输入200，valueChanged会在输入2，20，200的时候都会emit，前2次的数据其实是无效的，假如连接的槽函数涉及非常耗时或者界面改变非常明显的操作，这样就不太好了，下面就尝试去解决...
QT(8)-QSpinBox
m晴朗的博客
02-01 1706
QSpinBox 是 Qt 中的一种数字输入控件，支持整数和浮点数输入。它允许用户通过上下箭头或键盘输入来选择数字。您可以设置最小值、最大值和步长，以限制用户输入的范围。QSpinBox 还支持前缀和后缀，您可以使用它们在数字前面或后面显示额外的信息。
Qt模块化笔记之Qt Widgets——抽象旋转框及其继承类
qt爱好者
01-12 3791
继承关系如下： QAbstractSpinBox QDateTimeEdit QDateEdit QTimeEdit QDoubleSpinBox QSpinBox 默认外观分别如下（win7，与上述顺序对应）： 可看出，都是由一个可编辑的文本框及右端小箭头组成 ———————————————————————————————————
QAbstractSpinBox（基类）
laner__gg的博客
03-12 373
1、QAbstractSpinBox只读设置，原来的文本编辑器的只读指无法应用鼠标键盘等操作，改变文本框中的内容。 此处指：只允许用户通过步长调节器调节，不能使用键盘输入。 asb.setReadOnly(True) 2、设置获取内容：创建提示符，单行文本编辑器的所有功能，获取单行文本编辑器之后都可以使用。 from PyQt5.Qt import * # 子类化控件类别 class MyASB(QAbstractSpinBox): # 定义值，不传值的
from PyQt5 import QtWidgets ModuleNotFoundError: No module named 'PyQt5'
09-28
您遇到的错误是因为您的计算机上没有安装 PyQt5 模块。您可以通过以下步骤安装 PyQt5： 1. 打开终端或命令提示符。 2. 使用 pip 命令安装 PyQt5： ``` pip install PyQt5 ``` ...如果您使用的是 Python3，可以使用 ...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值