QAbstractButton ¶

QAbstractButton class is the abstract base class of button widgets, providing functionality common to buttons. 更多 …

继承者： QCheckBox , QCommandLinkButton , QPushButton , QRadioButton , QToolButton

概要 ¶

函数 ¶

def autoExclusive ()
def autoRepeat ()
def autoRepeatDelay ()
def autoRepeatInterval ()
def group ()
def icon ()
def iconSize ()
def isCheckable ()
def isChecked ()
def isDown ()
def setAutoExclusive (arg__1)
def setAutoRepeat (arg__1)
def setAutoRepeatDelay (arg__1)
def setAutoRepeatInterval (arg__1)
def setCheckable (arg__1)
def setDown (arg__1)
def setIcon (icon)
def setShortcut (key)
def setText (text)
def shortcut ()
def text ()

虚函数 ¶

def checkStateSet ()
def hitButton (pos)
def nextCheckState ()

槽 ¶

def animateClick ([msec=100])
def click ()
def setChecked (arg__1)
def setIconSize (size)
def toggle ()

信号 ¶

def clicked ([checked=false])
def pressed ()
def released ()
def toggled (checked)

详细描述 ¶

此类实现 abstract 按钮。此类的子类处理用户动作，并指定如何绘制按钮。

QAbstractButton provides support for both push buttons and checkable (toggle) buttons. Checkable buttons are implemented in the QRadioButton and QCheckBox 类。按钮的实现在 QPushButton and QToolButton 类；这些还提供触发行为若要求的话。

任何按钮都可以显示包含文本和图标的标签。 setText() sets the text; setIcon() sets the icon. If a button is disabled, its label is changed to give the button a “disabled” appearance.

If the button is a text button with a string containing an ampersand (‘&’), QAbstractButton automatically creates a shortcut key. For example:
button = QPushButton(QObject.tr("Ro&ck && Roll"), self)
											
The Alt+C shortcut is assigned to the button, i.e., when the user presses Alt+C the button will call animateClick() 。见 QShortcut documentation for details. To display an actual ampersand, use ‘&&’.

还可以设置自定义快捷键使用 setShortcut() function. This is useful mostly for buttons that do not have any text, and therefore can’t have any automatic shortcut.
button.setIcon(QIcon(":/images/print.png"))
button.setShortcut(tr("Alt+F7"))
											
由 Qt 提供的所有按钮 ( QPushButton , QToolButton , QCheckBox ，和 QRadioButton ) 均可以显示 text and icons .

可以把按钮设为对话框默认按钮通过 setDefault() and setAutoDefault() .

QAbstractButton provides most of the states used for buttons:

isDown() indicates whether the button is pressed down.

isChecked() indicates whether the button is checked 。只有可复选按钮可以被复选或取消复选 (见下文)。

isEnabled() indicates whether the button can be pressed by the user.

注意

As opposed to other widgets, buttons derived from QAbstractButton accept mouse and context menu events when disabled.

setAutoRepeat() sets whether the button will auto-repeat if the user holds it down. autoRepeatDelay and autoRepeatInterval 定义自动重复如何做。

setCheckable() sets whether the button is a toggle button or not.

差异在 isDown() and isChecked() is as follows. When the user clicks a toggle button to check it, the button is first pressed 然后释放到 checked 状态。当用户再次点击它 (以取消复选) 时，按钮先被移到 pressed 状态，然后到 unchecked 状态 ( isChecked() and isDown() are both false).

QAbstractButton provides four signals:

pressed() is emitted when the left mouse button is pressed while the mouse cursor is inside the button.

released() is emitted when the left mouse button is released.

clicked() is emitted when the button is first pressed and then released, when the shortcut key is typed, or when click() or animateClick() 被调用。

toggled() is emitted when the state of a toggle button changes.

To subclass QAbstractButton , you must reimplement at least paintEvent() to draw the button’s outline and its text or pixmap. It is generally advisable to reimplement sizeHint() as well, and sometimes hitButton() (to determine whether a button press is within the button). For buttons with more than two states (like tri-state buttons), you will also have to reimplement checkStateSet() and nextCheckState() .

另请参阅

QButtonGroup

class QAbstractButton ( [ parent=None ] ) ¶

param parent

QWidget

Constructs an abstract button with a parent .

PySide2.QtWidgets.QAbstractButton. animateClick ( [ msec=100 ] ) ¶

参数: msec – int

Performs an animated click: the button is pressed immediately, and released msec milliseconds later (the default is 100 ms).

Calling this function again before the button is released resets the release timer.

All signals associated with a click are emitted as appropriate.

This function does nothing if the button is PySide2.QtWidgets.QWidget.setEnabled()

另请参阅

click()

PySide2.QtWidgets.QAbstractButton. autoExclusive ( ) ¶

返回类型: bool

另请参阅

setAutoExclusive()

PySide2.QtWidgets.QAbstractButton. autoRepeat ( ) ¶

返回类型: bool

另请参阅

setAutoRepeat()

PySide2.QtWidgets.QAbstractButton. autoRepeatDelay ( ) ¶

返回类型: int

另请参阅

setAutoRepeatDelay()

PySide2.QtWidgets.QAbstractButton. autoRepeatInterval ( ) ¶

返回类型: int

另请参阅

setAutoRepeatInterval()

PySide2.QtWidgets.QAbstractButton. checkStateSet ( ) ¶: This virtual handler is called when setChecked() is used, unless it is called from within nextCheckState() . It allows subclasses to reset their intermediate button states.

另请参阅

nextCheckState()

PySide2.QtWidgets.QAbstractButton. click ( ) ¶

履行点击。

All the usual signals associated with a click are emitted as appropriate. If the button is checkable, the state of the button is toggled.

This function does nothing if the button is PySide2.QtWidgets.QWidget.setEnabled()

另请参阅

animateClick()

PySide2.QtWidgets.QAbstractButton. clicked ( [ checked=false ] ) ¶

参数: checked – bool

PySide2.QtWidgets.QAbstractButton. group ( ) ¶

返回类型: QButtonGroup

Returns the group that this button belongs to.

If the button is not a member of any QButtonGroup ，此函数返回 None .

另请参阅

QButtonGroup

PySide2.QtWidgets.QAbstractButton. hitButton ( pos ) ¶

参数: pos – QPoint
返回类型: bool

返回 true if pos is inside the clickable button rectangle; otherwise returns false .

By default, the clickable area is the entire widget. Subclasses may reimplement this function to provide support for clickable areas of different shapes and sizes.

PySide2.QtWidgets.QAbstractButton. icon ( ) ¶

返回类型: QIcon

另请参阅

setIcon()

PySide2.QtWidgets.QAbstractButton. iconSize ( ) ¶

返回类型: QSize

另请参阅

setIconSize()

PySide2.QtWidgets.QAbstractButton. isCheckable ( ) ¶

返回类型: bool

PySide2.QtWidgets.QAbstractButton. isChecked ( ) ¶

返回类型: bool

PySide2.QtWidgets.QAbstractButton. isDown ( ) ¶

返回类型: bool

PySide2.QtWidgets.QAbstractButton. nextCheckState ( ) ¶: This virtual handler is called when a button is clicked. The default implementation calls setChecked (! isChecked() ) if the button isCheckable() . It allows subclasses to implement intermediate button states.

另请参阅

checkStateSet()