Buttons and input
Native Qt
Button
Zui's primary native action control with icons, tooltips, hover state, URLs, and click events.
Usage
Ruby example
Paste this complete Builder example inside the app surface from the Quickstart. Replace illustrative asset paths with files from your project.
button("Deploy", icon: :play, accent: "#b7ff5a") { puts "Deploy requested" }
API
Component properties
23 component-specific values, plus shared item and layout properties.
textText configuration for Button.propertyurlUrl configuration for Button.propertyiconIcon configuration for Button.propertytooltipTooltip configuration for Button.propertyselectedSelected configuration for Button.propertyactiveActive configuration for Button.propertycursorCursor configuration for Button.propertyfocusableFocusable configuration for Button.propertyborderedBordered configuration for Button.propertyforegroundForeground configuration for Button.propertybackgroundBackground configuration for Button.propertyaccentAccent configuration for Button.propertyfont_familyFont family configuration for Button.propertyfont_sizeFont size configuration for Button.propertyicon_sizeIcon size configuration for Button.propertyicon_rotationIcon rotation configuration for Button.propertyicon_spinningIcon spinning configuration for Button.propertyhorizontal_paddingHorizontal padding configuration for Button.propertyvertical_paddingVertical padding configuration for Button.propertyleft_alignLeft align configuration for Button.propertytooltip_backgroundTooltip background configuration for Button.propertytooltip_foregroundTooltip foreground configuration for Button.propertytooltip_borderTooltip border configuration for Button.propertyShow 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↗
openNative event payload↗
errorNative event payload↗
right_clickNative event payload↗
hoverNative event payload