Main Page | Class Hierarchy | Class List | Directories | File List | Class Members | File Members

YQPkgWarningRangeNotifier Class Reference

#include <YQPkgDiskUsageList.h>

List of all members.

Public Member Functions

 YQPkgWarningRangeNotifier ()
void enterRange ()
void enterProximity ()
void warningPostedNotify ()
bool inRange () const
bool needWarning () const
bool leavingProximity () const
void clear ()
void clearHistory ()

Protected Attributes

bool _inRange
bool _isClose
bool _hasBeenClose
bool _warningPosted


Detailed Description

Helper class to manage warnings that are to be issued when a value enters a predefined range, but repeated only when that value leaves a ( wider ) "proximity" range and then re-enters the ( narrower ) "inner" range.

Example: Disk space usage:

70% 75% 80% [proximity range start] 85% 90% [inner range start] 95% 100%

A warning is to be posted when there is only 90% disk space left. After the warning is displayed, there shall be no more warning until disk usage decreases below 80% ( the proximity range ) and then later increases again to 90%.

The net effect of all that is to avoid posting the warning over and over again while the value changes back and forth around the boundary of the ( inner ) warning range.


Constructor & Destructor Documentation

YQPkgWarningRangeNotifier::YQPkgWarningRangeNotifier  ) 
 

Constructor.


Member Function Documentation

void YQPkgWarningRangeNotifier::clear  ) 
 

Clear the current values, i.e. prepare for a new round of checks

void YQPkgWarningRangeNotifier::clearHistory  ) 
 

Clear everything, including all history values such as if a warning has been posted.

void YQPkgWarningRangeNotifier::enterProximity  ) 
 

Notification that the proximity range is entered, i.e. that the value is getting near the inner range. 'enterRange()' automatically includes this, too.

void YQPkgWarningRangeNotifier::enterRange  ) 
 

Notification that the inner range is entered. The caller has to decide the criteria for that.

bool YQPkgWarningRangeNotifier::inRange  )  const
 

Check if the value is in range, i.e. if anybody from the outside has called 'enterRange()' since the last call to 'clear()'.

bool YQPkgWarningRangeNotifier::leavingProximity  )  const
 

Check if the value is leaving the proximity range.

bool YQPkgWarningRangeNotifier::needWarning  )  const
 

Check if a warning should be posted, i.e. if the value is currently in range ( see 'inRange() ) and there has been no notification yet that a warning has already been posted.

void YQPkgWarningRangeNotifier::warningPostedNotify  ) 
 

Notification that a warning has been posted.


Member Data Documentation

bool YQPkgWarningRangeNotifier::_hasBeenClose [protected]
 

bool YQPkgWarningRangeNotifier::_inRange [protected]
 

bool YQPkgWarningRangeNotifier::_isClose [protected]
 

bool YQPkgWarningRangeNotifier::_warningPosted [protected]
 


The documentation for this class was generated from the following files:
Generated on Wed Nov 12 06:11:17 2008 for yast2-qt by  doxygen 1.3.9.1