DynamicSlider Class Reference

A more dynamic slider that provides moving tooltips that show the slider value. More...

#include <dynamicSlider.h>

Inheritance diagram for DynamicSlider:

Collaboration diagram for DynamicSlider:

Signals
void	mouseHasMoved ()

Public Member Functions
	DynamicSlider (Qt::Orientation orientation, QWidget *parent, const char *name=0)
	~DynamicSlider ()
void	setZeroString (QString val)
	when set, a zero string is shown instead of the current value/prefix/suffix when the slider value is 0
void	setPrefix (QString val)
	set the prefix that is displayed before the current slider value
void	setPrefixes (QString prefix1, QString prefix2)
	set two prefix values, one for when the value is positive and one for when the value is negative.
void	setSuffix (QString val)
	set the suffix that is displayed after the current slider value
void	setSuffixes (QString suffix1, QString suffix2)
	set two suffix values, one for when the value is positive and one for when the value is negative.
QPoint	getMousePos ()

Protected Member Functions
void	mouseMoveEvent (QMouseEvent *e)
virtual QString	mapValToString ()
	subclass DynamicSlider and reimplement this method to change the behavior used to display slider values

Private Slots
void	updateTooltipLabel ()

Private Attributes
QString	zeroString
QString	prefix1
QString	prefix2
QString	suffix1
QString	suffix2
SliderToolTip *	tooltip
QPoint	cachedMousePos

Detailed Description

A more dynamic slider that provides moving tooltips that show the slider value.

Definition at line 23 of file dynamicSlider.h.

Constructor & Destructor Documentation

DynamicSlider()

DynamicSlider::DynamicSlider	(	Qt::Orientation	orientation,
		QWidget *	parent,
		const char *	name = 0 )

Definition at line 23 of file dynamicSlider.cpp.

                                                : QSlider(orientation, parent, name)
{
  //determine the parent screen the tooltip will be displayed in and create tooltip
  int scr = QApplication::desktop()->screenNumber( this );                                
  tooltip = new SliderToolTip( QApplication::desktop()->screen( scr ), this);
  updateTooltipLabel();
 
  //make sure tooltip label is updated when the slider value changes
  connect( this, SIGNAL( valueChanged(int) ),
           this, SLOT( updateTooltipLabel() ) );
}

References tooltip, and updateTooltipLabel().

~DynamicSlider()

DynamicSlider::~DynamicSlider

(

)

Definition at line 36 of file dynamicSlider.cpp.

{
  delete tooltip;
  tooltip = NULL;
}

References tooltip.

Member Function Documentation

getMousePos()

QPoint DynamicSlider::getMousePos

(

)

Definition at line 125 of file dynamicSlider.cpp.

{ return cachedMousePos; }

References cachedMousePos.

Referenced by SliderToolTip::update().

mapValToString()

QString DynamicSlider::mapValToString ( )

protectedvirtual

subclass DynamicSlider and reimplement this method to change the behavior used to display slider values

Reimplemented in BlurSharpenSlider.

Definition at line 76 of file dynamicSlider.cpp.

{
  //the default behavior is to simply use the slider value directly
  if( orientation() == Qt::Vertical )  
    return QString("%1").arg( -value() );
  else
    return QString("%1").arg(value());
}

Referenced by updateTooltipLabel().

mouseHasMoved

void DynamicSlider::mouseHasMoved ( )

signal

Referenced by mouseMoveEvent().

mouseMoveEvent()

void DynamicSlider::mouseMoveEvent ( QMouseEvent * e )

protected

Definition at line 117 of file dynamicSlider.cpp.

{
  //cache the mouse position since the tooltip will need this information when updating itself
  cachedMousePos = e->pos();
  QSlider::mouseMoveEvent(e);
  emit mouseHasMoved();
}

References cachedMousePos, and mouseHasMoved().

setPrefix()

void DynamicSlider::setPrefix

(

QString

val

)

set the prefix that is displayed before the current slider value

Definition at line 48 of file dynamicSlider.cpp.

{
  prefix1 = val;
  prefix2 = QString::null;
  updateTooltipLabel();
}

References prefix1, prefix2, and updateTooltipLabel().

setPrefixes()

void DynamicSlider::setPrefixes	(	QString	prefix1,
		QString	prefix2 )

set two prefix values, one for when the value is positive and one for when the value is negative.

