=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