dh_Options:
This file provides two separate element classes:
dh_Radio:
A list of options from which the user can only choose one at a time.
dh_Checklist:
A list of options from which the user can choose any, all or none.
See Lokasenna documentation for more detail.
Properties:
opts or
optarray:
Options can be specified as a table of strings using
'opts' or 'optarray', or a comma separated string using 'opts'.
Options are ultimately stored in 'optarray'.
If 'optarray' or 'opts' is not specified, or if 'optarray' is
specified as an empty table (optarray = { } or opts = { })
then 'optarray' will be initialized to {"Option1"}.
If specified as a comma separated string (opts = "Option1,
Option2, Option3") it will be converted to a table and get
stored in 'optarray'.
optindex:
This is an internal property which gets set during
Checklist.onmouseup. It gets set to the index of the last
selected item. Index now available to use in onmouseup override.
This may be useful if you need to see which item was clicked.
This should never be set directly.
dir:
If "v" (default) then options are displayed vertically. If "h" then
options are displayed horizontally.
swap:
If false (default) then option 'bubbles' appear before option title.
border_width:
If greater than 0 then a border will be drawn around the element.
radius:
If greater than 0 then the element will be drawn with rounded corners.
If showing a border then the radius is to the inside of the border.
option_size:
Size of the option 'bubble' (rectangle for checklist
and circle for radio).
pad_x:
Horizontal space between element edge and option bubble.
pad_y:
Vertical space between options.
-------------------------------------------------------
attribute: property_name default value
-------------------------------------------------------
options: opts or optarray {"Option 1"}
direction: dir "v"
swap: swap false
border width: border_width 2
round corners: radius 0
shadow frame: shadow false
caption: caption ""
caption font: font_caption "sans22"
caption position: cap_pos "above"
caption offset x: cap_pad_x 4
caption offset y: cap_pad_y 4
caption centered: cap_centered false
shadow caption: shadow_caption false
option size: opt_size 14
option padding x: pad_x 4
option padding y: pad_y 6
options font: font_text "sans22"
shadow text: shadow_text false
allow sel.outline: allow_sel_outline false
-- colors --
background: col_bg "wnd_bg"
border: col_border "panel_border"
options text: col_text "txt"
caption text: col_cap_text "txt"
elm sel.outline: col_active "elm_active"
backdrop: col_backdrop "wnd_bg"
-------------------------------------------------------