dh_Menubox:
Same as Lokasenna Menubox except for:
Changed some property names and default values.
Allows all of the color properties to be overridden.
Frame color, by default, uses highlight/lowlight colors that
are automatically calculated from the 'col_backdrop' color.
However, the frame can be set to use a single color (specified
by the 'col_frame' property) by setting
'frame_use_outline' property to true. Some themes can call for
single color outlines regardless of the 'frame_use_outline' setting.
Added property 'curr_opt' to replace 'retval'. (It does the
same thing, I just find it to be more descriptive).
Changed position where menu pops up.
Properties:
opts or
optarray:
Menubox options can be specified as a table of strings using
'opts' or 'optarray', or a comma separated string using 'opts'.
Menubox 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'. As with gfx.showmenu,
there are a few special symbols that can be added at
the beginning of an option:
# : grayed out
> : this menu item shows a submenu
< : last item in the current submenu
An empty field will appear as a separator in the menu.
curr_opt:
This is the index number of the currently selected option.
If not specified it will be the first option.
--------------------------------------------------------
attribute: property_name default value
--------------------------------------------------------
menu options: opts or optarray {}
selected option: curr_opt 0
no arrow: noarrow false
shadow element: shadow false
caption: caption ""
caption font: font_caption "sans22"
caption position: cap_pos "top"
caption offset x: cap_pad_x 4
caption offset y: cap_pad_y 4
caption centered: cap_centered false
shadow caption: shadow_caption false
text font: font_text "sans22"
text padding: pad 4
text align: align "left"
frame outline: frame_use_outline false
frame thickness: frame_thk 2
allow sel.outline: allow_sel_outline false
-- colors --
box frame: col_frame "elm_frame"
box bg: col_bg "elm_bg"
box text: col_text "elm_txt"
box face: col_face "btn_face"
caption text: col_cap_text "txt"
elm sel.outline: col_active "elm_active"
backdrop: col_backdrop "wnd_bg"
* Set this to the index of the option to be initially selected.
----------------------------------------------------------------------------