QwtCounter(3)

📦

version 6.3.0 · 6 versions

QwtCounter(3) 💅 — Library Functions Manual ✨

okay bestie, welcome to the Library Functions Manual page for QwtCounter — literally the Counter Widget. it’s giving “number go up, number go down” but make it Qt 🎀

🌸 NAME 🌸

QwtCounter — The Counter Widget.

✨ SYNOPSIS ✨

#include <qwt_counter.h>

Inherits QWidget.

🎀 Public Types 🎀

enum Button { Button1, Button2, Button3, ButtonCnt } — Button index.

💅 Public Slots 💅

void setValue (double) — Set a new value without adjusting to the step raster.

🫶 Signals 🫶

void buttonReleased (double value)
void valueChanged (double value)

🌈 Public Member Functions 🌈

QwtCounter (QWidget *parent=NULL)
virtual ~QwtCounter () — Destructor.
void setValid (bool)
bool isValid () const
void setWrapping (bool) — En/Disable wrapping.
bool wrapping () const
bool isReadOnly () const
void setReadOnly (bool) — Allow/disallow the user to manually edit the value.
void setNumButtons (int)
int numButtons () const
void setIncSteps (QwtCounter::Button, int numSteps)
int incSteps (QwtCounter::Button) const
virtual QSize sizeHint () const override — A size hint.
double singleStep () const
void setSingleStep (double stepSize) — Set the step size of the counter.
void setRange (double min, double max) — Set the minimum and maximum values.
double minimum () const
void setMinimum (double)
double maximum () const
void setMaximum (double)
void setStepButton1 (int nSteps)
int stepButton1 () const — returns the number of increment steps for button 1
void setStepButton2 (int nSteps)
int stepButton2 () const — returns the number of increment steps for button 2
void setStepButton3 (int nSteps)
int stepButton3 () const — returns the number of increment steps for button 3
double value () const

🧚 Protected Member Functions 🧚

virtual bool event (QEvent *) override
virtual void wheelEvent (QWheelEvent *) override
virtual void keyPressEvent (QKeyEvent *) override

👑 Detailed Description 👑

The Counter Widget.

A Counter consists of a label displaying a number and one ore more (up to three) push buttons on each side of the label, and those buttons can be used to increment or decrement the counter’s value. ✨

A counter has a range from a minimum value to a maximum value and a step size. When the wrapping property is set, the counter is circular. 🌀

The number of steps by which a button increments or decrements the value can be specified using setIncSteps(). The number of buttons can be changed with setNumButtons().

Example:

#include <qwt_counter.h>

  QwtCounter *counter = new QwtCounter(parent);

  counter->setRange(0.0, 100.0);                  // From 0.0 to 100
  counter->setSingleStep( 1.0 );                  // Step size 1.0
  counter->setNumButtons(2);                      // Two buttons each side
  counter->setIncSteps(QwtCounter::Button1, 1);   // Button 1 increments 1 step
  counter->setIncSteps(QwtCounter::Button2, 20);  // Button 2 increments 20 steps

  connect(counter, SIGNAL(valueChanged(double)), myClass, SLOT(newValue(double)));

Definition at line 48 of file qwt_counter.h.

💖 Member Enumeration Documentation 💖

enum QwtCounter::Button

Button index.

Enumerator:

Button1 — Button intended for minor steps.
Button2 — Button intended for medium steps.
Button3 — Button intended for large steps.
ButtonCnt — Number of buttons.

Definition at line 67 of file qwt_counter.h.

🌸 Constructor & Destructor Documentation 🌸

QwtCounter::QwtCounter (QWidget * parent = NULL) [explicit]

The counter is initialized with a range set to [0.0, 1.0] with 0.01 as single step size. The value is invalid.

The default number of buttons is set to 2. The default increments are:

Button 1: 1 step
Button 2: 10 steps
Button 3: 100 steps

Parameters

parent

Definition at line 65 of file qwt_counter.cpp.

QwtCounter::~QwtCounter () [virtual]

Destructor.

Definition at line 127 of file qwt_counter.cpp.

💖 MEMBER FUNCTION DOCUMENTATION 💖

okay bestie, this is the member-function part of the page, and it is stacked — every function, every line number, every little “see also” is coming with us. no cap 💅

💅 `void QwtCounter::buttonReleased (double value)` [signal]

This signal is emitted when a button has been released 🎀

Parameters: value — The new value

🌸 **`bool QwtCounter::event (QEvent * event)`** [override], [protected], [virtual]

Handle QEvent::PolishRequest events ✨

Parameters: event — Event
Returns: see QWidget::event()

📍 Definition at line 485 of file qwt_counter.cpp.

🦋 `int QwtCounter::incSteps (QwtCounter::Button button) const`

Returns: The number of steps by which a specified button increments the value or 0 if the button is invalid.
Parameters: button — Button index

See also: setIncSteps()

📍 Definition at line 416 of file qwt_counter.cpp.

🎀 `bool QwtCounter::isReadOnly () const`

Returns: True, when the line line edit is read only. (default is no)

