=for comment based on iup-3.5 - http://www.tecgraf.puc-rio.br/iup/en/elem/iupseparator.html

=head1 NAME

IUP::Separator - [GUI element] shows a line between two menu items

=head1 DESCRIPTION

Creates the separator interface element. It shows a line between two
menu items.

=head1 USAGE

=head2 CREATION - new() method

 $separator = IUP::Separator->new();

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()">.

=head1 NOTES

The separator is ignored when it is part of the definition of the items in a bar menu.

=head1 EXAMPLES


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

=over

=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/separator.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/0-basic/separator.pl> - IUP::Separator example

=item * L<0-basic/submenu.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/0-basic/submenu.pl> - IUP::Submenu example

=item * L<1-apps/app-mdi.pl|https://metacpan.org/source/KMX/IUP-0.303/examples/1-apps/app-mdi.pl> - IUP app 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

=back 



=head1 SEE ALSO

L<IUP::Item|IUP::Item>, L<IUP::Submenu|IUP::Submenu>, L<IUP::Menu|IUP::Menu>

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

=cut