Update of /cvsroot/dynapi/dynapi/docs/config/data/dynapi/api
In directory usw-pr-cvs1:/tmp/cvs-serv28156

Modified Files:
        events.js dynlayer.js dyndocument.js browser.js 
Log Message:
More Documentation updates.

Index: events.js
===================================================================
RCS file: /cvsroot/dynapi/dynapi/docs/config/data/dynapi/api/events.js,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -r1.2 -r1.3
*** events.js   2001/01/21 06:08:55     1.2
--- events.js   2001/01/21 21:15:09     1.3
***************
*** 7,15 ****
  public:
        DynEvent(string type,object src,object target);
!       /// Returns the event type
        string getType();
!       /// Returns the event source
        object getSource();
!       /// Returns the event target
        object getTarget();
  };
--- 7,24 ----
  public:
        DynEvent(string type,object src,object target);
!       /** Returns the type
!         *
!         * @return type of the event as a string
!         */
        string getType();
!       /** Returns the source
!         *
!         * @return source object for the event
!         */
        object getSource();
!       /** Returns the target
!         *
!         * @return target object for the event
!         */
        object getTarget();
  };
***************
*** 22,25 ****
--- 31,44 ----
        void handleEvent(object target);
  public:
+       /** Creates a new EventListener
+       *
+         * @param target The EventListener's target object
+         *
+         * Example Usage:
+         * @code
+         * mylayer = new DynLayer();
+         * var listener = new EventListener(mylayer);
+         * @endcode
+         */
        EventListener(object target);
  };
***************
*** 35,46 ****
        void bubbleEvent();
  public:
!       /// Returns the event type
!       /// @see DynEvent::getType
        string getType();
!       /// Returns the event source
!       /// @see DynEvent::getSoure
        object getSource();
!       /// Returns the event target
!       /// @see DynEvent::getTarget
        object getTarget();
        int getX();
--- 54,71 ----
        void bubbleEvent();
  public:
!       /** Returns the event type
!       *
!         * @see DynEvent::getType
!         */
        string getType();
!       /** Returns the event source
!         *
!         * @see DynEvent::getSoure
!         */
        object getSource();
!       /** Returns the event target
!          *
!          * @see DynEvent::getTarget
!          */
        object getTarget();
        int getX();
***************
*** 48,52 ****
--- 73,82 ----
        int getPageX();
        int getPageY();
+       /** Sets bubble event
+         *
+         * @param bubble Determines whether or not to bubble the MouseEvent
+         */
        void setBubble(boolean bubble);
+       /// Cancels the event
        void cancelBrowserEvent();
  };
***************
*** 60,64 ****
        /// Captures the mouse events for the layer
        void captureMouseEvents();
!       /// Adds the EventListener to the DynLayer
        void addEventListener(EventListener listener);
        /// Removes the EventListener from the DynLayer
--- 90,101 ----
        /// Captures the mouse events for the layer
        void captureMouseEvents();
!       /** Adds the EventListener to the DynLayer
!         *
!         * Example Usage:
!         * @code
!         * var x = new EventListener(mylayer);
!         * mylayer.addEventListner(x);
!         * @endcode
!         */
        void addEventListener(EventListener listener);
        /// Removes the EventListener from the DynLayer

Index: dynlayer.js
===================================================================
RCS file: /cvsroot/dynapi/dynapi/docs/config/data/dynapi/api/dynlayer.js,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -r1.3 -r1.4
*** dynlayer.js 2001/01/21 07:03:51     1.3
--- dynlayer.js 2001/01/21 21:15:09     1.4
***************
*** 23,26 ****
--- 23,27 ----
        /// Invokes the precreate event for the given DynLayer
        static void flagPrecreate(DynLayer dlyr);
+       /// Invokes the predelete event for the given DynLayer
        static void flagDeleteChildren(DynLayer dlyr);
        /// Set to true for all DynLayer objects
***************
*** 56,60 ****
          * created if no id is given.
          * 
!         * General method of creating a DynLayer:
          * @code
          * mylayer = new DynLayer();
--- 57,61 ----
          * created if no id is given.
          * 
!         * Example Usage:
          * @code
          * mylayer = new DynLayer();
***************
*** 63,78 ****
        DynLayer(string id,int x,int y,int w,int h,string bgColor,string visible,int 
zIndex,string bgImage);
        DynLayer children[];
