Script wrapper for QPushButton.

More...

Inherits :

• QObject
  • DzWidget
    • DzButton

Provides a button that can be “pushed” (clicked, pressed, released, etc) in order to execute a command or answer a question.

: ButtonStyle

The styles that the button can be drawn in.

Since:

• 4.6.4.76

• Off - Deprecated See DzCheckBox::tristate and DzCheckBox::checked
• NoChange - Deprecated See DzCheckBox::tristate and DzCheckBox::checked
• On - Deprecated See DzCheckBox::tristate and DzCheckBox::checked
• SingleShot - Deprecated See DzCheckBox::tristate
• Toggle - Deprecated See DzCheckBox::tristate
• Tristate - Deprecated See DzCheckBox::tristate
• BCommand - The button is drawn as a typical Push Button.
• BTool - The button is drawn as a typical Tool Button.
• BDefault - The button is drawn as a Default Push Button.
• BBasic - The button is drawn with the style's Button Bevel.
• BNoFrame - The button is drawn without a frame.
• BCustom - The button is drawn with a custom style.

Boolean : autoDefault

Holds whether or not the button has the auto-default feature and responds to the [Enter] key when it has the focus; true by default for buttons that have a DzDialog parent, otherwise false.

ButtonStyle : buttonStyle

Holds the style that the button is drawn in.

Since:

• 4.6.4.76

Number : buttonTextFormat

Holds the format that the button text is drawn in; DzWidget::AlignmentFlags and DzWidget::TextFlags OR'd together for the button label.

Since:

• 4.6.4.76

Boolean : collapseEmptySpace

Holds whether or not the button will collapse empty space reserved for various parts of the button.

Since:

• 4.11.0.43

Boolean : default

Holds whether or not the button is the default button; false by default.

Boolean : displayDownArrow

Holds whether or not to display the arrow for this button.

Since:

• 4.6.4.76

String : downArrowMetric

Holds the name of the pixel metric used to define the size of the arrow on this button (if any).

Since:

• 4.6.4.76

String : downArrowPrimitive

Holds the name of the primitive element used to draw the arrow on this button (if any).

Since:

• 4.6.4.76

DzWidget::TextElideMode : elideMode

Holds the elide mode to be used for the text on this button.

Since:

• 4.6.4.76

Boolean : flat

Holds whether or not the border is disabled; false by default.

String : iconMetric

Holds the name of the pixel metric used to define the size of the icon on this button (if any).

Since:

• 4.6.4.76

String : minimumWidthText

Holds text used for size hint; if empty current text is used.

Since:

• 4.12.0.75

String : primitive

Holds the name of the primitive element used to draw this button.

Since:

• 4.6.4.76

Boolean : sizedFromIcon

Holds whether or not the button will be sized based on the size of its icon (if any). If true, this overrides iconMetric.

Since:

• 4.11.0.38

String : textStyle

Holds the name of the text style used to draw the label on this button.

Since:

• 4.6.4.76

DzPushButton( DzWidget parent )

Creates a push button as a child of the given parent widget

void : setCheckable( Boolean yesNo )

Sets whether or not the button is a toggle button.

void : setToggleButton( Boolean yesNo )

Deprecated

Exists only to keep old code working. Do not use in new code. Use setCheckable() instead.

void : buttonStyleChanged( ButtonStyle style )

Signature:“buttonStyleChanged(ButtonStyle)”

Emitted when buttonStyle on this button has changed.

Parameter(s):

• style - The new button style.

Since:

• 4.6.4.76

void : buttonTextFormatChanged( Number format )

Signature:“buttonTextFormatChanged(int)”

Emitted when buttonTextFormat on this button has changed.

Parameter(s):

• format - The new text format.

Since:

• 4.6.4.76

void : collapseEmptySpaceChanged( Boolean onOff )

Signature:“collapseEmptySpaceChanged(bool)”

Emitted when collapseEmptySpace on this button has changed.

Parameter(s):

• onOff - The new state.

Since:

• 4.11.0.43

void : displayDownArrowChanged( Boolean displayArrow )

Signature:“displayDownArrowChanged(bool)”

Emitted when displayDownArrow on this button has changed.

Parameter(s):

• displayArrow - The new state.

Since:

• 4.6.4.76

void : downArrowMetricChanged( String name )

Signature:“downArrowMetricChanged(const QString&)”

Emitted when downArrowMetric on this button has changed.

Parameter(s):

• name - The name of the new down arrow metric.

Since:

• 4.6.4.76

void : downArrowPrimitiveChanged( String name )

Signature:“downArrowPrimitiveChanged(const QString&)”

Emitted when downArrowPrimitive on this button has changed.

Parameter(s):

• name - The name of the new primitive.

Since:

• 4.6.4.76

void : elideModeChanged( DzWidget::TextElideMode mode )

Signature:“textStyleChanged(int)”

Emitted when elideMode on this button has changed.

Parameter(s):

• mode - The new elide mode.

Since:

• 4.6.4.76

void : iconMetricChanged( String name )

Signature:“iconMetricChanged(const QString&)”

Emitted when iconMetric on this button has changed.

Parameter(s):

• name - The name of the new icon metric.

Since:

• 4.6.4.76

void : primitiveChanged( String name )

Signature:“primitiveChanged(const QString&)”

Emitted when primitive on this button has changed.

Parameter(s):

• name - The name of the new primitive.

Since:

• 4.6.4.76

void : sizedFromIconChanged( Boolean onOff )

Signature:“sizedFromIconChanged(bool)”

Emitted when sizedFromIcon on this button has changed.

Parameter(s):

• onOff - The new state.

Since:

• 4.11.0.38

void : textStyleChanged( String name )

Signature:“textStyleChanged(const QString&)”

Emitted when textStyle on this button has changed.

Parameter(s):

• name - The name of the new text style.

Since:

• 4.6.4.76