=for comment based on iup-3.9 - http://www.tecgraf.puc-rio.br/iup/en/ctrl/iupgauge.html

=head1 NAME

IUP::Gauge - [GUI element] shows a percent value that can be updated to simulate a progression

=head1 DESCRIPTION

Creates a Gauge control. Shows a percent value that can be updated to
simulate a progression. It inherits from L<IUP::Canvas|IUP::Canvas>.

It is recommended that new applications use the
L<IUP::ProgressBar|IUP::ProgressBar> control.

=begin HTML

<p><img src="http://kmx.github.io/perl-iup/img-3.9/ctrl/iupgauge.png"></p>

=end HTML

=head1 USAGE

=head2 CREATION - new() method

 $gauge = IUP::Gauge->new( MIN=>0, MAX=>100 );

B<Returns:> the identifier of the created element, or C<undef> if an error occurs.

NOTE: You can pass to C<new()> other C<ATTRIBUTE=E<gt>'value'> or C<CALLBACKNAME=E<gt>\&func> pairs relevant
to this element - see L<IUP::Manual::02_Elements|IUP::Manual::02_Elements/"new()">.

=head2 ATTRIBUTES

For more info about concept of attributes (setting/getting values etc.)
see L<IUP::Manual::03_Attributes|IUP::Manual::03_Attributes>. Attributes specific to this element:

=over

=item B<DASHED>

Changes the style of the gauge for a dashed pattern. Default is "NO".

=item L<FGCOLOR|IUP::Manual::03_Attributes/FGCOLOR>

Controls the gauge and text color. The default is "64 96 192".

=item B<MAX>

I<(non inheritable)> Contains the maximum value. Default is "1".

=item B<MIN>

I<(non inheritable)> Contains the minimum value. Default is "0".

=item B<PADDING>

internal margin. Works just like the MARGIN attribute of
the L<IUP::Hbox|IUP::Hbox> and L<IUP::Vbox|IUP::Vbox> containers, but uses a different name to
avoid inheritance problems. Default value: "0x0". 

=item B<SHOW_TEXT>

Indicates if the text inside the Gauge is to be shown or
not. If the gauge is dashed the text is never shown. Possible values:
"YES" or "NO". Default: "YES".

=item L<SIZE|IUP::Manual::03_Attributes/SIZE>

I<(non inheritable)> The initial size is "120x14".
Set to C<undef> to allow the automatic layout use smaller values.

=item B<TEXT>

I<(non inheritable)> Contains a text to be shown inside the Gauge
when SHOW_TEXT=YES. If it is C<undef>, the percentage calculated from VALUE
will be used. If the gauge is dashed the text is never shown.

=item B<VALUE>

I<(non inheritable)> Contains a number between "MIN" and "MAX",
controlling the current position.

=back

The following L<common attributes|IUP::Manual::03_Attributes/Common Attributes> are also accepted:

=over

=item * L<ACTIVE|IUP::Manual::03_Attributes/ACTIVE>,
L<BGCOLOR|IUP::Manual::03_Attributes/BGCOLOR>,
L<EXPAND|IUP::Manual::03_Attributes/EXPAND>,
L<FONT|IUP::Manual::03_Attributes/FONT>,
L<SCREENPOSITION|IUP::Manual::03_Attributes/SCREENPOSITION>,
L<POSITION|IUP::Manual::03_Attributes/POSITION>,
L<MINSIZE|IUP::Manual::03_Attributes/MINSIZE>,
L<MAXSIZE|IUP::Manual::03_Attributes/MAXSIZE>,
L<WID|IUP::Manual::03_Attributes/WID>,
L<TIP|IUP::Manual::03_Attributes/TIP>,
L<RASTERSIZE|IUP::Manual::03_Attributes/RASTERSIZE>,
L<ZORDER|IUP::Manual::03_Attributes/ZORDER>,
L<VISIBLE|IUP::Manual::03_Attributes/VISIBLE>

=back

=head2 CALLBACKS

For more info about concept of callbacks (setting callback handlers etc.)
see L<IUP::Manual::04_Callbacks|IUP::Manual::04_Callbacks>. Callbacks specific to this element:

common callbacks are supported: L<MAP_CB|IUP::Manual::03_Attributes/MAP_CB>, L<UNMAP_CB|IUP::Manual::03_Attributes/UNMAP_CB>
  
=head1 EXAMPLES


The element B<IUP::Gauge> is used in the following sample scripts:

=over

=item * L<0-basic/gauge.pl|https://metacpan.org/source/KMX/IUP-0.305/examples/0-basic/gauge.pl> - IUP::Gauge example

=back 



=head1 SEE ALSO

L<IUP::Canvas|IUP::Canvas>

The original doc: L<iupgauge.html|http://www.tecgraf.puc-rio.br/iup/en/ctrl/iupgauge.html>
 

=cut