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)