import FIREFOX_52_6_0esr_RELEASE from mozilla-esr52 hg repo

embedding/components/commandhandler/nsIControllerContext.idl

@@ -0,0 +1,35 @@
+/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+ 
+#include "nsISupports.idl"
+#include "nsIControllerCommandTable.idl"
+
+[scriptable, uuid(47B82B60-A36F-4167-8072-6F421151ED50)]
+interface nsIControllerContext : nsISupports
+{
+
+  /**
+   *  Init the controller, optionally passing a controller
+   *  command table.
+   *
+   * @param aCommandTable  a command table, used internally
+   *                       by this controller. May be null, in
+   *                       which case the controller will create
+   *                       a new, empty table.
+   */
+  void init(in nsIControllerCommandTable aCommandTable);
+
+  /** 
+   *  Set a context on this controller, which is passed
+   *  to commands to give them some context when they execute.
+   *
+   * @param aCommandContext  the context passed to commands.
+   *                        Note that this is *not* addreffed by the
+   *                        controller, and so needs to outlive it,
+   *                        or be nulled out.
+   */
+  void setCommandContext(in nsISupports aCommandContext);
+  
+};