!       /// Adds the given DynLayer(s) to this DynLayer
        void addChild(DynLayer dlyr);
        /// Removes the given child
        void removeChild(DynLayer child);
!       /// Removes this from the parent
        void removeFromParent();
        /// Deletes the child object permanently from the document
        void deleteChild(DynLayer child);
!       /// Deletes all of the children from this
        void deleteAllChildren();
!       /// Deletes this from its parent
        void deleteFromParent();
        string getOuterHTML();
        /** Sets the DynLayer styles
--- 64,93 ----
        DynLayer(string id,int x,int y,int w,int h,string bgColor,string visible,int 
zIndex,string bgImage);
        DynLayer children[];
!       /** Adds the given DynLayer(s) to this DynLayer
!         *
!         * @note Once a layer has been added to a document, it may not be 
!         * added again.  You must use removeChild first.
!         */
        void addChild(DynLayer dlyr);
        /// Removes the given child
        void removeChild(DynLayer child);
!       /** Removes this from the parent
!         *
!         * @see removeChild
!         */
        void removeFromParent();
        /// Deletes the child object permanently from the document
        void deleteChild(DynLayer child);
!       /** Deletes all of the children from this
!         *
!         * @see deleteChild
!         */
        void deleteAllChildren();
!       /** Deletes this from its parent
!         *
!         * @see deleteChild
!         */
        void deleteFromParent();
+       /// Includes the html for the DynLayer including its children
        string getOuterHTML();
        /** Sets the DynLayer styles
***************
*** 87,90 ****
--- 102,113 ----
          *   style.visibility
          *   style.zIndex;
+         *
+         * Example Usage:
+         * @code
+         * var style = new Object();
+         * style.left = 4
+         * style.height = 11
+         * mylayer.getStyle(style);
+         * @endcode
          */      
        void setStyle(object style);
***************
*** 111,120 ****
        /** Sets the DynLayer visible
          *
!         * true shows the layer and false hides the layer
          */
        void setVisible(boolean visible);
        /** Returns the layer's visibility
          *
!         * true for visible and false for hidden
          */
        boolean getVisible();
--- 134,144 ----
        /** Sets the DynLayer visible
          *
!         * @param true shows the layer and false hides the layer
          */
        void setVisible(boolean visible);
        /** Returns the layer's visibility
          *
!         * @retval true layer is visible
!         * @retval false layer is hidden
          */
        boolean getVisible();

Index: dyndocument.js
===================================================================
RCS file: /cvsroot/dynapi/dynapi/docs/config/data/dynapi/api/dyndocument.js,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -r1.3 -r1.4
*** dyndocument.js      2001/01/21 07:03:51     1.3
--- dyndocument.js      2001/01/21 21:15:09     1.4
***************
*** 21,24 ****
--- 21,25 ----
        /// Set to true for all DynDocument objects
        boolean isDynDocument;
+       /// @see DynLayer::addChildID
        void addChildID(DynDocument child);
        /// Finds the document dimensions

Index: browser.js
===================================================================
RCS file: /cvsroot/dynapi/dynapi/docs/config/data/dynapi/api/browser.js,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -r1.2 -r1.3
*** browser.js  2001/01/21 06:08:55     1.2
--- browser.js  2001/01/21 21:15:09     1.3
***************
*** 2,11 ****
    *
    * The Browser class is automatically initialized as DynAPI.browser and
!   * a global "is" Browser object.  To test the clients' browser for Netscape,
!   * you would say: 
    * @code
!   * if (is.ns) {
!   * 
!   * }
    * @endcode
    */
--- 2,13 ----
    *
    * The Browser class is automatically initialized as DynAPI.browser and
!   * a global "is" Browser object.  The Browser Class allows you to test
!   * for the client's browser type.
!   *
!   * Example Usage:
    * @code
!   * if (is.ns) { }
!   * else if (is.ie) { }
!   * else if (is.opera { }
    * @endcode
    */
***************
*** 21,25 ****
        string ua;
  public:
!       /// Initializes all properties of the Browser class
        Browser();
        /// Boolean value for Netscape
--- 23,30 ----
        string ua;
  public:
!       /** Initializes all properties of the Browser class
!       *
!         * @note This class is intialized globally as "is" and "DynAPI.browser".
!         */
        Browser();
        /// Boolean value for Netscape


_______________________________________________
Dynapi-CVS mailing list
[EMAIL PROTECTED]
http://lists.sourceforge.net/lists/listinfo/dynapi-cvs

Reply via email to