zui docs v0.0.5
GitHub ↗
Buttons and input Native Qt

Widget Button

Widget Button is a native Zui component in the buttons and input catalog, with 21 component-specific properties.

Usage

Ruby example

Paste this complete Builder example inside the app surface from the Quickstart. Replace illustrative asset paths with files from your project.

Ruby
widget_button("12:42", active: true, tooltip: "Open clock") { puts "Clock opened" }
API

Component properties

21 component-specific values, plus shared item and layout properties.

textText configuration for Widget Button.property
font_familyFont family configuration for Widget Button.property
font_sizeFont size configuration for Widget Button.property
foregroundForeground configuration for Widget Button.property
active_colorActive color configuration for Widget Button.property
activeActive configuration for Widget Button.property
horizontal_marginHorizontal margin configuration for Widget Button.property
vertical_paddingVertical padding configuration for Widget Button.property
fixed_widthFixed width configuration for Widget Button.property
fixed_heightFixed height configuration for Widget Button.property
text_rotationText rotation configuration for Widget Button.property
keep_spaceKeep space configuration for Widget Button.property
dimmedDimmed configuration for Widget Button.property
concealedConcealed configuration for Widget Button.property
interactiveInteractive configuration for Widget Button.property
pressablePressable configuration for Widget Button.property
use_active_colorUse active color configuration for Widget Button.property
maintain_indicator_revealMaintain indicator reveal configuration for Widget Button.property
label_visibleLabel visible configuration for Widget Button.property
has_visual_contentHas visual content configuration for Widget Button.property
tooltipTooltip configuration for Widget Button.property
Show 17 shared item properties
visibleenabledopacityscalerotationzwidthheightfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction

Events

Subscribe with on widget, :event and keep behavior in Ruby.

clickNative event payload
right_clickNative event payload
middle_clickNative event payload
wheelNative event payload