Definition at line 55 of file dynamicSlider.cpp.

{
  prefix1 = v1;
  prefix2 = v2;
  updateTooltipLabel();
}

References prefix1, prefix2, and updateTooltipLabel().

Referenced by BlurSharpenSlider::BlurSharpenSlider(), and HistogramEditor::HistogramEditor().

setSuffix()

void DynamicSlider::setSuffix

(

QString

val

)

set the suffix that is displayed after the current slider value

Definition at line 62 of file dynamicSlider.cpp.

{
  suffix1 = val;
  suffix2 = QString::null;
  updateTooltipLabel();
}

References suffix1, suffix2, and updateTooltipLabel().

Referenced by BlurSharpenSlider::BlurSharpenSlider().

setSuffixes()

void DynamicSlider::setSuffixes	(	QString	suffix1,
		QString	suffix2 )

set two suffix values, one for when the value is positive and one for when the value is negative.

Definition at line 69 of file dynamicSlider.cpp.

{
  suffix1 = v1;
  suffix2 = v2;
  updateTooltipLabel();
}

References suffix1, suffix2, and updateTooltipLabel().

setZeroString()

void DynamicSlider::setZeroString

(

QString

val

)

when set, a zero string is shown instead of the current value/prefix/suffix when the slider value is 0

Definition at line 42 of file dynamicSlider.cpp.

{
  zeroString = val;  
  updateTooltipLabel();
}

References updateTooltipLabel(), and zeroString.

Referenced by BlurSharpenSlider::BlurSharpenSlider(), and HistogramEditor::HistogramEditor().

updateTooltipLabel

void DynamicSlider::updateTooltipLabel ( )

privateslot

Definition at line 85 of file dynamicSlider.cpp.

{
  //determine string that will be used for tooltip
  QString tipString;
  
  //if the value is zero and a zero string has been provided used that
  if( value() == 0 && !zeroString.isNull() )
  {
    tipString = zeroString;
  }
  //otherwise construct a tip string using provided prefixes, suffixes, and the current slider value
  else
  { 
    //determine prefix and suffix that will be used to construct tooltip string
    QString p, s;
    if( value() > 0 || prefix2.isNull() ) p = prefix1;
    else                                  p = prefix2;
 
    if( value() > 0 || suffix2.isNull() ) s = suffix1;
    else                                  s = suffix2;
    
    //construct tipstring
    tipString = QString("%1%2%3").arg(p).arg(mapValToString()).arg(s);
    
  }
 
  //update tooltip
  tooltip->setText( tipString );
  tooltip->adjustSize();
  if( tooltip->isShown() ) qApp->processEvents();
}

References mapValToString(), prefix1, prefix2, suffix1, suffix2, tooltip, and zeroString.

Referenced by DynamicSlider(), setPrefix(), setPrefixes(), setSuffix(), setSuffixes(), and setZeroString().

Member Data Documentation

cachedMousePos

QPoint DynamicSlider::cachedMousePos

private

Definition at line 63 of file dynamicSlider.h.

Referenced by getMousePos(), and mouseMoveEvent().

prefix1

QString DynamicSlider::prefix1

private

Definition at line 59 of file dynamicSlider.h.

Referenced by setPrefix(), setPrefixes(), and updateTooltipLabel().

prefix2

QString DynamicSlider::prefix2

private

Definition at line 59 of file dynamicSlider.h.

Referenced by setPrefix(), setPrefixes(), and updateTooltipLabel().

suffix1

QString DynamicSlider::suffix1

private

Definition at line 60 of file dynamicSlider.h.

Referenced by setSuffix(), setSuffixes(), and updateTooltipLabel().

suffix2

QString DynamicSlider::suffix2

private

Definition at line 60 of file dynamicSlider.h.

Referenced by setSuffix(), setSuffixes(), and updateTooltipLabel().

tooltip

SliderToolTip* DynamicSlider::tooltip

private

Definition at line 62 of file dynamicSlider.h.

Referenced by DynamicSlider(), updateTooltipLabel(), and ~DynamicSlider().

zeroString

QString DynamicSlider::zeroString

private

Definition at line 57 of file dynamicSlider.h.

Referenced by setZeroString(), and updateTooltipLabel().

---

The documentation for this class was generated from the following files:

• dynamicSlider.h
• dynamicSlider.cpp