Implement perspective auto-detection and switching

[gpl/argeo-slc.git] / org.argeo.slc.webapp / src / main / webapp / argeo-ria-src / class / org / argeo / ria / components / IView.js

diff --git a/org.argeo.slc.webapp/src/main/webapp/argeo-ria-src/class/org/argeo/ria/components/IView.js b/org.argeo.slc.webapp/src/main/webapp/argeo-ria-src/class/org/argeo/ria/components/IView.js
index 3d3cd1aa3797aa7b3514a98e4b99369af1ecdfc5..e4c8be677ee87adc789f1301078486e24df440e0 100644 (file)
--- a/org.argeo.slc.webapp/src/main/webapp/argeo-ria-src/class/org/argeo/ria/components/IView.js
+++ b/org.argeo.slc.webapp/src/main/webapp/argeo-ria-src/class/org/argeo/ria/components/IView.js
@@ -1,6 +1,8 @@
 /**\r
  * Interface for a standard 'view' of an argeo RIA. A view is an independant applet that \r
  * will be integrated inside a ViewPane. \r
+ * If this view is to implement a selection (a list, a tree, etc) that will trigger changes on commands, \r
+ * it must trigger a viewSelection#changeSelection event.\r
  * \r
  * The typical lifecycle of an IView will be the following :\r
  * <br>+ init(viewPane) : initialize basic GUI in the viewPane\r
@@ -12,12 +14,18 @@
 qx.Interface.define("org.argeo.ria.components.IView", {\r
        \r
        properties : {\r
+               /**\r
+                * The commands definition Map that will be automatically added and wired to the menubar and toolbar.\r
+                * See {@link org.argeo.ria.event.CommandsManager#definitions} for the keys to use for defining commands.\r
+                */\r
                commands : {}\r
        },\r
        \r
        members : {\r
                /**\r
                 * The implementation should contain the GUI initialisation.\r
+                * This is the role of the manager to actually add the graphical component to the pane, \r
+                * so it's not necessary to do it here. \r
                 * @param viewPane {org.argeo.ria.components.ViewPane} The pane manager\r
                 * @return {Boolean}\r
                 */\r
@@ -29,8 +37,7 @@ qx.Interface.define("org.argeo.ria.components.IView", {
                 */\r
                load : function(data){return true;},\r
                /**\r
-                * Whether this component is already contained in a scroller \r
-                * (return false) or not (return true).\r
+                * Whether this component is already contained in a scroller (return false) or not (return true).\r
                 * @return {Boolean}\r
                 */\r
                addScroll : function(){return true;}\r