Menu

Description

The Menu class allows the creation and control of context menus and application-level menus.( ~menu = Menu( MenuAction("A", { "A selected".postln }), MenuAction("B", { "B selected".postln }), MenuAction("C", { "C selected".postln }), ).front; )

Class Methods

.new

Inherited class methods

Instance Methods

Control

.front

.title

.tearOff

.copy

Events

Menus broadcast several kinds of events that can be registered for with the standard Object: -addDependant calls. Events broadcast by menu:

• \aboutToShow
• \aboutToHide
• \triggered (with the MenuAction that was triggered)
• \hovered (with action that was hovered over)

Events example( m = Menu(MenuAction("Option A"), MenuAction("Option B")).title_("Event Example"); f = { |menu, what, value| "Menu '%' sent event %, value = %".format(menu.title, "\\" ++ what, value).postln; if (what == \hovered) { "Hovering over: %".format(value).postln }; if (what == \triggered) { "Action triggered: %".format(value).postln; menu.destroy }; }; m.addDependant(f); m.onClose_({ m.removeDependant(f) }).front; )

Context Menus

One or more MenuActions can be attached to any View object. The shortcut key combinations for these actions will become available, and the actions will appear in the context menu for that view.

See View: -setContextMenuActions, View: -addMenuAction, View: -removeMenuAction for more information.( ~view = View().layout_(HLayout( ~button = Button().states_([["Button"]]), ~number = NumberBox().minWidth_(100).value_(100) )).front; ~button.setContextMenuActions( MenuAction("Red", { ~button.states = [["Red", Color.red]] }), MenuAction("Green", { ~button.states = [["Green", Color.green]] }), MenuAction("Blue", { ~button.states = [["Blue", Color.blue]] }) ); ~number.setContextMenuActions( MenuAction("100", { ~number.value = 100 }), MenuAction("200", { ~number.value = 200 }), MenuAction("300", { ~number.value = 300 }) ); )

Inherited instance methods

Examples

A more complex menu.( ~image = Image(64, 64).draw({ Pen.fillColor = Color.blue; Pen.fillOval(Rect(0, 0, 64, 64)); }); ~menu = Menu( MenuAction("checked", { "checked".postln }) .checked_(true), MenuAction("disabled", { "disabled".postln }) .enabled_(false), MenuAction("keyboard short", { "keyboard short".postln }) .shortcut_("Ctrl+Shift+N"), MenuAction("icon", { "icon".postln }) .icon_(~image), MenuAction("font", { "font".postln }) .font_(Font("Helvetica", 20, italic:true)), MenuAction.separator.string_("other stuff"), CustomViewAction(Slider().orientation_(\horizontal)).action_({ |v| v.value.postln }), Menu( "string.toAction", { "function.toAction".postln } ).title_("submenu") ).front; )