=for comment based on iup-3.5 - http://www.tecgraf.puc-rio.br/iup/en/elem/iupprogressbar.html
=head1 NAME
IUP::ProgressBar - [GUI element] shows a percent value that can be updated to simulate a progression
=head1 DESCRIPTION
Creates a progress bar control. Shows a percent value that can be
updated to simulate a progression.
=begin HTML
<p>
<table border="1">
<tbody align="center">
<tr>
<td></td>
<th>DASHED=NO</th>
<th>DASHED=YES</th>
<th>MARQUEE=YES</th>
</tr>
<tr style="background-color: rgb(173, 177, 194);">
<th style="text-align: center;">Motif</th>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_mot_continuous.png"></td>
<td>(same as DASHED=NO)</td>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_mot_marquee.png"></td>
</tr>
<tr style="background-color: rgb(212, 208, 200);">
<th style="text-align: center;">Windows Classic</th>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_win2k_continuous.png"></td>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_win2k_dash.png"></td>
<td>(same as DASHED)</td>
</tr>
<tr style="background-color: rgb(239, 235, 231);">
<th style="text-align: center;">Windows w/ Styles</th>
<td>(same as DASHED=YES)</td>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_winxp_dash.png"></td>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_winxp_marquee.png"></td>
</tr>
<tr style="background-color: rgb(239, 235, 231);">
<th style="text-align: center;">Windows Vista</th>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_vista_continuous.png"></td>
<td>(same as DASHED=NO)</td>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_vista_marquee.png"></td>
</tr>
<tr style="background-color: rgb(236, 233, 216);">
<th style="text-align: center;">GTK</th>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_gtk_continuous.png"></td>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_gtk_dashed.png"></td>
<td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iupprogressbar_gtk_marquee.png"></td>
</tr>
</tbody>
</table>
</p>
=end HTML
=head1 USAGE
=head2 CREATION - new() method
$progressbar = IUP::ProgressBar->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 L<BGCOLOR|IUP::Manual::03_Attributes/BGCOLOR>
I<[Windows Classic and Motif only]>
Controls the background color. Default: the global attribute DLGBGCOLOR.
=item B<DASHED>
I<(creation only in Windows) [Windows and GTK only]>
Changes the style of the progress bar for a dashed pattern. Default is "NO".
=item L<FGCOLOR|IUP::Manual::03_Attributes/FGCOLOR>
I<[Windows Classic and Motif only]>
Controls the bar color. Default: the global attribute DLGFGCOLOR.
=item B<MARQUEE>
I<(creation)>
Displays an undefined state. Default: NO. You
can set the attribute after map but only to start or stop the
animation.
=item B<MAX>
I<(non inheritable)>
Contains the maximum value. Default is "1".
The control display is not updated, must set VALUE attribute to update.
=item B<MIN>
I<(non inheritable)>
Contains the minimum value. Default is "0".
The control display is not updated, must set VALUE attribute to update.
=item B<ORIENTATION>
I<(creation only)>
Can be "VERTICAL" or "HORIZONTAL".
Default: "HORIZONTAL". Horizontal goes from left to right, and vertical
from bottom to top.
=item L<RASTERSIZE|IUP::Manual::03_Attributes/RASTERSIZE>
The initial size is defined as "200x30". Set to C<undef> to allow the use
of smaller values in the layout computation.
=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<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<SIZE|IUP::Manual::03_Attributes/SIZE>,
L<ZORDER|IUP::Manual::03_Attributes/ZORDER>,
L<VISIBLE|IUP::Manual::03_Attributes/VISIBLE>
=back
=head2 CALLBACKS
The following L<common callbacks|IUP::Manual::04_Callbacks/Common Callbacks> are also accepted:
=over
=item * L<MAP_CB|IUP::Manual::04_Callbacks/MAP_CB>, L<UNMAP_CB|IUP::Manual::04_Callbacks/UNMAP_CB>
=back
=head1 EXAMPLES
The element B<IUP::ProgressBar> is used in the following sample scripts:
=over
=item * L<0-basic/canvas3.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/0-basic/canvas3.pl> - IUP::Canvas example
=item * L<0-basic/layoutdialog.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/0-basic/layoutdialog.pl> - IUP::LayoutDialog example
=item * L<0-basic/progressbar1.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/0-basic/progressbar1.pl> - IUP::Progressbar example
=item * L<0-basic/progressbar2.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/0-basic/progressbar2.pl> - IUP::ProgressBar example
=item * L<0-basic/progressbar3.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/0-basic/progressbar3.pl> - IUP::ProgressBar example
=item * L<1-apps/app-sample1.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/1-apps/app-sample1.pl> - example used for screenshot - IUP.pod
=item * L<1-apps/app-sample2.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/1-apps/app-sample2.pl> - example based on the original sample.c
=item * L<1-apps/app-simple-demo.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/1-apps/app-simple-demo.pl> - example used for screenshot - IUP.pod
=back
The original doc: L<iupprogressbar.html|http://www.tecgraf.puc-rio.br/iup/en/elem/iupprogressbar.html>
=cut