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

Menu.new( ... actions)

Inherited class methods

Undocumented class methods

Menu.newFrom(otherMenu)

Menu.qtClass

Instance Methods

Control

.front(point, action)

.title

.title = title

.tearOff

.tearOff = b

.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

Undocumented instance methods

.asMenu

.asMenuAction

.onHide

.onHovered(action)

.onShow

.onTriggered(action)

.remove

.string

.string = title

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; )