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

Checkbox

A labeled boolean input with native focus, hover, and change behavior.

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
checkbox("Include archived", checked: false) { |checked| puts "Archived: #{checked}" }
API

Component properties

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

labelLabel configuration for Checkbox.property
checkedChecked configuration for Checkbox.property
foregroundForeground configuration for Checkbox.property
accentAccent configuration for Checkbox.property
backgroundBackground configuration for Checkbox.property
font_familyFont family configuration for Checkbox.property
font_sizeFont size configuration for Checkbox.property
indicator_sizeIndicator size configuration for Checkbox.property
spacingSpacing configuration for Checkbox.property
cursorCursor configuration for Checkbox.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.

changeNative event payload
hoverNative event payload