Rogue Wave Views
Foundation Package API Reference Guide
Product Documentation:

Rogue Wave Views
Documentation Home
List of all members | Public Member Functions
IlvTimeScrollable Class Referenceabstract

Date and time-related abstract class. More...

#include <ilviews/graphics/timescale.h>

Inheritance diagram for IlvTimeScrollable:
IlvTimeScale IlvCalendarScale

Public Member Functions

virtual IlDate getMaxVisibleTime () const =0
 Returns the maximum time that the time scrollable can show. More...
 
virtual IlDate getMinVisibleTime () const =0
 Returns the minimum time that the time scrollable can show. More...
 
virtual IlvDuration getVisibleDuration () const =0
 Returns the duration of the time interval displayed by the time scrollable. More...
 
virtual IlvTimeInterval getVisibleInterval () const =0
 Returns the time interval displayed by the scale. More...
 
virtual IlDate getVisibleTime () const =0
 Returns the beginning of the time interval displayed by the time scrollable. More...
 
virtual void setMaxVisibleTime (IlDate d)=0
 Sets the maximum time that the time scrollable can show. More...
 
virtual void setMinVisibleTime (IlDate d)=0
 Sets the minimum time that the time scrollable can show. More...
 
virtual void setVisibleDuration (IlvDuration duration)=0
 Sets the duration of the time interval displayed by the time scrollable. More...
 
virtual void setVisibleInterval (IlDate time, IlvDuration duration)=0
 Sets the time interval displayed by the scale. More...
 
virtual void setVisibleTime (IlDate time)=0
 Sets the beginning of the time interval displayed by the time scrollable. More...
 

Detailed Description

Date and time-related abstract class.

Library: views

This interface defines the behavior of a component whose time interval can be scrolled.

Time scrolling is constrained by the "minimum visible time" setMinVisibleTime and the "maximum visible time" setMaxVisibleTime(). Both values must be valid.

There are four interrelated time properties: minVisibleTime, maxVisibleTime, visibleTime, and visibleDuration. These four values define two nested ranges like this:

minVisibleTime <= visibleTime <= visibleTime+visibleDuration <= maxVisibleTime

The time-scrollable component enforces this relationship by correcting or trimming properties according to the following rules:

The time-scrollable component should use the method IlvTimeScrollUtil::trimInterval() to perform consistent validation and trimming of the time value arguments.

Member Function Documentation

§ getMaxVisibleTime()

virtual IlDate IlvTimeScrollable::getMaxVisibleTime ( ) const
pure virtual

Returns the maximum time that the time scrollable can show.

Returns
The maximum visible time.
See also
setMaxVisibleTime()

Implemented in IlvTimeScale.

§ getMinVisibleTime()

virtual IlDate IlvTimeScrollable::getMinVisibleTime ( ) const
pure virtual

Returns the minimum time that the time scrollable can show.

Returns
The minimum visible time.
See also
setMinVisibleTime()

Implemented in IlvTimeScale.

§ getVisibleDuration()

virtual IlvDuration IlvTimeScrollable::getVisibleDuration ( ) const
pure virtual

Returns the duration of the time interval displayed by the time scrollable.

See also
setVisibleDuration()

Implemented in IlvTimeScale.

§ getVisibleInterval()

virtual IlvTimeInterval IlvTimeScrollable::getVisibleInterval ( ) const
pure virtual

Returns the time interval displayed by the scale.

See also
setVisibleInterval()

Implemented in IlvTimeScale.

§ getVisibleTime()

virtual IlDate IlvTimeScrollable::getVisibleTime ( ) const
pure virtual

Returns the beginning of the time interval displayed by the time scrollable.

See also
setVisibleTime()

Implemented in IlvTimeScale.

§ setMaxVisibleTime()

virtual void IlvTimeScrollable::setMaxVisibleTime ( IlDate  d)
pure virtual

Sets the maximum time that the time scrollable can show.

The current visible time and duration are trimmed to fit the new min-max interval by calling the IlvTimeScrollUtil::trimInterval() method.

Parameters
dThe maximum visible time.
See also
getMaxVisibleTime()
getVisibleDuration()

Implemented in IlvTimeScale.

§ setMinVisibleTime()

virtual void IlvTimeScrollable::setMinVisibleTime ( IlDate  d)
pure virtual

Sets the minimum time that the time scrollable can show.

The current visible time and duration are trimmed to fit the new min-max interval by calling the IlvTimeScrollUtil::trimInterval() method.

Parameters
dThe minimum visible time.
See also
getMinVisibleTime()
getVisibleDuration()

Implemented in IlvTimeScale.

§ setVisibleDuration()

virtual void IlvTimeScrollable::setVisibleDuration ( IlvDuration  duration)
pure virtual

Sets the duration of the time interval displayed by the time scrollable.

The specified duration is compared against the min and max visible times and is trimmed if necessary by calling the IlvTimeScrollUtil::trimInterval() method. If you are changing both the visible time and duration, it is preferable to use the setVisibleInterval() method instead.

Parameters
durationThe new duration value.
See also
getVisibleDuration()
getMinVisibleTime()
getMaxVisibleTime()

Implemented in IlvTimeScale, and IlvCalendarScale.

§ setVisibleInterval()

virtual void IlvTimeScrollable::setVisibleInterval ( IlDate  time,
IlvDuration  duration 
)
pure virtual

Sets the time interval displayed by the scale.

The specified duration is compared against the min and max visible times and is trimmed if necessary by calling the IlvTimeScrollUtil::trimInterval() method.

Parameters
timeThe new time value.
durationThe new duration value.
See also
getMinVisibleTime()
getMaxVisibleTime()

Implemented in IlvTimeScale, and IlvCalendarScale.

§ setVisibleTime()

virtual void IlvTimeScrollable::setVisibleTime ( IlDate  time)
pure virtual

Sets the beginning of the time interval displayed by the time scrollable.

The specified time value is compared against the min and max visible times and is trimmed if necessary by calling the IlvTimeScrollUtil::trimInterval() method. If you are changing both the visible time and duration, it is preferable to use the setVisibleInterval() method instead.

Parameters
timeThe new time value.
See also
getVisibleTime()
getMinVisibleTime()
getMaxVisibleTime()
setVisibleInterval()

Implemented in IlvTimeScale.


© Copyright 2018, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.