CarpenterCheckbox class final
Controlled selection control with unchecked, checked, and mixed presentation.
A mixed value represents partial selection. Activation changes mixed or unchecked to checked, and checked to unchecked; it does not cycle through all three states.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatelessWidget
- CarpenterCheckbox
Constructors
-
CarpenterCheckbox({Key? key, required CheckboxValue value, required String label, ValueChanged<
CheckboxValue> ? onChanged, String? description, String? semanticLabel, ControlSize size = ControlSize.medium, SelectionColorRole colorRole = SelectionColorRole.primary, FocusNode? focusNode, bool autofocus = false}) -
Creates a checkbox with externally owned
value. OmitonChangedto disable interaction.const
Properties
- autofocus → bool
-
Whether the control requests focus when first attached. Defaults to
false.
final
- colorRole → SelectionColorRole
-
Semantic action or selection color resolved from the current Carpenter
theme.
final
- description → String?
-
Optional supporting text explaining the choice without replacing its
accessible name.
final
- focusNode → FocusNode?
-
Optional caller-owned focus node. Dispose a supplied node in its owner,
not in the widget.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- label → String
-
Visible text naming the control or choice; keep it meaningful without
relying on an icon.
final
-
onChanged
→ ValueChanged<
CheckboxValue> ? -
Receives the next selection value on activation. Rebuild with that value
to commit it; null disables the control.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- semanticLabel → String?
-
Accessible name supplied to assistive technology. When omitted, the
visible label is used.
final
- size → ControlSize
-
Semantic control size, resolving coordinated height, spacing, icon, and
typography metrics.
final
- value → CheckboxValue
-
Current tri-state selection. Mixed is supplied by the owner, not reached
by ordinary toggling.
final
Methods
-
build(
BuildContext context) → Widget -
Describes the part of the user interface represented by this widget.
override
-
createElement(
) → StatelessElement -
Creates a StatelessElement to manage this widget's location in the tree.
inherited
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of DiagnosticsNode objects describing this node's
children.
inherited
-
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toDiagnosticsNode(
{String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode -
Returns a debug representation of the object that is used by debugging
tools and by DiagnosticsNode.toStringDeep.
inherited
-
toString(
{DiagnosticLevel minLevel = DiagnosticLevel.info}) → String -
A string representation of this object.
inherited
-
toStringDeep(
{String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String -
Returns a string representation of this node and its descendants.
inherited
-
toStringShallow(
{String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a one-line detailed description of the object.
inherited
-
toStringShort(
) → String -
A short, textual description of this widget.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited