Download
(57 Kb)
Download
Updated: 12-04-16 12:41 PM
Pictures
File Info
Updated:12-04-16 12:41 PM
Created:10-18-11 07:21 PM
Downloads:9,772
Favorites:11
MD5:
LibSimpleWidgets  Popular! (More than 5000 hits)
Version: 1.14.5
by: doxxx [More]
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.

You can find the API documentation here: http://rift.curseforge.com/addons/li...documentation/

You can file bugs and feature requests in my author portal.

TODO list
v1.14.5 (4 December 2016)
- Fix SimpleScrollList mouse scrolling bug.
- Add missing Events header in SimpleWindow docs.

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.

v1.0 (18 October 2011)
- Initial release.
Optional Files (0)


Archived Files (38)
File Name
Version
Size
Author
Date
1.14.4
57kB
doxxx
11-25-15 05:14 PM
1.14.3
55kB
doxxx
05-23-15 07:22 AM
1.14.2
57kB
doxxx
03-02-14 10:15 AM
1.14.1
57kB
doxxx
04-28-13 11:44 AM
1.14
57kB
doxxx
04-27-13 07:12 PM
1.13.4
55kB
doxxx
03-10-13 04:30 PM
1.13.3
55kB
doxxx
02-28-13 05:47 PM
1.13.2
55kB
doxxx
02-12-13 06:39 PM
1.13.1
55kB
doxxx
01-15-13 06:03 PM
1.13
55kB
doxxx
01-12-13 12:04 AM
1.12
50kB
doxxx
12-22-12 10:53 AM
1.11.1
50kB
doxxx
12-18-12 06:07 PM
1.11
50kB
doxxx
12-09-12 07:54 PM
1.10
36kB
doxxx
05-03-12 06:42 PM
1.9.5
29kB
doxxx
04-25-12 07:49 PM
1.9.4
24kB
doxxx
04-21-12 08:43 AM
1.9.3
23kB
doxxx
03-08-12 07:01 PM
1.9.2
23kB
doxxx
03-07-12 07:17 PM
1.9.1
23kB
doxxx
03-06-12 07:12 PM
1.9.0
22kB
doxxx
03-04-12 09:44 AM
1.8.3
22kB
doxxx
02-25-12 12:32 PM
1.8.2
22kB
doxxx
01-29-12 01:17 PM
1.8.1
22kB
doxxx
12-14-11 07:44 PM
1.8
22kB
doxxx
12-11-11 01:30 PM
1.7
17kB
doxxx
12-08-11 09:27 PM
1.6.1
15kB
doxxx
12-06-11 05:32 PM
1.6
15kB
doxxx
12-01-11 09:55 PM
1.5.4
14kB
doxxx
11-30-11 07:04 PM
1.5.3
14kB
doxxx
11-30-11 05:55 PM
1.5.2
15kB
doxxx
11-19-11 05:51 PM
1.5.1
20kB
doxxx
11-16-11 10:51 PM
1.5
20kB
doxxx
11-11-11 04:57 PM
1.4
19kB
doxxx
11-07-11 07:45 PM
1.3.1
18kB
doxxx
11-05-11 08:13 AM
1.3
18kB
doxxx
11-04-11 07:06 PM
1.2
15kB
doxxx
10-25-11 06:10 PM
1.1
6kB
doxxx
10-22-11 12:34 PM
1.0
5kB
doxxx
10-18-11 07:21 PM


Post A Reply Comment Options
Unread 10-18-11, 09:29 PM  
Sunspots
Claw of Regulos
 
Sunspots's Avatar
AddOn Author - Click to view AddOns

Forum posts: 23
File comments: 34
Uploads: 1
I'll have to look into this! It may very well be useful for my settings.
Sunspots is offline Report comment to moderator  
Reply With Quote
Unread 10-19-11, 02:20 AM  
NerfedWar
Zombie
 
NerfedWar's Avatar
AddOn Author - Click to view AddOns

Forum posts: 1
File comments: 45
Uploads: 8
Nice work and saved me a lot of time finishing off my own widget lib. Perfect!
NerfedWar is offline Report comment to moderator  
Reply With Quote
Unread 10-20-11, 01:21 PM  
NerfedWar
Zombie
 
NerfedWar's Avatar
AddOn Author - Click to view AddOns

Forum posts: 1
File comments: 45
Uploads: 8
Quote:
Originally posted by NerfedWar
Nice work and saved me a lot of time finishing off my own widget lib. Perfect!
Managed to get the scroller working with a rifttextfield too, you just need to calculate the actual size each time the contents change (num lines multiplied by font size) and it works fine.
NerfedWar is offline Report comment to moderator  
Reply With Quote
Unread 10-20-11, 02:34 PM  
Sunspots
Claw of Regulos
 
Sunspots's Avatar
AddOn Author - Click to view AddOns

Forum posts: 23
File comments: 34
Uploads: 1
I'm having some layering issues with SimpleSelect but I think this may be due to how layers are handled by Rift...
In my settings window, the dropdown of one SimpleSelect is layered beneath the next SimpleSelect, no matter how I try to layer or set the parents...
Sunspots is offline Report comment to moderator  
Reply With Quote
Unread 10-21-11, 09:11 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Quote:
Originally posted by NerfedWar
Managed to get the scroller working with a rifttextfield too, you just need to calculate the actual size each time the contents change (num lines multiplied by font size) and it works fine.
The scroller should automatically work with frames whose height changes. What's the RiftTextField doing differently?
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 10-21-11, 09:13 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Quote:
Originally posted by Sunspots
I'm having some layering issues with SimpleSelect but I think this may be due to how layers are handled by Rift...
In my settings window, the dropdown of one SimpleSelect is layered beneath the next SimpleSelect, no matter how I try to layer or set the parents...
Interesting. I'll poke around and see if I can figure out what's going on there.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 10-21-11, 09:25 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Quote:
Originally posted by Sunspots
I'm having some layering issues with SimpleSelect but I think this may be due to how layers are handled by Rift...
In my settings window, the dropdown of one SimpleSelect is layered beneath the next SimpleSelect, no matter how I try to layer or set the parents...
I'm not getting inconsistent behaviour...

