class KDoubleNumInput

Public Methods

•  KDoubleNumInput (QWidget *parent=0, const char *name=0)
•  KDoubleNumInput (double value, QWidget *parent=0, const char *name=0)
•  KDoubleNumInput (double lower, double upper, double value, double step=0.01, int precision=2, QWidget *parent=0, const char *name=0)
• virtual  ~KDoubleNumInput ()
•  KDoubleNumInput (KNumInput* below, double value, QWidget* parent=0, const char* name=0)
•  KDoubleNumInput (KNumInput* below, double lower, double upper, double value, double step=0.02, int precision=2, QWidget *parent=0, const char *name=0)
• double  value () const
• QString  suffix () const
• QString  prefix () const
• int  precision () const
• QString  specialValueText () const
• void  setRange (double min, double max, double step=1, bool slider=true)
• void  setMinValue (double min)
• double  minValue () const
• void  setMaxValue (double max)
• double  maxValue () const
• void  setPrecision (int precision)
• double  referencePoint () const
• double  relativeValue () const
• void  setSpecialValueText (const QString& text)

Public Slots

• void  setValue (double)
• void  setRelativeValue (double)
• void  setReferencePoint (double ref)
• void  setSuffix (const QString &suffix)
• void  setPrefix (const QString &prefix)

Signals

• void  valueChanged (double)
• void  relativeValueChanged (double)

Protected Methods

• virtual void  resetEditBox ()
• virtual void  virtual_hook ( int id, void* data )

Protected Members

• KDoubleLine* edit
• bool m_range
• double m_lower
• double m_upper
• double m_step
• QSize m_sizeEdit
• friend class KDoubleLine

Detailed Description

KDoubleNumInput combines a QSpinBox and optionally a QSlider with a label to make an easy to use control for setting some float parameter. This is especially nice for configuration dialogs, which can have many such combinated controls.

The slider is created only when the user specifies a range for the control using the setRange function with the slider parameter set to "true".

A special feature of KDoubleNumInput, designed specifically for the situation when there are several instances in a column, is that you can specify what portion of the control is taken by the QSpinBox (the remaining portion is used by the slider). This makes it very simple to have all the sliders in a column be the same size.

It uses the KDoubleValidator validator class. KDoubleNumInput enforces the value to be in the given range, but see the class documentation of KDoubleSpinBox for the tricky interrelationship of precision and values. All of what is said there applies here, too.

See also: KIntNumInput, KDoubleSpinBox

Constructs an input control for double values with initial value 0.00.

Constructor

Parameters:

value	initial value for the control
parent	parent QWidget
name	internal name for this widget

Constructor

Parameters:

lower	lower boundary value
upper	upper boundary value
value	initial value for the control
step	step size to use for up/down arrow clicks
precision	number of digits after the decimal point
parent	parent QWidget
name	internal name for this widget

[virtual]

destructor

Constructor

puts it below other KNumInput

Parameters:

value	initial value for the control
parent	parent QWidget
name	internal name for this widget

Constructor

puts it below other KNumInput

Parameters:

lower	lower boundary value
upper	upper boundary value
value	initial value for the control
step	step size to use for up/down arrow clicks
precision	number of digits after the decimal point
parent	parent QWidget
name	internal name for this widget

[const]

Returns: the current value.

[const]

Returns: the suffix.

See also: setSuffix()

[const]

Returns: the prefix.

See also: setPrefix()

[const]

Returns: the precision.

See also: setPrecision()

[const]

Returns: the string displayed for a special value.

See also: setSpecialValueText()

Parameters:

min	minimum value
max	maximum value
step	step size for the QSlider

Sets the minimum value.

[const]

Returns: the minimum value.

Sets the maximum value.

[const]

Returns: the maximum value.

Specifies the number of digits to use.

[const]

Returns: the reference point for relativeValue calculation

[const]

Returns: the current value in units of referencePoint.

Sets the special value text. If set, the spin box will display this text instead of the numeric value whenever the current value is equal to minVal(). Typically this is used for indicating that the choice has a special (default) meaning.

[virtual]

Reimplemented from KNumInput for internal purposes..

[const virtual]

[virtual]

[slot]

Sets the value of the control.

[slot]

Sets the value in units of referencePoint.

[slot]

Sets the reference Point to ref. It ref == 0, emitting of relativeValueChanged is blocked and relativeValue just returns 0.

[slot]

Sets the suffix to be displayed to suffix. Use QString::null to disable this feature. Note that the suffix is attached to the value without any spacing. So if you prefer to display a space separator, set suffix to something like " cm".

See also: setSuffix()

[slot]

Sets the prefix to be displayed to prefix. Use QString::null to disable this feature. Note that the prefix is attached to the value without any spacing.

See also: setPrefix()

[signal]

Emitted every time the value changes (by calling setValue() or by user interaction).

[signal]

This is an overloaded member function, provided for convenience. It essentially behaves like the above function.

Contains the value in units of referencePoint.

[protected virtual]

Reimplemented from KNumInput for internal purposes..

[protected]

[protected virtual]

[protected]

[protected]

[protected]

[protected]

[protected]

[protected]

[protected]

[protected virtual]

Reimplemented from KNumInput.