NAME
Tickit::Widget::Choice
- a widget giving a choice from a list
CONSTRUCTOR
new
$choice = Tickit::Widget::Choice->new( %args )
Constructs a new Tickit::Widget::Choice
object.
Takes the following named arguments
- choices => ARRAY
-
Optional. If supplied, should be an ARRAY reference containing two-element ARRAY references. Each will be added to the list of choices as if by a call to
push_choice
for each element in the array. - on_changed => CODE
-
Optional. If supplied, used to set the initial value of the
on_changed
event handler.
ACCESSORS
on_changed
$on_changed = $self->on_changed
set_on_changed
$self->set_on_changed( $on_changed )
Return or set the CODE reference to be called when the chosen selection is changed.
$on_changed->( $choice, $value )
METHODS
push_choice
$choice->push_choice( $value, $caption )
Appends another choice to the list of choices, with the given value and display caption.
chosen_value
$value = $choice->chosen_value
Returns the value of the currently-chosen choice.
choose_by_idx
$choice->choose_by_idx( $idx )
Moves the chosen choice to the one at the given index. If this wasn't the previously-chosen one, invokes the on_changed
event.
choose_by_value
$choice->choose_by_value( $value )
Moves the chosen choise to the one having the given value, if such a choice exists. If this wasn't the previously-chosen one, invokes the on_changed
event.
popup_menu
$choice->popup_menu
Display the popup menu in a modal float until a choice is made.
TODO
Render a full border around the widget if height is at least 3.
AUTHOR
Paul Evans <leonerd@leonerd.org.uk>