Merge pull request #506 from andrewcsmith/patch-2
[supercollider.git] / HelpSource / Classes / EZScroller.schelp
blob1c83d3dc32d27f57ef365c6873d1912ebebe6299
1 class:: EZScroller
2 summary:: Show a subset of items on gui elements
3 categories:: GUI>EZ-GUI
5 description::
6 EZScroller is a vertical slider that allows displaying different subsets of a dynamically changing list of objects on a fixed number of views by scrolling.
8 EZScroller is used JITLib guis like link::Classes/NodeProxyEditor::, link::Classes/ProxyMixer::, link::Classes/TdefAllGui::, and link::Classes/PdefAllGui::.
10 examples::
11 code::
13 w = Window.new("EZScroller test", Rect(100, 400,200, 100)).front;
14 // 5 displays
15 v = { |i| DragBoth.new(w, Rect(0, i * 20, 100, 20)) }.dup(5);
16 // 12 items
17 a = (1..12);
19 e = EZScroller(w, Rect(100,0,14,100), v.size, a.size, { |sc|
20         var startIndex = sc.value.asInteger.postcs;
21         v.do { |drag, i| drag.object_( a[ (startIndex) + i] ? ""); };
22         e.visible_(sc.numItems > sc.maxItems); // hide when not useful
23 });
24 e.doAction;
26 // change list a, update ezscroller
27 a = (1..4); e.numItems_(a.size); e.doAction;
29 a = (1..8); e.numItems_(a.size); e.doAction;