207 lines
6.6 KiB
Text
207 lines
6.6 KiB
Text
class:: EZPopUpMenu
|
|
summary:: A wrapper class for a label plus a popUpMenu with per item actions
|
|
categories:: GUI>EZ-GUI
|
|
related:: Classes/PopUpMenu
|
|
|
|
description::
|
|
EZPopUpMenu is wrapper class which creates an (optional) label and a popUpMenu. It includes per item actions as well as a global action which are both evaluated upon selection of an item. Convenience methods for inserting and deleting menu items are also included . If the parent is nil, then EZPopUpMenu will create its own window.See link::Classes/EZGui:: and link::Classes/EZLists:: for all of the options.
|
|
|
|
subsection:: Some Important Issues Regarding EZPopUpMenu
|
|
The convenience methods for EZPopUpMenu require that the items array is an array of associations of labels and functions, not like in link::Classes/PopUpMenu::, where items is simply an array of strings. If code::label:: is code::nil::, then no staticText is created.
|
|
|
|
classmethods::
|
|
method:: new
|
|
|
|
argument:: parentView
|
|
The parent view or window. If the parent is nil, then EZPopUpMenu will create its own link::Classes/Window::, and place it conveniently on the screen if the bounds are a link::Classes/Point::. If the bounds are a link::Classes/Rect::, then the link::Classes/Rect:: determines the window bounds.
|
|
|
|
argument:: bounds
|
|
An instance of link::Classes/Rect:: or link::Classes/Point::. Default value is code::160@22::.
|
|
|
|
argument:: label
|
|
The label. Default value is code::nil::. If code::nil::, then no link::Classes/StaticText:: is created.
|
|
|
|
argument:: items
|
|
Default value is code::nil::. An link::Classes/Array:: of link::Classes/Association::s code:: ['label' -> { arg menuObj; value }, ] ::. Or and link::Classes/Array:: link::Classes/Symbol::s (if you are only using code::globalAction::).
|
|
|
|
argument:: globalAction
|
|
A global function to be performed in addition to the item functions code:: { arg menuObj; value } ::.
|
|
|
|
argument:: initVal
|
|
Initial value of the menu, i.e. the index selected. Default value is 0.
|
|
|
|
argument:: initAction
|
|
An instance of link::Classes/Boolean::. Performs the action at code::initVal:: on creation of the menu, plus the code::globalAction::. Default value is code::false::.
|
|
|
|
argument:: labelWidth
|
|
Default value is 80.
|
|
|
|
argument:: labelHeight
|
|
Default value is 20. Not used if layout is code::\horz::.
|
|
|
|
argument:: layout
|
|
code::\vert:: or code::\horz::. default is code::\horz::.
|
|
|
|
argument:: gap
|
|
A link::Classes/Point::. By default, the view tries to get its parent's code::gap::, otherwise it defaults to code::2@2::. Setting it overrides these.
|
|
|
|
argument:: margin
|
|
A link::Classes/Point::. This will inset the bounds occupied by the subviews of view.
|
|
|
|
discussion::
|
|
code::
|
|
(
|
|
w = Window.new.front;
|
|
w.view.decorator = FlowLayout(w.view.bounds);
|
|
g = EZPopUpMenu.new(
|
|
w,
|
|
230@22,
|
|
"A PopUpMenu: ",
|
|
[
|
|
\item0 ->{|a| ("this is item 0 of " ++ a).postln},
|
|
\item1 ->{|a| ("this is item 1 of " ++ a).postln},
|
|
\item2 ->{|a| ("this is item 2 of " ++ a).postln},
|
|
],
|
|
globalAction: {|a| ("this is a global action of "++a.asString ).postln},
|
|
initVal: 1,
|
|
initAction: true,
|
|
labelWidth: 120,
|
|
labelHeight: 20,
|
|
layout: \horz,
|
|
gap: 2@2
|
|
);
|
|
)
|
|
|
|
// or a more simple syntax:
|
|
(
|
|
w = Window.new.front;
|
|
w.view.decorator = FlowLayout(w.view.bounds);
|
|
g = EZPopUpMenu.new(w, 200@22, "Menu: ");
|
|
g.addItem(\item0, { |a| ("this is item 0 of " ++ a).postln });
|
|
g.addItem(\item1, { |a| ("this is item 1 of " ++ a).postln });
|
|
g.addItem(\item2, { |a| ("this is item 2 of " ++ a).postln });
|
|
g.value = 0;
|
|
)
|
|
::
|
|
|
|
instancemethods::
|
|
|
|
subsection:: Changing Appearance
|
|
|
|
method:: setColors
|
|
argument:: stringBackground
|
|
An instance of link::Classes/Color::. The code::background:: of the label and unit views.
|
|
argument:: stringColor
|
|
An instance of link::Classes/Color::. The code::stringColor:: of the label and unit views.
|
|
argument:: menuBackground
|
|
An instance of link::Classes/Color::. The code::background:: of the menu.
|
|
argument:: menuStringColor
|
|
An instance of link::Classes/Color::. The code::stringColor:: of the menu.
|
|
argument:: background
|
|
An instance of link::Classes/Color::. The code::background:: of the list view.
|
|
|
|
method:: font
|
|
Set the link::Classes/Font:: used by all the views.
|
|
argument:: font
|
|
An instance of link::Classes/Font::.
|
|
|
|
examples::
|
|
code::
|
|
// try several examples together
|
|
(
|
|
|
|
// many menus
|
|
// inherits the parent's decorator gap
|
|
|
|
(
|
|
w=Window.new("oscillators", Rect(200,500,200,160)).front;
|
|
w.view.decorator = FlowLayout(w.view.bounds).gap_(2@2);
|
|
5.do{|i|
|
|
g = EZPopUpMenu.new(w,190@22, "Oscillator % : ".format(i+1));
|
|
g.addItem(\off, {"off". postln});
|
|
g.addItem(\sine, {"sine". postln});
|
|
g.addItem(\saw, {"saw". postln});
|
|
g.addItem(\pulse, {"pulse". postln});
|
|
g.setColors(Color.grey,Color.white);
|
|
g.value=0;
|
|
};
|
|
w.bounds=w.bounds.moveBy(300,60);
|
|
);
|
|
|
|
|
|
// Creates its own window if parentView is nil:
|
|
(
|
|
g = EZPopUpMenu.new(nil,250@22 ," Select : ");
|
|
g.addItem(\item0, {"this is item 0". postln});
|
|
g.addItem(\item1, {"this is item 1". postln});
|
|
g.addItem(\item2, {"this is item 2". postln});
|
|
g.setColors(Color.grey,Color.white);
|
|
g.value=0;
|
|
|
|
);
|
|
|
|
// layout vertical:
|
|
(
|
|
g = EZPopUpMenu.new(nil,200@42, " Choose",layout:\vert);
|
|
g.addItem(\item0, {"this is item 0". postln});
|
|
g.addItem(\item1, {"this is item 1". postln});
|
|
g.addItem(\item2, {"this is item 2". postln});
|
|
g.setColors(Color.grey,Color.white);
|
|
g.window.bounds=g.window.bounds.moveBy(300,-200);
|
|
g.value=0;
|
|
);
|
|
|
|
// No labelView created, so set the window title;
|
|
(
|
|
g = EZPopUpMenu.new(bounds:180@22); // no label
|
|
g.addItem(\item0, {"this is item 0". postln});
|
|
g.addItem(\item1, {"this is item 1". postln});
|
|
g.addItem(\item2, {"this is item 2". postln});
|
|
g.value=0;
|
|
g.window.name=" choose item";
|
|
g.window.bounds=g.window.bounds.moveBy(0,-200);
|
|
);
|
|
)
|
|
// insertItem;
|
|
|
|
(
|
|
g = EZPopUpMenu.new(nil,200@22, "Menu:");
|
|
g.addItem(\item0, {"this is item 0". postln});
|
|
g.addItem(\item1, {"this is item 1". postln});
|
|
g.addItem(\item2, {"this is item 2". postln});
|
|
g.addItem(\item4, {"this is item 4". postln});
|
|
g.value=0;
|
|
);
|
|
|
|
g.insertItem(3, \item3, {"this is item 3". postln});
|
|
|
|
|
|
// remove Item ;
|
|
|
|
(
|
|
w=Window.new.front;
|
|
w.view.decorator = FlowLayout(w.view.bounds);
|
|
g = EZPopUpMenu.new(w,200@22, "Menu:");
|
|
g.addItem(\item0, {"this is item 0". postln});
|
|
g.addItem(\item1, {"this is item 1". postln});
|
|
g.addItem(\item2, {"this is item 2". postln});
|
|
g.addItem(\item4, {"this is item 4". postln});
|
|
g.insertItem(3, \item3, {"this is item 3". postln});
|
|
g.value=0;
|
|
)
|
|
|
|
g. removeItemAt(0);
|
|
|
|
|
|
|
|
// replace item;
|
|
(
|
|
g = EZPopUpMenu.new(nil,200@22, "List:");
|
|
g.addItem(\item0, {"this is item 0". postln});
|
|
g.addItem(\item1, {"this is item 1". postln});
|
|
g.addItem(\item2, {"this is item 2". postln});
|
|
g.addItem(\item3, {"this is item 3". postln});
|
|
)
|
|
|
|
g.replaceItemAt(2, \item2_replaced, {"this is item 2 replaced". postln});
|
|
::
|