PREV CLASS    Documentation homepage     NEXT CLASS 

IlvPanel

IlvObject
  |
  +--IlvPanel
Category:
Common component
JavaScript File:
IlvUtil.js
Description:
This class is an abstract class that cannot be used as is. It contains generic methods that are common to its subclasses. It defines a rectangular area on the Web page that can be filled with any kind of content. This class is to be considered as a low-level graphic component. It is not meant to be instantiated directly. Use one of its subclasses, IlvHTMLPanel or IlvURLPanel, instead.

Constructor Summary
IlvPanel(left, top, width, height)

Method Summary
dispose()
Disposes of all resources being used by the panel.
getBounds()
Returns the bounds of this IlvPanel.
getClip()
Returns the clip of this IlvPanel.
getCursor()
Returns the mouse cursor that is displayed when the mouse is over this panel.
getHeight()
Returns the height of this IlvPanel.
getLeft()
Returns the position of the left border of this IlvPanel.
getMouseEventSource()
Returns the object that catches each mouse event sent by the browser to this panel.
getScrollPosition()
Returns the scroll of this IlvPanel.
getTop()
Returns the position of the top border of this IlvPanel.
getWidth()
Returns the width of this IlvPanel.
getZIndex()
Returns the 'z' coordinate of the panel.
isVisible()
Returns the visibility of this IlvPanel.
setBackgroundColor(color)
Sets the background color of this IlvPanel.
setBackgroundImage(image)
Sets the background image of this IlvPanel.
setBounds(left, top, width, height)
Reshapes this IlvPanel.
setClip(left, top, width, height)
Sets the clip of this panel.
setCursor(cursor)
Sets the mouse cursor that is displayed when the mouse is over this panel.
setLocation(left, top)
Moves this IlvPanel to the specified location.
setScrollPosition(x, y)
Sets the scroll position of this IlvPanel.
setSize(width, height)
Sets the size of this IlvPanel.
setVisible(visible)
Sets the visibility of this IlvPanel.
setZIndex(zIndex)
Set the 'z' coordinate of the panel.
translate(dx, dy)
Moves this IlvPanel according to the specified amount of pixels.

Constructor Detail

IlvPanel

IlvPanel(left, top, width, height)
Creates an instance of IlvPanel.

Method Detail

dispose

 
dispose()
Disposes of all resources being used by the panel. Make sure to call IlvObject.callDispose() function on the onunload event of the page: 
  <body onunload="IlvObject.callDispose()">

getBounds

 
getBounds()
Returns the bounds of this IlvPanel. Note: You are not allowed to modify the object returned by this method. To modify the bounds of a panel, use the setBounds method.
Returns:
An object with four properties: left, top, width, and height. These properties represent the bounds of this IlvPanel expressed in the coordinates of the browser window.

getClip

 
getClip()
Returns the clip of this IlvPanel. Note: You are not allowed to modify the object returned by this method. To modify the clip of a panel, use the setClip method.
Returns:
An object with four properties: left, top, width, and height.These properties represent the clip of this panel expressed in the coordinates of the panel.

getCursor

 
getCursor()
Returns the mouse cursor that is displayed when the mouse is over this panel.

getHeight

 
getHeight()
Returns the height of this IlvPanel.

getLeft

 
getLeft()
Returns the position of the left border of this IlvPanel.

getMouseEventSource

 
getMouseEventSource()
Returns the object that catches each mouse event sent by the browser to this panel. This object can be associated with the following callbacks for processing mouse events: onmouseover, onmouseout, onmousedown, onmouseup, and onmousemove. Note: The way events are dispatched to the panels and the properties of the mouse events are not independent of the browser. Therefore, this method is not supposed to be used directly, but by the view when an interactor is set to an IlvView object. As a consequence, we recommend that you use the view-interactor architecture instead of using the object returned by this method directly.

getScrollPosition

 
getScrollPosition()
Returns the scroll of this IlvPanel. Note: You are not allowed to modify the object returned by this method. To modify the scroll position of a panel, use the setScrollPosition method.
Returns:
An object with two properties: x and y.

getTop

 
getTop()
Returns the position of the top border of this IlvPanel.

getWidth

 
getWidth()
Returns the width of this IlvPanel.

getZIndex

 
getZIndex()
Returns the 'z' coordinate of the panel. By default the value is set to 1
Returns:
the z-index

isVisible

 
isVisible()
Returns the visibility of this IlvPanel.

setBackgroundColor

 
setBackgroundColor(color)
Sets the background color of this IlvPanel. Note: By default, a panel has no background color and is therefore transparent.
Parameters:
color - A string describing the color. For example, "#FFFFFF" corresponds to white.

setBackgroundImage

 
setBackgroundImage(image)
Sets the background image of this IlvPanel. The image is tiled across the background of the panel. Note: By default, a panel has no background image and is therefore transparent.
Parameters:
image - The URL of an image.

setBounds

 
setBounds(left, top, width, height)
Reshapes this IlvPanel. This method is a shortcut for setLocation and setSize.

setClip

 
setClip(left, top, width, height)
Sets the clip of this panel.
Parameters:
left - Position of the left side, relative to the upper-left corner of the panel.
top - Position of the top side, relative to the upper-left corner of the panel.
width - The width of the clip in pixels.
height - The height of the clip in pixels.

setCursor

 
setCursor(cursor)
Sets the mouse cursor that is displayed when the mouse is over this panel.
Parameters:
cursor - A string representing the cursor type according to the specifications of the Cascading Style Sheets (CSS).

setLocation

 
setLocation(left, top)
Moves this IlvPanel to the specified location.
Parameters:
left - Position of the left side, relative to the upper-left corner of the window.
top - Position of the top side, relative to the upper-left corner of the window.

setScrollPosition

 
setScrollPosition(x, y)
Sets the scroll position of this IlvPanel.
Parameters:
x - The scroll position along the x-axis, relative to the top of the panel.
Y - The scroll position along the y-axis, relative to the left side of the panel.

setSize

 
setSize(width, height)
Sets the size of this IlvPanel. Note: This method also resets the clip.
Parameters:
width - The width of the panel in pixels.
height - The height of the panel in pixels.

setVisible

 
setVisible(visible)
Sets the visibility of this IlvPanel.

setZIndex

 
setZIndex(zIndex)
Set the 'z' coordinate of the panel. By default the value is set to 1
Parameters:
the - z-index

translate

 
translate(dx, dy)
Moves this IlvPanel according to the specified amount of pixels.

Inherited Methods from IlvObject
callDispose, dispose, getClassName, hashCode, inherits, instanceOf, invoke, registerDispose, removeHTML, setClassName, superConstructor, superInvoke, toString, updateVisibility
 PREV CLASS    Documentation homepage     NEXT CLASS