See also: setReadOnly()

📍 Definition at line 186 of file qwt_counter.cpp.

✨ `bool QwtCounter::isValid () const`

Returns: True, if the value is valid

See also: setValid(), setValue()

📍 Definition at line 166 of file qwt_counter.cpp.

🧚 **`void QwtCounter::keyPressEvent (QKeyEvent * event)`** [override], [protected], [virtual]

Handle key events, bestie — these are the keyboard shortcuts and they are very specific 👑

Ctrl + Qt::Key_Home — Step to minimum()
Ctrl + Qt::Key_End — Step to maximum()
Qt::Key_Up — Increment by incSteps(QwtCounter::Button1)
Qt::Key_Down — Decrement by incSteps(QwtCounter::Button1)
Qt::Key_PageUp — Increment by incSteps(QwtCounter::Button2)
Qt::Key_PageDown — Decrement by incSteps(QwtCounter::Button2)
Shift + Qt::Key_PageUp — Increment by incSteps(QwtCounter::Button3)
Shift + Qt::Key_PageDown — Decrement by incSteps(QwtCounter::Button3)
Parameters: event — Key event

📍 Definition at line 524 of file qwt_counter.cpp.

💜 `double QwtCounter::maximum () const`

Returns: The maximum of the range

See also: setRange(), setMaximum(), minimum()

📍 Definition at line 306 of file qwt_counter.cpp.

🌈 `double QwtCounter::minimum () const`

Returns: The minimum of the range

See also: setRange(), setMinimum(), maximum()

📍 Definition at line 286 of file qwt_counter.cpp.

🫶 `int QwtCounter::numButtons () const`

Returns: The number of buttons on each side of the widget.

See also: setNumButtons()

📍 Definition at line 388 of file qwt_counter.cpp.

💖 `void QwtCounter::setIncSteps (QwtCounter::Button button, int numSteps)`

Specify the number of steps by which the value is incremented or decremented when a specified button is pushed, fr fr ✨

Parameters: button — Button index
Parameters: numSteps — Number of steps

See also: incSteps()

📍 Definition at line 403 of file qwt_counter.cpp.

🔥 `void QwtCounter::setMaximum (double value)`

Set the maximum value of the range 💅

Parameters: value — Maximum value

See also: setRange(), setMinimum(), maximum()

📍 Definition at line 297 of file qwt_counter.cpp.

🌸 `void QwtCounter::setMinimum (double value)`

Set the minimum value of the range 🎀

Parameters: value — Minimum value

See also: setRange(), setMaximum(), minimum()

Note: The maximum is adjusted if necessary to ensure that the range remains valid.

📍 Definition at line 277 of file qwt_counter.cpp.

🦋 `void QwtCounter::setNumButtons (int numButtons)`

Specify the number of buttons on each side of the label ✨

Parameters: numButtons — Number of buttons

See also: numButtons()

📍 Definition at line 362 of file qwt_counter.cpp.

👑 `void QwtCounter::setRange (double min, double max)`

Set the minimum and maximum values. The maximum is adjusted if necessary to ensure that the range remains valid. The value might be modified to be inside of the range 😭

Parameters: min — Minimum value
Parameters: max — Maximum value

See also: minimum(), maximum()

📍 Definition at line 241 of file qwt_counter.cpp.

💀 `void QwtCounter::setReadOnly (bool on)`

Allow/disallow the user to manually edit the value. main character control energy 🫶

Parameters: on — True disable editing

See also: isReadOnly()

📍 Definition at line 177 of file qwt_counter.cpp.

⭐ `void QwtCounter::setSingleStep (double stepSize)`

Set the step size of the counter. A value <= 0.0 disables stepping, so be careful with that one 🚨

Parameters: stepSize — Single step size

See also: singleStep()

📍 Definition at line 319 of file qwt_counter.cpp.

🍓 `void QwtCounter::setStepButton1 (int nSteps)`

Set the number of increment steps for button 1 💅

Parameters: nSteps — Number of steps

📍 Definition at line 429 of file qwt_counter.cpp.

🧚 `void QwtCounter::setStepButton2 (int nSteps)`

Set the number of increment steps for button 2 ✨

Parameters: nSteps — Number of steps

📍 Definition at line 444 of file qwt_counter.cpp.

💜 `void QwtCounter::setStepButton3 (int nSteps)`

Set the number of increment steps for button 3 🎀

Parameters: nSteps — Number of steps

📍 Definition at line 459 of file qwt_counter.cpp.

🌟 `void QwtCounter::setValid (bool on)`

Set the counter to be in valid/invalid state ✨

When the counter is set to invalid, no numbers are displayed and the buttons are disabled. it’s giving “ghosted but make it UI” 💀

Parameters: on — If true the counter will be set as valid

See also: setValue(), isValid()

📍 Definition at line 142 of file qwt_counter.cpp.

🎀 `void QwtCounter::setValue (double value)` [slot]

Set a new value without adjusting to the step raster. The state of the counter is set to be valid 💖

Parameters: value — New value

