QCheckBox Class Reference

[QtGui module]

该QCheckBox控件提供了一个文本标籤的复选框。More…

继承QAbstractButton。

Methods

  • __init__ (self, QWidget parent = None)
  • __init__ (self, QString text, QWidget parent = None)
  • Qt.CheckState checkState (self)
  • checkStateSet (self)
  • bool event (self, QEvent e)
  • bool hitButton (self, QPoint pos)
  • initStyleOption (self, QStyleOptionButton option)
  • bool isTristate (self)
  • QSize minimumSizeHint (self)
  • mouseMoveEvent (self, QMouseEvent)
  • nextCheckState (self)
  • paintEvent (self, QPaintEvent)
  • setCheckState (self, Qt.CheckState state)
  • setTristate (self, bool on = True)
  • QSize sizeHint (self)

Qt Signals

  • void stateChanged (int)

Detailed Description

该QCheckBox控件提供了一个文本标籤的复选框。

一个QCheckBox是一个选项按钮，可以打开（选中）或关闭（未选中） 。复选框通常用于表示可以启用或禁用，而不会影响其他应用程序的功能，但不同类型的行为可以实施。例如，一个QButtonGroup可以用来检查组在逻辑上的按钮，允许独家复选框。但是，QButtonGroup不提供任何视觉表示。

下面进一步的图像显示了独家及非独家复选框之间的差异。

| QCheckBox Class Reference - 图1 | QCheckBox Class Reference - 图2 |

每当一个复选框被选中或清除它发出的信号stateChanged（ ） 。连接到这个信号，如果你想每次复选框的状态发生改变来触发一个动作。您可以使用isChecked（ ）来查询一个复选框是否被选中。

除了通常的选中和未选中状态， QCheckBox选择提供第三状态表示“没有变化” 。每当你需要给用户既不检查也不是取消选中的复选框的选择，这是很有用的。如果您需要这第三状态，与启用setTristate（） ，并使用checkState（ ）查询当前的切换状态。

一样QPushButton，一个复选框显示文本和可选的小图标。该图标设置setIcon（ ） 。该文本可以在构造函数或设置setText（ ） 。快捷键可以通过首选字符与前面的符号来指定。例如：

  1.  QCheckBox *checkbox = new QCheckBox("C&ase sensitive", this);

在这个例子中，快捷键是Alt+A。请参阅QShortcut有关详细信息的文档（显示的实际符号，使用“\u0026\u0026” ） 。

重要的继承功能：text（ ）setText（ ）text（ ）pixmap（ ）setPixmap（ ）accel（ ）setAccel（ ）isToggleButton（ ）setDown（ ）isDown（ ）isOn（ ）checkState（ ）autoRepeat（ ） ， isExclusiveToggle （ ） ，group（ ）setAutoRepeat（ ）toggle（ ）pressed（ ）released（ ）clicked（ ）toggled（ ）checkState（）和stateChanged（ ） 。

| Screenshot of a Macintosh style checkbox | A checkbox shown in the Macintosh widget style. | | Screenshot of a Windows XP style checkbox | A checkbox shown in the Windows XP widget style. | | Screenshot of a Plastique style checkbox | A checkbox shown in the Plastique widget style. |

Method Documentation

  1. QCheckBox.__init__ (self, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个复选框与给定parent，但没有文字。

parent到传递QAbstractButton构造函数。

  1. QCheckBox.__init__ (self, QString text, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个复选框与给定parent和text。

parent到传递QAbstractButton构造函数。

  1. Qt.CheckState QCheckBox.checkState (self)

返回复选框的选中状态。如果您不需要三态的支持，您还可以使用QAbstractButton.isChecked（ ）返回一个布尔值。

See also setCheckState（）和Qt.CheckState。

  1. QCheckBox.checkStateSet (self)

从重新实现QAbstractButton.checkStateSet（ ） 。

  1. bool QCheckBox.event (self, QEvent e)

从重新实现QObject.event（ ） 。

  1. bool QCheckBox.hitButton (self, QPoint pos)

从重新实现QAbstractButton.hitButton（ ） 。

  1. QCheckBox.initStyleOption (self, QStyleOptionButton option)

初始化option与其它的值QCheckBox。这种方法对于那些需要子类有用QStyleOptionButton，但不希望在所有的信息填写自己。

See also QStyleOption.initFrom（ ） 。

  1. bool QCheckBox.isTristate (self)
  1. QSize QCheckBox.minimumSizeHint (self)

从重新实现QWidget.minimumSizeHint（ ） 。

此功能被引入Qt的4.8 。

  1. QCheckBox.mouseMoveEvent (self, QMouseEvent)

从重新实现QWidget.mouseMoveEvent（ ） 。

  1. QCheckBox.nextCheckState (self)

从重新实现QAbstractButton.nextCheckState（ ） 。

  1. QCheckBox.paintEvent (self, QPaintEvent)

从重新实现QWidget.paintEvent（ ） 。

  1. QCheckBox.setCheckState (self, Qt.CheckState state)

设置复选框的选中状态，以state。如果您不需要三态的支持，您还可以使用QAbstractButton.setChecked（ ） ，它接受一个布尔值。

See also checkState（）和Qt.CheckState。

  1. QCheckBox.setTristate (self, bool on = True)
  1. QSize QCheckBox.sizeHint (self)

从重新实现QWidget.sizeHint（ ） 。

Qt Signal Documentation

  1. void stateChanged (int)

这是该信号的默认超载。

这个信号被发射时该复选框的状态发生变化，即每当用户选中或取消选中它。

state包含复选框的新Qt.CheckState。