CNPullDownButton class
A Cupertino-native pull-down button.
Pull-down buttons display a menu of items or actions that directly relate to the button's purpose. The menu appears below the button when tapped.
On iOS/macOS this uses native UIButton with UIMenu for authentic behavior.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatefulWidget
- CNPullDownButton
Constructors
-
CNPullDownButton({Key? key, required String? buttonLabel, required List<
CNPullDownMenuEntry> items, required ValueChanged<int> onSelected, ValueChanged<int> ? onInlineActionSelected, Color? tint, double height = 32.0, bool shrinkWrap = false, CNButtonStyle buttonStyle = CNButtonStyle.plain, }) -
Creates a text-labeled pull-down button.
const
-
CNPullDownButton.icon({Key? key, required CNSymbol? buttonIcon, required List<
CNPullDownMenuEntry> items, required ValueChanged<int> onSelected, ValueChanged<int> ? onInlineActionSelected, Color? tint, double size = 44.0, CNButtonStyle buttonStyle = CNButtonStyle.glass, }) -
Creates a round, icon-only pull-down button.
const
Properties
-
Icon for the button (non-null in icon mode).
final
-
Text for the button (null when using buttonIcon).
final
-
Visual style to apply to the button.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- height → double
-
Control height; icon mode uses diameter semantics.
final
- isIconButton → bool
-
Whether this instance is configured as an icon button variant.
no setter
-
items
→ List<
CNPullDownMenuEntry> -
Entries that populate the pull-down menu.
final
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
-
Optional title for the menu.
final
-
onInlineActionSelected
→ ValueChanged<
int> ? -
Called with the selected index when an inline action is tapped.
final
-
onSelected
→ ValueChanged<
int> -
Called with the selected index when the user makes a selection.
final
- round → bool
-
Whether this is the round icon variant.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- shrinkWrap → bool
-
If true, sizes the control to its intrinsic width.
final
- tint → Color?
-
Tint color for the control.
final
- width → double?
-
Fixed width in icon mode; otherwise computed/intrinsic.
final
Methods
-
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree.
inherited
-
createState(
) → State< CNPullDownButton> -
Creates the mutable state for this widget at a given location in the tree.
override
-
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