NAME

       HTMLDocument::addLabelledSelect - Adds a labelled selection box

SYNOPSIS

       ElementTree addLabelledSelect( ElementTree block, String labeltext, String name, Int ssize, [Pair<String,
       [SelectOption]> ] optgroups, Bool lazy=false )

ARGUMENTS

       parent The parent element

       labeltext The label for the selector

       name  The  name  of the input. Remember that names starting with "kaya_" may be used by the Kaya standard
       library and should not be used directly by applications.

       ssize The size of the select element. If this is zero, the select element will only allow one  option  to
       be selected at any one time. If this is one or more, the select element will allow multiple options to be
       selected, and suggest to the browser that this many options be displayed simultaneously.

       optgroups The options to select from

       lazy This parameter is optional and defaults to false
        If it is explicitly set to true then the selector will be generated lazily.

DESCRIPTION

       Adds  a  labelled  selection  box  to  a  form.  The  selector  itself  is  identical to that produced by
       HTMLDocument.addSelectElement (3kaya) or HTMLDocument.addLazySelect (3kaya) , depending on the  value  of
       the  lazy  parameter.  Generally,  it is more convenient to use this function to label selectors, than to
       create them individally.

AUTHORS

       Kaya standard  library  by  Edwin  Brady,  Chris  Morris  and  others  (kaya@kayalang.org).  For  further
       information see http://kayalang.org/

LICENSE

       The  Kaya  standard library is free software; you can redistribute it and/or modify it under the terms of
       the GNU Lesser General Public License (version 2.1 or  any  later  version)  as  published  by  the  Free
       Software Foundation.

RELATED

       HTMLDocument.SelectOption (3kaya)
       HTMLDocument.addLazySelect (3kaya)
       HTMLDocument.addOptionList (3kaya)
       HTMLDocument.addSelectElement (3kaya)

Kaya                                                July 2013              HTMLDocument.addLabelledSelect(3kaya)