view release on metacpan or  search on metacpan

lib/IUP/List.pod  view on Meta::CPAN

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

=head1 NAME

IUP::List - [GUI element] displays a list of items (listbox, combobox, dropdown)

=head1 DESCRIPTION

Creates an interface element that displays a list of items. The list
can be visible or can be dropped down. It also can have an edit box for
text input. So it is a 4 in 1 element. In native systems the dropped
down case is called Combo Box.

=begin HTML

<p>
  <table border="1">
    <tbody align="center">
      <col style="background-color: rgb(239, 235, 231);" width="530">
      <col style="background-color: rgb(173, 177, 194);" width="530">
      <tr>
        <th>GTK</th>
        <th>Motif</th>
      </tr>
      <tr>
        <td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iuplist_gtk.png"></td>
        <td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iuplist_mot.png"></td>
      </tr>
    </tbody>
  </table>
  <br>
  <table border="1">
    <tbody align="center">
      <col style="background-color: rgb(212, 208, 200);" width="530">
      <col style="background-color: rgb(236, 233, 216);" width="530">
      <tr>
        <th>Windows Classic</th>
        <th>Windows XP Style</th>
      </tr>
      <tr>
        <td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iuplist_win2k.png"></td>
        <td><img src="http://kmx.github.io/perl-iup/img-3.9/elem/iuplist_winxp.png"></td>
      </tr>
    </tbody>
  </table>
</p>

=end HTML

=head1 USAGE

=head2 CREATION - new() method

 $list = IUP::List->new( 1=>"Firts item", 2=>"Second item" );

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: