From c243740190cbe2e85df063538557c88586837d18 Mon Sep 17 00:00:00 2001
From: Ray Greenwell <ray@threerings.net>
Date: Fri, 23 May 2008 02:35:20 +0000
Subject: [PATCH] - Allow the override dispatcher to be specified in our
 factory convenience method. - Style changes.

git-svn-id: svn+ssh://src.earth.threerings.net/nenya/trunk@503 ed5b42cb-e716-0410-a449-f6a68f950b19
---
 src/as/com/threerings/flex/CommandMenu.as | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/src/as/com/threerings/flex/CommandMenu.as b/src/as/com/threerings/flex/CommandMenu.as
index dac41a79..d18727f2 100644
--- a/src/as/com/threerings/flex/CommandMenu.as
+++ b/src/as/com/threerings/flex/CommandMenu.as
@@ -83,14 +83,18 @@ public class CommandMenu extends Menu
      * Factory method to create a command menu.
      *
      * @param items an array of menu items.
+     * @param dispatcher an override event dispatcher to use for command events, rather than
+     * our parent.
      */
-    public static function createMenu (items :Array) :CommandMenu
+    public static function createMenu (
+        items :Array, dispatcher :IEventDispatcher = null) :CommandMenu
     {
         var menu :CommandMenu = new CommandMenu();
         menu.owner = DisplayObjectContainer(Application.application);
         menu.tabEnabled = false;
         menu.showRoot = true;
-        Menu.popUpMenu(menu, null, items);
+        menu.setDispatcher(dispatcher);
+        Menu.popUpMenu(menu, null, items); // does not actually pop up, but needed.
         return menu;
     }
 
@@ -105,8 +109,8 @@ public class CommandMenu extends Menu
     }
 
     /**
-     * Configures the event dispatcher to be used when dispatching this menu's events. By default
-     * they will be dispatched on the stage.
+     * Configures the event dispatcher to be used when dispatching this menu's command events.
+     * Normally they will be dispatched on our parent (usually the SystemManager or something).
      */
     public function setDispatcher (dispatcher :IEventDispatcher) :void
     {
@@ -116,8 +120,8 @@ public class CommandMenu extends Menu
     /**
      * Actually pop up the menu. This can be used instead of show().
      */
-    public function popUp (trigger :DisplayObject, popUpwards :Boolean = false,
-                           popLeftwards :Boolean = false) :void
+    public function popUp (
+        trigger :DisplayObject, popUpwards :Boolean = false, popLeftwards :Boolean = false) :void
     {
         _upping = popUpwards;
         _lefting = popLeftwards;
@@ -129,8 +133,8 @@ public class CommandMenu extends Menu
     /**
      * Shows the menu at the specified mouse coordinates.
      */
-    public function popUpAt (mx :int, my :int, popUpwards :Boolean = false,
-                             popLeftwards :Boolean = false) :void
+    public function popUpAt (
+        mx :int, my :int, popUpwards :Boolean = false, popLeftwards :Boolean = false) :void
     {
         _upping = popUpwards;
         _lefting = popLeftwards;