JViews 5.0 Graphics Framework DHTML Release Notes

This document describes the changes that have been made to the JViews Graphics Framework Thin-client JavaScript classes since version 4.0.

General Changes
New Classes
Modified Classes

General Changes

The DHTML classes are now located in <installdir>/classes/thinclient/javascript and <installdir>/classes/thinclient/javascript/framework.

The file <installdir>/classes/thinclient/javascript/framework/framework.js contains all the JavaScript classes required to run a DHTML client for the framework.

The directory <installdir>/classes/thinclient/javascript/gantt contains specific JavaScript classes for the Gantt Chart (see the thin client section in the Gantt Chart Users Manual).

You can read the documentation of DHTML classes at: <installdir>/doc/jscript/index.html.

Most of the existing components have a new base class. Consequently, it is now required to include more .js files to use a component.

New Classes

• IlvEmptyView - A base class for all views.
  
• IlvGlassView - An extension of IlvEmptyView that is designed to capture keyboard and mouse input events and forward them to an event handler.
  
• IlvImageView - An extension of IlvEmptyView that is designed to display an image.
  
• IlvImageEventView - An extension of IlvImageView that is designed to display an image and forward all input events to an event handler.
  
• IlvResizableView - An extension of IlvEmptyView that can be resized by the user if setResizable(true) is called.
  
• IlvScrollbar - Abstract base class of all scroll bars.
  
• IlvHScrollbar - A horizontal scroll bar.
  
• IlvVScrollbar - A vertical scroll bar.
  
• Other new classes have been created for the DHTML Gantt Chart (see the documentation in the Gantt Chart User's Manual).
  

Modified Classes

IlvAbstractView

• IlvAbstractView now inherits from IlvResizableView, many methods of IlvAbstractView are now in the super classes IlvResizableView or IlvEmptyView.
• In addition to IlvAbstractView.js, this component now requires you to include IlvEmptyView.js, IlvResizableView.js, and IlvGlassView.js.
• The method isResizeable(set) is deprecated. You can now use isResizable.
• The method setResizeable(set) is deprecated. You can now use setResizable.

IlvButton

• IlvButton now inherits from IlvEmptyView.
• In addition to IlvButton.js, this component now requires you to include IlvEmptyView.js and IlvImageView.js.
• The constructor IlvButton(left, top, image, action) has been removed and replaced by IlvButton(left, top, width, height, image, action). This incompatible change in the API is due to the impossibility to access the correct size of images on certain browsers.

IlvHTMLPanel

• The method setContent has an additional parameter that is a JavaScript piece of code executed when the content of the Panel is loaded.

IlvURLPanel

• In order to fix a problem in Netscape browsers, we have introduced the method getBodyOnload(). You must read the documentation of this method if you are creating instances of IlvURLPanel.

IlvInteractor

• This component has moved to a separate file named IlvInteractor.js. Therefore, you need to include this file if you want to use any subclass of IlvInteractor.

The methods:
onmousedown(event) - To handle mouse down events.
onmouseup(event) - To handle mouse up events.
onmousemove(event) - To handle mouse move events.
onkeypress(event) - To handle key press events.


Are now deprecated in favor of:

mouseDown(event) - To handle mouse down events.
mouseUp(event) - To handle mouse up events.
mouseMove(event) - To handle mouse move events, but not drag events.
mouseDrag(event) - To handle mouse drag events.
keyPressed(event) - To handle key press events.

However, interactors written in JViews 4.0 will still work properly.

IlvPanel

• New methods get/setScrollPosition.

IlvToolBar

• IlvToolbar now inherits from IlvEmptyView and requires IlvEmptyView.js.
• Bug fixes in Border Color and Background Color.
• New methods set/getBackgroundImage.

IlvView

• This component now requires you to include IlvInteractor.js.
• New setImageFormat() method to use the PNG or JPEG formats.