=pod

=head1 NAME

FLTK::ValueSlider - Slider and FloatInput combo widget

=head1 Description

Controls a single floating point value through a combination of a
L<FloatInput|FLTK::FloatInput> and a L<Slider|FLTK::Slider>.

As this is a subclass of L<Slider|FLTK::Slider>, all slider methods work, for
setting the slider size, tick marks, etc.

The user can type a new value into the input area. If
L<< C<step( )>|FLTK::Slider/"step" >> is greater or equal to C<1.0> an
L<IntInput|FLTK::IntInput> is used, this prevents the user from typing
anything other than digits. If L<< C<step( )>|FLTK::Slider/"step" >> is less
than one, the user can type floating point values with decimal points and
exponents.

The user can type B<any> value they want into the text field, I<<< including
ones outside the L<< C<range( )>|/"range" >> or non-multiples of the
L<< C<step( )>|FLTK::Slider/"step" >> >>>. If you want to prevent this, make
the callback function reset the value to a legal one.

By default the callback is done when the user moves the slider, when they use
up/down keys to change the number in the text, or if they edit the text, when
they hit the C<Enter> key or they click on another widget or put the focus on
another widget. Changing L<< C<when( )>|FLTK::Widget/"when" >>
to C<FLTK::WHEN_CHANGED> will make it do the callback on every edit of the
text.

You can get at the input field by using the public "input" instance variable.
For instance you can clobber the text to a word with
C<< $value_input->input->static_text('word') >>. You can also set the size of
it (call L<< C<layout( )>|/"layout" >> first).

=head1 Functions

=head2 C<new>
X<new>

=over

=item C<my $self = $valueslider-E<gt>new( $x, $y, $w, $h, $label );>X<my_self_valueslider_E_gt_new_x_y_w_h_label_>

Creates a new L<FLTK::ValueSlider|FLTK::ValueSlider> widget.

=pod 

=for hackers xs/ValueSlider.xs line 68

=back

=head1 Author

Sanko Robinson <sanko@cpan.org> - http://sankorobinson.com/

=head1 License and Legal

Copyright (C) 2008-2010 by Sanko Robinson <sanko@cpan.org>

This program is free software; you can redistribute it and/or modify it under
the terms of
L<The Artistic License 2.0|http://www.perlfoundation.org/artistic_license_2_0>.
See the F<LICENSE> file included with this distribution or
L<notes on the Artistic License 2.0|http://www.perlfoundation.org/artistic_2_0_notes>
for clarification.

When separated from the distribution, all original POD documentation is
covered by the
L<Creative Commons Attribution-Share Alike 3.0 License|http://creativecommons.org/licenses/by-sa/3.0/us/legalcode>.
See the
L<clarification of the CCA-SA3.0|http://creativecommons.org/licenses/by-sa/3.0/us/>.


=for git $Id: ValueSlider.xs 7483df2 2011-04-09 05:42:22Z sanko@cpan.org $

=cut