See also: isValid(), value(), valueChanged()

Warning: The value is clipped when it lies outside the range.

📍 Definition at line 202 of file qwt_counter.cpp.

🌈 `void QwtCounter::setWrapping (bool on)`

En/Disable wrapping. If wrapping is true stepping up from maximum() value will take you to the minimum() value and vice versa 🔁✨

Parameters: on — En/Disable wrapping

See also: wrapping()

📍 Definition at line 342 of file qwt_counter.cpp.

🫶 `double QwtCounter::singleStep () const`

Returns: Single step size

See also: setSingleStep()

📍 Definition at line 328 of file qwt_counter.cpp.

💅 `QSize QwtCounter::sizeHint () const` [override], [virtual]

A size hint 🎀

📍 Definition at line 759 of file qwt_counter.cpp.

✨ `int QwtCounter::stepButton1 () const`

returns the number of increment steps for button 1

📍 Definition at line 435 of file qwt_counter.cpp.

🌸 `int QwtCounter::stepButton2 () const`

returns the number of increment steps for button 2

📍 Definition at line 450 of file qwt_counter.cpp.

🦋 `int QwtCounter::stepButton3 () const`

returns the number of increment steps for button 3

📍 Definition at line 465 of file qwt_counter.cpp.

💖 `double QwtCounter::value () const`

Returns: Current value of the counter

See also: setValue(), valueChanged()

📍 Definition at line 225 of file qwt_counter.cpp.

🔥 `void QwtCounter::valueChanged (double value)` [signal]

This signal is emitted when the counter's value has changed 👑

Parameters: value — The new value

🧚 **`void QwtCounter::wheelEvent (QWheelEvent * event)`** [override], [protected], [virtual]

Handle wheel events, bestie — the scroll wheel said “i have lore” 😭

Parameters: event — Wheel event

📍 Definition at line 591 of file qwt_counter.cpp.

🌟 `bool QwtCounter::wrapping () const`

Returns: True, when wrapping is set

See also: setWrapping()

📍 Definition at line 351 of file qwt_counter.cpp.

🌸 AUTHOR 🌸

Generated automatically by Doxygen for Qwt User's Guide from the source code.

and that’s the page, bestie 💖 big cute sign-off to the Qwt User's Guide source/version and the QwtCounter(3) page — date: whatever the footer says, mwah 💋✨

📦 where this page comes from

alpine 3.24: qwt-doc 6.3.0-r0 · custom
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms

QwtCounter(3)

QwtCounter(3) 💅 — Library Functions Manual ✨

🌸 NAME 🌸

✨ SYNOPSIS ✨

🎀 Public Types 🎀

💅 Public Slots 💅

🫶 Signals 🫶

🌈 Public Member Functions 🌈

🧚 Protected Member Functions 🧚

👑 Detailed Description 👑

💖 Member Enumeration Documentation 💖

enum QwtCounter::Button

🌸 Constructor & Destructor Documentation 🌸

QwtCounter::QwtCounter (QWidget * parent = NULL) [explicit]

QwtCounter::~QwtCounter () [virtual]

💖 MEMBER FUNCTION DOCUMENTATION 💖

💅 void QwtCounter::buttonReleased (double value) [signal]

🌸 bool QwtCounter::event (QEvent * event) [override], [protected], [virtual]

🦋 int QwtCounter::incSteps (QwtCounter::Button button) const

🎀 bool QwtCounter::isReadOnly () const

✨ bool QwtCounter::isValid () const

🧚 void QwtCounter::keyPressEvent (QKeyEvent * event) [override], [protected], [virtual]

💜 double QwtCounter::maximum () const

🌈 double QwtCounter::minimum () const

🫶 int QwtCounter::numButtons () const

💖 void QwtCounter::setIncSteps (QwtCounter::Button button, int numSteps)

🔥 void QwtCounter::setMaximum (double value)

🌸 void QwtCounter::setMinimum (double value)

🦋 void QwtCounter::setNumButtons (int numButtons)

👑 void QwtCounter::setRange (double min, double max)

💀 void QwtCounter::setReadOnly (bool on)

⭐ void QwtCounter::setSingleStep (double stepSize)

🍓 void QwtCounter::setStepButton1 (int nSteps)

🧚 void QwtCounter::setStepButton2 (int nSteps)

💜 void QwtCounter::setStepButton3 (int nSteps)

🌟 void QwtCounter::setValid (bool on)

🎀 void QwtCounter::setValue (double value) [slot]

🌈 void QwtCounter::setWrapping (bool on)

🫶 double QwtCounter::singleStep () const

💅 QSize QwtCounter::sizeHint () const [override], [virtual]

✨ int QwtCounter::stepButton1 () const

🌸 int QwtCounter::stepButton2 () const

🦋 int QwtCounter::stepButton3 () const

💖 double QwtCounter::value () const

🔥 void QwtCounter::valueChanged (double value) [signal]

🧚 void QwtCounter::wheelEvent (QWheelEvent * event) [override], [protected], [virtual]

🌟 bool QwtCounter::wrapping () const