LibSimpleWidgets is a library which provides a set of simple widgets not provided by the official Rift API. It integrates into the UI.CreateFrame function, adding several new frame types:
SimpleCheckbox (checkbox with a label)
SimpleGrid (grid of widgets)
SimpleList (list of selectable items, single/multi-select)
SimpleScrollList (same as above, scrollable, handles very large lists, recommended as replacement for SimpleList+SimpleScrollView)
SimpleRadioButton (radio button with a label)
SimpleScrollView (wraps any fixed-height frame)
SimpleSelect (dropdown list)
SimpleSlider (slider with the current value displayed next to it)
SimpleTabView (tabbed frames)
SimpleTextArea (multi-line textfield in scrollview)
SimpleTooltip (mouseover popup frame with text)
SimpleWindow (draggable RiftWindow)
The new frame types inherit all of Frame's functions and add a few more functions specific to each widget.
SimpleRadioButton has a companion function called RadioButtonGroup, which returns a controller object that manages a group of radio buttons to ensure that only one is selected at a time and to generate an event when the selected radio button changes.
The Layout function, given a table describing a widget layout, will create frames and lay them out accordingly. If you've ever used AceConfig and AceGUI, then you'll find this familiar. You can call Layout with the same parent frame and config table to refresh the widgets without creating new frames.
v1.14.4 (25 November 2015)
- Fix calculation of minimum scrollbar thickness for SimpleScrollView.
v1.14.3 (23 May 2015)
- Fix recycling of ScrollList item frame's background frames.
v1.14.2 (2 March 2014)
- Fix calls to original mouse events for tooltip injected frames.
- Fix tooltip RemoveEvents to restore original handlers correctly.
v1.14.1 (28 April 2013)
- Add RemoveAllRows function to Grid.
- Fix Grid SetRows to hide old rows.
- Fix ScrollView's content frame resizing to use SetWidth instead of setting a TOPRIGHT point. This prevents a conflict when a Grid has been put into a ScrollView before rows are added to the Grid.
- Raise Select's dropdown layer to ensure that it's on top of everything else.
- Clarify Grid's SetRows documentation.
- Add simple example for Grid to documentation.
v1.14 (27 April 2013)
- Add SimpleGrid widget.
- Fix SimpleSelect's ResizeToFit to take currently selected item width into account.
- Fix SimpleSelect's dropdown layering.
- Add configuration methods to SimpleTabView for colors.
- Change SimpleSelect widget to use SimpleScrollList for dropdown.
v1.13.4 (10 March 2013)
- Fix index param checking in SimpleScrollList's SetSelectedIndex.
v1.13.3 (28 February 2013)
- Fix enter and tab key detection in SimpleTextArea for Rift 2.2.
- Update required environment to 2.2.
v1.13.2 (12 February 2013)
- Fix index param checking in SimpleList's SetSelectedIndex.
v1.13.1 (15 January 2013)
- Fix clicking on SimpleSelect dropdown items.
- Ensure that ScrollList background frame does not interfere with item background frames.
v1.13 (12 January 2013)
- Added SimpleScrollList widget -- scrollable list (like SimpleList) but optimized to handle very large lists without using lots of Rift frames.
v1.12 (22 December 2012)
- Made Select widget's dropdown items scrollable.
- Fixed default sizing of Select widget.
- Includes v1.11.1 fixes.
v1.11.1 (18 December 2012)
- Fixed Tooltip's event injection to pass events onto original handlers as well.
- Fixed Border:Destroy() so that switching border types work.
v1.11 (9 December 2012)
- Added silent parameter to SimpleSlider's SetRange function.
- Properly remove SimpleCheckbox's SetBackgroundColor function.
- Properly remove SimpleRadioButton's SetBackgroundColor function.
- Added rounded and tooltip border styles. This required a change to the argument list for the SetBorder function.
- Use new tooltip border for Tooltip widget.
- Updated SetBorder function to handle both old-style and new-style argument lists and be able to change existing border to a different type.
- Added documentation for SetBorder function.
- Added labelFontSize config setting for checkboxes in Layout function.
- Added anchor support to the Tooltip widget.
- Added 'editable' setting for slider widgets in Layout function.
- Added parameter checking for all frame types and functions.
- Improved positioning of mouse-anchored tooltip to not go over bottom or right screen edge.
- Updated TOC Environment to 2.0.
v1.10 (3 May 2012)
- SimpleTabView: Made tab font size and colors configurable.
- SimpleTabView: Made tab position configurable.
- SimpleTabView: Fixed positioning of remaining tabs when a tab is removed.
v1.9.5 (25 April 2012)
- Added dropdown arrow button to SimpleSelect.
- Added ItemClick event to SimpleList.
v1.9.4 (21 April 2012)
- Made minimum tab width in SimpleTabView configurable.
- Enforce a minimum scrollbar drag button thickness in SimpleScrollView.
- Fixed SimpleScrollView to correctly update its layout when it's resized.
v1.9.3 (8 March 2012)
- Fixed SimpledSlider's SetEnabled to switch to showing the current view when the widget is disabled, since RiftTextfields can't be disabled.
- Removed SimpleCheckbox's and SimpleRadioButton's SetBackgroundColor function so that the default Frame implementation is used.
- Added Get/SetSelectionBackgroundColor function to SimpleList.
- Fixed SimpleList to retain selected item's background color when changing things like font size.
v1.9.2 (7 March 2012)
- Improved how RadioButtons and RadioButtonGroup interact so that they're independent of event handlers.
- Added SetEnabled function to RadioButtonGroup.
v1.9.1 (6 March 2012)
- Fixed error when trying to get an event handler for a custom event (e.g. RadioButtonChange) which had no handler set yet.
v1.9.0 (4 March 2012)
- Added optional editable textfield to SimpleSlider, controlled by Get/SetEditable.
- Fixed SimpleSlider's SetEnabled to actually enable the slider when true is passed.
- Fixed library's addon short name to be "LSW".
- Added silent parameter to SimpleSlider's SetPosition function to suppress the SliderChange event.
- Added silent parameter to SimpleList's selection-changing functions to suppress the ItemSelect and SelectionChange events.
- Added silent parameter to SimpleSelect's selection-changing functions to suppress the ItemSelect events.
- Added silent parameter to SimpleRadioButton's SetSelected function to suppress the RadioButtonSelect event.
- Added SetSelectedIndex function to SimpleRadioButtonGroup.
v1.8.3 (25 February 2012)
- Removed all usage of deprecated Rift API functions and updated required Environment to 1.7.
- Added ResizeToFit functions for SimpleSelect, SimpleCheckbox, SimpleRadioButton, and SimpleSlider.
- Deprecated ResizeToDefault function on SimpleSelect in favor of ResizeToFit.
- Fixed sizing of SimpleTooltip for multiple lines of automatically wrapped text.
- Fixed SimpleSlider's SetBackgroundColor function.
- Improved SimpleTextArea widget to grab key focus when the scroller background is clicked because the text doesn't fill the scroll area. (Thanks TimeBomb!)
v1.8.2 (29 January 2012)
- Fixed scrollbar visibility not tracking scrollview visibility properly. Thanks Xenyr!
v1.8.1 (14 December 2011)
- Fixed nil error when clicking a radio button in a RadioButtonGroup.
v1.8 (11 December 2011)
- Added SimpleRadioButton frame type and RadioButtonGroup function.
- Added TabSelect event and GetActiveTab function to SimpleTabView.
v1.7 (8 December 2011)
- Added SimpleTabView widget.
- Added item levels support to SimpleList.
- Added RemoveEvents to SimpleTooltip.
- Fixed SetBackgroundColor for SimpleList.
v1.6.1 (6 December 2011)
- Added GetSelectedIndices, GetSelectedItems and GetSelectedValues functions to SimpleList.
- Ensure that we never try to position SimpleScrollView's scrollbar outside of its min/max range.
v1.6 (1 December 2011)
- Added multi-select mode to SimpleList. See API documentation for details.
v1.5.4 (30 November 2011)
- Reverted v1.5.2 change and instead fixed SimpleList and SimpleSelect to clear the current selection when SetItems is called. This doesn't trigger an ItemSelect event.
v1.5.3 (30 November 2011)
- Fixed SimpleList and SimpleSelect to trigger an ItemSelect event when the previously selected index is reselected after the list is updated by SetItems.
v1.5.2 (19 November 2011)
- Use a RiftButton with the 'close' skin for the close button on SimpleWindows.
- Use a RiftScrollbar in SimpleScrollView.
- Added GetFontColor/SetFontColor to SimpleTooltip.
- Added GetFontColor/SetFontColor to SimpleCheckbox.
v1.5.1 (16 November 2011)
- Fixed a bug when SimpleScrollView is given a content frame that already has points or sizes set. (Thanks Matrix)
- Fixed a bug when SimpleScrollView is given a content frame that has a height of 0. (Thanks Matrix)
v1.5 (11 November 2011)
- Updated select widget in Layout function to support new values and index features in SimpleSelect.
- The event handlers created by SimpleTooltip's InjectEvents now call the tooltipTextFunc with the tooltip frame as the first parameter.
- Fixed anchoring of SimpleSlider internal frames.
- Added font size support to SimpleCheckbox, SimpleList, SimpleSelect and SimpleTooltip.
- SimpleSelect no longer automatically sets its own width and height when first created.
- Added ResizeToDefault funciton for SimpleSelect.
v1.4 (7 November 2011)
- Added the ability to associate values with items in SimpleList and SimpleSelect.
- Added the ability to use indices with SimpleList and SimpleSelect.
- SimpleList now triggers ItemSelect event when the selection is cleared.
- Reselecting the same item in SimpleList should not trigger the ItemSelect event.
- Fixed "unknown event" bug in EventProxy when a custom event is cleared by setting to nil.
- Layout function can now be used to update an existing widget layout.
- Added spacer type to Layout function.
v1.3.1 (5 November 2011)
- Fixed SetKeyFocus function for SimpleTextArea.
v1.3 (4 November 2011)
- Fix MouseIn/MouseOut/MouseMove events for SimpleCheckbox.
- Don't fire ItemSelect event in SimpleSelect if item is already selected.
- Fixed resizing of underlying textfield as text is changed in SimpleTextArea.
- Fixed SimpleWindow dragging to work when window is initially anchored.
- Improved close button for SimpleWindow.
- Added GetKeyFocus/SetKeyFocus to SimpleTextArea.
- Added missing SetBorder and SetBackgroundColor functions to for SimpleCheckbox, SimpleList and SimpleTextArea.
- Added GetEnabled/SetEnabled functions for SimpleCheckbox, SimpleList, SimpleSelect, SimpleSlider and SimpleTextArea.
- Added Close event to SimpleWindow.
- Added SimpleTooltip widget.
- Added tooltipText setting to config table for Layout function.
v1.2 (25 October 2011)
- Added optional close button to SimpleWindow.
- Added SetBackgroundColor function SimpleSelect.
- Fixed double ItemSelected notification in SimpleList.
- Improved technique used by SetBorder for adding the border. Works with translucent frames now.
- Added SimpleCheckbox widget.
- Added SimpleSlider widget.
- Added Layout function for arrange a set of widgets according to a config table.
- Added EventProxy function which creates a replacement Event table for a frame which contains custom events but can also use the events from the frame's original Event table. This has replaced the Register*Handler functions.
- Added events for various widgets.
v1.1 (22 October 2011)
- Added SimpleTextArea widget.