[Select A]
[Select B]

Select A's layer is set to 2, SelectB's layer is set to 1. Select A's dropdown overlays Select B.

Bear in mind that you should be setting the layer on the Select frame itself, not the current or dropdown child frames. The select frame is a parent frame for the current and dropdown frames, so their layer is relative to its. For example:

Code:
local selectA = UI.CreateFrame("SimpleSelect", "SWT_TestSelect", window:GetContent())
selectA:SetItems({"One", "Two", "Three"})
selectA:SetPoint("TOPLEFT", window:GetContent(), "TOPLEFT")
selectA:SetLayer(2)
local selectB = UI.CreateFrame("SimpleSelect", "SWT_TestSelect", SWT_Window:GetContent())
selectB:SetItems({"Four", "Five", "Six"})
selectB:SetPoint("TOPLEFT", selectA, "BOTTOMLEFT", 0, 5)
selectB:SetLayer(1)
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 10-21-11, 09:29 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Quote:
Originally posted by NerfedWar
Managed to get the scroller working with a rifttextfield too, you just need to calculate the actual size each time the contents change (num lines multiplied by font size) and it works fine.
I think I understand what you mean here. The RiftTextField doesn't automatically re-size its height when you add more lines of text to it. Since the ScrollView only reacts to the content frame's height changes, you need to make the RiftTextField adjust its height when more lines of text are added to it.

I could make that whole combination into a new SimpleTextArea widget.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 10-22-11, 07:49 AM  
NerfedWar
Zombie
 
NerfedWar's Avatar
AddOn Author - Click to view AddOns

Forum posts: 1
File comments: 45
Uploads: 8
Quote:
Originally posted by doxxx
I think I understand what you mean here. The RiftTextField doesn't automatically re-size its height when you add more lines of text to it. Since the ScrollView only reacts to the content frame's height changes, you need to make the RiftTextField adjust its height when more lines of text are added to it.

I could make that whole combination into a new SimpleTextArea widget.
I think that would be a great idea. You'll need to add newline support (ike that RiftTextfield example I posted) as the default does not insert newlines when you press enter. I can then retire the rifttextfield addon which would be cool.
Last edited by NerfedWar : 10-22-11 at 07:50 AM.
NerfedWar is offline Report comment to moderator  
Reply With Quote
Unread 10-22-11, 11:05 AM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Quote:
Originally posted by NerfedWar
I think that would be a great idea. You'll need to add newline support (ike that RiftTextfield example I posted) as the default does not insert newlines when you press enter. I can then retire the rifttextfield addon which would be cool.
Yeah, I was just working on that. I'm copying the newline code from LuaPad, btw.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 10-22-11, 12:46 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Quote:
Originally posted by NerfedWar
I think that would be a great idea. You'll need to add newline support (ike that RiftTextfield example I posted) as the default does not insert newlines when you press enter. I can then retire the rifttextfield addon which would be cool.
I've just uploaded a new version that has added a SimpleTextArea widget, which should be a drop-in replacement for your scrollview+RiftTextfield in LuaPad.
Last edited by doxxx : 10-22-11 at 01:24 PM.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 10-24-11, 12:31 AM  
NerfedWar
Zombie
 
NerfedWar's Avatar
AddOn Author - Click to view AddOns

Forum posts: 1
File comments: 45
Uploads: 8
Quote:
Originally posted by doxxx
I've just uploaded a new version that has added a SimpleTextArea widget, which should be a drop-in replacement for your scrollview+RiftTextfield in LuaPad.
Great work doxxx, your library is proving very useful.
NerfedWar is offline Report comment to moderator  
Reply With Quote
Unread 10-25-11, 06:37 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
I've just uploaded a new version with lots of updates. New widgets and a new Layout function that will automatically create and arrange widgets according to a config table. Documentation has been updated. Please let me know if you have any problems or suggestions.
doxxx is offline Report comment to moderator  
Reply With Quote
Unread 10-26-11, 12:32 PM  
Lildry
Claw of Regulos

Forum posts: 13
File comments: 6
Uploads: 0
New Developer

Reading all the comments about this Lib I know this is a great tool to use. Unfortantly I do not understand how to use it to my advantage. Is this used in game to develope windows, list, menus and all of the other things that it can do? Do I direct to the widget I want to use? Is the widgets a model that I need to edit into my code to function with my add-on? I am intrested in learning to create a drop down menu, if you could give me a little direction that would be great.
Lildry is offline Report comment to moderator  
Reply With Quote
Unread 10-26-11, 01:48 PM  
doxxx
Claw of Regulos
 
doxxx's Avatar
AddOn Author - Click to view AddOns

Forum posts: 11
File comments: 106
Uploads: 1
Re: New Developer

Quote:
Originally posted by Lildry
Reading all the comments about this Lib I know this is a great tool to use. Unfortantly I do not understand how to use it to my advantage. Is this used in game to develope windows, list, menus and all of the other things that it can do? Do I direct to the widget I want to use? Is the widgets a model that I need to edit into my code to function with my add-on? I am intrested in learning to create a drop down menu, if you could give me a little direction that would be great.
I would recommend that you learn about creating Rift addons first. Once you know about Frames and how to create them, you should be able to make use of this library.

There isn't a drop down menu widget in my library yet, but you could probably use my SimpleList widget as a kind of drop down menu.
doxxx is offline Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: