311 lines
5.5 KiB
Text
311 lines
5.5 KiB
Text
CLASS:: FlowView
|
|
summary:: CompositeView with a FlowLayout as decorator
|
|
categories:: GUI>Views
|
|
related:: Classes/FlowLayout, Classes/CompositeView
|
|
|
|
DESCRIPTION::
|
|
In the simplest respect this is a lazy contraction of this:
|
|
code::
|
|
w = GUI.window.new;
|
|
w.view.decorator = FlowLayout.new(w.bounds);
|
|
w.front;
|
|
::
|
|
|
|
link::Classes/FlowView:: add some features to this setup.
|
|
code::
|
|
(
|
|
f = FlowView.new;
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
|
|
// the StartRow will be fixed at this point in the children array
|
|
f.startRow;
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
f.startRow;
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
)
|
|
::
|
|
|
|
|
|
CLASSMETHODS::
|
|
|
|
METHOD:: new
|
|
|
|
argument:: parent
|
|
Parent widget.
|
|
|
|
argument:: bounds
|
|
An instance of link::Classes/Rect::, or a link::Classes/Point:: indicating width@height.
|
|
|
|
argument:: margin
|
|
...
|
|
argument:: gap
|
|
...
|
|
argument:: windowTitle
|
|
Title of the window.
|
|
|
|
|
|
INSTANCEMETHODS::
|
|
|
|
METHOD:: startRow
|
|
Start a new row.
|
|
|
|
METHOD:: indentedRemaining
|
|
The maximum space that is left, starting at the current cursor position.
|
|
code::
|
|
(
|
|
f = FlowView.new;
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
|
|
GUI.slider.new(f, f.indentedRemaining)
|
|
.background = Color.blue(alpha:0.2)
|
|
)
|
|
|
|
(
|
|
f = FlowView.new;
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
|
|
f.startRow; // new row
|
|
|
|
GUI.slider.new(f, f.indentedRemaining)
|
|
.background = Color.blue(alpha:0.2)
|
|
)
|
|
|
|
(
|
|
f = FlowView.new;
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
|
|
GUI.slider.new(f, f.indentedRemaining)
|
|
.background = Color.blue(alpha:0.2)
|
|
)
|
|
::
|
|
|
|
METHOD:: used
|
|
The area used so far, rounded up to the nearest rectangle plus margin.
|
|
code::
|
|
(
|
|
w = GUI.window.new;
|
|
w.front;
|
|
f = FlowView.new(w);
|
|
f.background = Color.blue(alpha:0.1);
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
|
|
f.used.postln;
|
|
|
|
// overlaid
|
|
GUI.compositeView.new(w,f.used)
|
|
.background = Color.red(alpha: 0.1);
|
|
)
|
|
|
|
(
|
|
w = GUI.window.new;
|
|
w.front;
|
|
f = FlowView.new(w);
|
|
f.background = Color.blue(alpha:0.1);
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
|
|
f.startRow; // new row
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
|
|
f.used.postln;
|
|
|
|
// overlaid
|
|
GUI.compositeView.new(w,f.used)
|
|
.background = Color.red(alpha: 0.1);
|
|
)
|
|
::
|
|
|
|
METHOD:: flow
|
|
Insert a sub flow view into the current view.
|
|
code::
|
|
(
|
|
f = FlowView.new;
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
|
|
// flow within a flow
|
|
g = f.flow({ arg g;
|
|
ActionButton(g,"a");
|
|
GUI.slider.new(g,Rect(0,0,100,100)).background_(Color.rand);
|
|
}).background_(Color.black); // shrinks to fit the contents afterwards
|
|
)
|
|
::
|
|
|
|
argument:: func
|
|
(describe argument here)
|
|
|
|
argument:: bounds
|
|
(describe argument here)
|
|
|
|
METHOD:: comp
|
|
Insert a sub composite view into the current view.
|
|
code::
|
|
(
|
|
f = FlowView.new;
|
|
|
|
GUI.slider.new(f, Rect(0,0,100,100));
|
|
|
|
// SuperCollider composite view
|
|
g = f.comp({ arg g;
|
|
GUI.slider.new(g, Rect(50,30,50,100)).background_(Color.rand);
|
|
GUI.slider.new(g, Rect(120,30,50,100)).background_(Color.rand);
|
|
},Rect(0, 0, 200, 200)).background_(Color.black);
|
|
|
|
f.startRow;
|
|
"Back to flowing".gui(f);
|
|
)
|
|
::
|
|
|
|
argument:: func
|
|
(describe argument here)
|
|
|
|
argument:: bounds
|
|
(describe argument here)
|
|
|
|
|
|
EXAMPLES::
|
|
|
|
code::
|
|
// note: some of the following examples use ActionButton from the crucialib
|
|
|
|
// tests
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
// b = ActionButton(f,"hi",minWidth:140)
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
b = ActionButton(f,"hi",minWidth:140);
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
b = GUI.slider.new(f,Rect(0,0,100,100));
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
g = f;
|
|
f.flow({ arg f;
|
|
//b = ActionButton(f,"hi",minWidth:140)
|
|
}).background_(Color.white)
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
g = f;
|
|
f.flow({ arg f;
|
|
b = ActionButton(f,"hi",minWidth:140)
|
|
}).background_(Color.white)
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
g = f;
|
|
f.flow({ arg f;
|
|
f.flow({ arg f;
|
|
ActionButton(f,"hello",minWidth:100);
|
|
}).background_(Color.blue);
|
|
b = ActionButton(f,"hi",minWidth:140);
|
|
}).background_(Color.white)
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
g = f;
|
|
f.flow({ arg f;
|
|
f.flow({ arg f;
|
|
ActionButton(f,"hello",minWidth:100);
|
|
}).background_(Color.blue);
|
|
b = ActionButton(f,"hi",minWidth:140);
|
|
}).background_(Color.white)
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
g = f;
|
|
f.flow({ arg f;
|
|
b = ActionButton(f,"hi",minWidth:140);
|
|
f.flow({ arg f;
|
|
ActionButton(f,"hello",minWidth:100);
|
|
}).background_(Color.blue);
|
|
}).background_(Color.white)
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
g = f;
|
|
f.flow({ arg f;
|
|
b = GUI.slider.new(f,Rect(0,0,140,20));
|
|
f.flow({ arg f;
|
|
ActionButton(f,"hello",minWidth:100);
|
|
}).background_(Color.blue);
|
|
}).background_(Color.white)
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
|
|
(
|
|
FlowView.new.flow({ arg f;
|
|
b = GUI.slider.new(f,Rect(0,0,140,20));
|
|
f.flow({ arg f;
|
|
ActionButton(f,"hello",minWidth:100);
|
|
}).background_(Color.blue);
|
|
}).background_(Color.grey)
|
|
)
|
|
|
|
|
|
(
|
|
a = FlowView.new.flow({ arg f;
|
|
g = f;
|
|
w = f.flow({ arg f;
|
|
b = f.flow({ arg f;
|
|
ActionButton(f,"hello",minWidth:100);
|
|
}).background_(Color.blue);
|
|
ActionButton(f,"hi",minWidth:140);
|
|
}).background_(Color.white)
|
|
}).background_(Color.grey)
|
|
|
|
)
|
|
|
|
b.remove(true);
|
|
w.resizeToFit(true,true);
|
|
|
|
|
|
// add something big back in
|
|
ActionButton(w,"i'm back",minWidth: 200);
|
|
w.resizeToFit(true,true);
|
|
// slightly wrong size at the bottom
|
|
::
|