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.