Band class
Note that you cannot create a Band object by yourself. You can only retrieve Band objects from a Timeline object.
Interface
addOnScrollListener
( listener )
Add a listener for scroll events. listener
is a function that will receive a single argument,
this band object.
removeOnScrollListener
( listener )
Remove the given scroll listener
getLocale
()
Return the locale of this band, e.g.,
"en-US".
getTimeZone
()
Return the time zone of this band, e.g.,
-5 (Eastern Standard Time).
getViewLength
()
Return the pixel width of the band's visible area if the
timeline is horizontal, and the pixel height if verical.
getTotalViewLength
()
Return the pixel width of the band's (visible and cropped) if the
timeline is horizontal, and the pixel height if verical.
getViewWidth
()
Return the pixel height of the band if the timeline is horizontal,
and the pixel width if verical.
getViewOffset
()
Return the scroll offset of the band's div
relative to the visible area. This is always negative.
getMinDate(),
getMaxDate(),
getMinVisibleDate(),
getMaxVisibleDate(),
getCenterVisibleDate(),
setMinVisibleDate( date ), setMaxVisibleDate( date ), setCenterVisibleDate( date )
setMinVisibleDate( date ), setMaxVisibleDate( date ), setCenterVisibleDate( date )
The diagram below illustrates what these methods do:
dateToPixelOffset
( date )
Return the pixel offset relative to the starting edge of
the band's div (not the visible
area) corresponding to the given date.
pixelOffsetToDate
( pixels )
Return the date corresponding to the given pixel offset
(relative to the starting edge of the band's
div, not the visible
area).
createLayerDiv
( zIndex )
Create and return a div that
acts like a layer inside the band, ordered in the z dimension
among other layers of that band. Child elements of this
div can then be positioned
relative to the band.
removeLayerDiv
( div )
Remove an existing layer div.
openBubbleForPoint
( pageX,
pageY,
width,
height )
Open an information bubble at the given page coordinates,
large enough to accommodate content of the given dimensions
in pixels. The bubble will be automatically positioned
around the given coordinates, pointing to it.
closeBubble
()
Close any open information bubble.
getLabeller
()
Return the labeller of this band.
getIndex
()
Return the index of this band in its containing timeline,
e.g., 0 for the first band.
getEther
()
Return the ether of this band.
getEtherPainter
()
Return the ether painter of this band.
getEventSource
()
Return the event source of this band.
getEventPainter
()
Return the event painter of this band.
layout
()
Trigger a re-layout.
paint
()
Trigger a repaint.
softPaint
()
Trigger a soft repaint.