QwtSlider(3)

📦
version 6.3.0 · 6 versions
, in alpine 3.24

🎀 QwtSlider(3) — The Slider Widget 🎀

okay so bestie, this is QwtSlider(3) out of the Library Functions Manual, and it's honestly a whole vibe. It's a slider widget. A fancy slider widget. Let's get into it 💅✨

🌸 NAME 🌸

QwtSlider — the Slider Widget. that's it, that's the name, main character energy fr fr 👑

🦋 SYNOPSIS 🦋

#include <qwt_slider.h>

It Inherits QwtAbstractSlider — so like, it's got the whole family tree going on, iykyk.

🌈 Public Types 🌈

enum ScalePosition { NoScale, LeadingScale, TrailingScale }

three positions, three moods, pick your fave ✨

💖 Public Member Functions 💖

okay this list is kinda long but every single one matters, no skipping, we're doing this properly 🫶

  • QwtSlider(QWidget *parent=NULL)
  • QwtSlider(Qt::Orientation, QWidget *parent=NULL)
  • virtual ~QwtSlider() — Destructor. bye bestie 😭
  • void setOrientation(Qt::Orientation) — Set the orientation. like, which way is it even going
  • Qt::Orientation orientation() const
  • void setScalePosition(ScalePosition) — Change the position of the scale.
  • ScalePosition scalePosition() const
  • void setTrough(bool)
  • bool hasTrough() const
  • void setGroove(bool)
  • bool hasGroove() const
  • void setHandleSize(const QSize &) — Set the slider's handle size. give the handle the size it deserves 💅
  • QSize handleSize() const
  • void setBorderWidth(int) — Change the slider's border width.
  • int borderWidth() const
  • void setSpacing(int) — Change the spacing between trough and scale.
  • int spacing() const
  • virtual QSize sizeHint() const override
  • virtual QSize minimumSizeHint() const override
  • void setScaleDraw(QwtScaleDraw *) — Set a scale draw.
  • const QwtScaleDraw * scaleDraw() const
  • void setUpdateInterval(int) — Specify the update interval for automatic scrolling.
  • int updateInterval() const

🧚 Public Member Functions inherited from QwtAbstractSlider 🧚

the inherited era, we respect it 💜

  • QwtAbstractSlider(QWidget *parent=NULL) — Constructor.
  • virtual ~QwtAbstractSlider() — Destructor.
  • void setValid(bool)
  • bool isValid() const
  • double value() const — Returns the current value.
  • void setWrapping(bool)
  • bool wrapping() const
  • void setTotalSteps(uint) — Set the number of steps.
  • uint totalSteps() const
  • void setSingleSteps(uint) — Set the number of steps for a single increment.
  • uint singleSteps() const
  • void setPageSteps(uint) — Set the number of steps for a page increment.
  • uint pageSteps() const
  • void setStepAlignment(bool) — Enable step alignment.
  • bool stepAlignment() const
  • void setTracking(bool) — Enables or disables tracking.
  • bool isTracking() const
  • void setReadOnly(bool)
  • bool isReadOnly() const
  • void setInvertedControls(bool)
  • bool invertedControls() const

🍓 Public Member Functions inherited from QwtAbstractScale 🍓

more inherited icons, we love a legacy ✨

  • QwtAbstractScale(QWidget *parent=NULL)
  • virtual ~QwtAbstractScale() — Destructor.
  • void setScale(double lowerBound, double upperBound) — Specify a scale.
  • void setScale(const QwtInterval &) — Specify a scale.
  • void setScale(const QwtScaleDiv &) — Specify a scale.
  • const QwtScaleDiv & scaleDiv() const
  • void setLowerBound(double value)
  • double lowerBound() const
  • void setUpperBound(double value)
  • double upperBound() const
  • void setScaleStepSize(double stepSize) — Set the step size used for calculating a scale division.
  • double scaleStepSize() const
  • void setScaleMaxMajor(int ticks) — Set the maximum number of major tick intervals.
  • int scaleMaxMinor() const
  • void setScaleMaxMinor(int ticks) — Set the maximum number of minor tick intervals.
  • int scaleMaxMajor() const
  • void setScaleEngine(QwtScaleEngine *) — Set a scale engine.
  • const QwtScaleEngine * scaleEngine() const
  • QwtScaleEngine * scaleEngine()
  • int transform(double) const
  • double invTransform(int) const
  • bool isInverted() const
  • double minimum() const
  • double maximum() const
  • const QwtScaleMap & scaleMap() const

💀 Protected Member Functions 💀

the protected era — lowkey exclusive, but we're gonna show u anyway 🤫

  • virtual double scrolledTo(const QPoint &) const override — Determine the value for a new position of the slider handle.
  • virtual bool isScrollPosition(const QPoint &) const override — Determine what to do when the user presses a mouse button.
  • virtual void drawSlider(QPainter *, const QRect &) const
  • virtual void drawHandle(QPainter *, const QRect &, int pos) const
  • virtual void mousePressEvent(QMouseEvent *) override
  • virtual void mouseReleaseEvent(QMouseEvent *) override
  • virtual void resizeEvent(QResizeEvent *) override
  • virtual void paintEvent(QPaintEvent *) override
  • virtual void changeEvent(QEvent *) override
  • virtual void timerEvent(QTimerEvent *) override
  • virtual bool event(QEvent *) override
  • virtual void scaleChange() override — Notify changed scale.
  • QRect sliderRect() const
  • QRect handleRect() const

🌟 Protected Member Functions inherited from QwtAbstractSlider 🌟

  • virtual void mouseMoveEvent(QMouseEvent *) override
  • virtual void keyPressEvent(QKeyEvent *) override
  • virtual void wheelEvent(QWheelEvent *) override
  • void incrementValue(int stepCount)
  • virtual void sliderChange() — Calling update().
  • double incrementedValue(double value, int stepCount) const

🎀 Protected Member Functions inherited from QwtAbstractScale 🎀

  • void rescale(double lowerBound, double upperBound, double stepSize)
  • void setAbstractScaleDraw(QwtAbstractScaleDraw *) — Set a scale draw.
  • const QwtAbstractScaleDraw * abstractScaleDraw() const
  • QwtAbstractScaleDraw * abstractScaleDraw()
  • void updateScaleDraw()

⭐ Additional Inherited Members ⭐

💅 Public Slots inherited from QwtAbstractSlider 💅

  • void setValue(double value)

🔥 Signals inherited from QwtAbstractSlider 🔥

  • void valueChanged(double value) — Notify a change of value.
  • void sliderPressed()
  • void sliderReleased()
  • void sliderMoved(double value)

🌸 Detailed Description 🌸

The Slider Widget.

QwtSlider is a slider widget which operates on an interval of type double. Its position is related to a scale showing the current value. lowkey iconic how it just… knows where it is 💫

The slider can be customized by having a through, a groove — or both. yes bestie, u can have both. we're not gatekeeping 🙌

Definition at line 30 of file qwt_slider.h. (iykyk, the receipts are right there 📍)

🦋 Member Enumeration Documentation 🦋

enum QwtSlider::ScalePosition

Position of the scale. it's giving placement era 💅

See also: QwtSlider(), setScalePosition(), setOrientation()

Enumerator

  • NoScale — The slider has no scale. minimalism, we respect it.
  • LeadingScale — The scale is right of a vertical slider, or below a horizontal slider.
  • TrailingScale — The scale is left of a vertical slider, or above a horizontal slider.
Definition at line 54 of file qwt_slider.h.

🎀 Constructor & Destructor Documentation 🎀

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

Constructs a vertical slider in QwtSlider::Trough style, with a scale to the left. the og setup fr fr.

The scale is initialized to [0.0, 100.0] and the value set to 0.0. clean slate, fresh start, we love to see it ✨

Parameters:

  • parent — Parent widget.

See also: setOrientation(), setScalePosition(), setBackgroundStyle()

Definition at line 119 of file qwt_slider.cpp.

QwtSlider::QwtSlider(Qt::Orientation orientation, QWidget * parent = NULL) [explicit]

Constructs a slider in QwtSlider::Trough style. ok so it's the same trough vibe, but now u get to pick the orientation 👑

When orientation is Qt::Vertical the scale will be aligned to the left — otherwise it ends up at the top of the slider.

The scale is initialized to [0.0, 100.0] and the value set to 0.0. same fresh-start energy, no cap 💖

Parameters:

  • parent — Parent widget.
  • orientation — Orientation of the slider.
Definition at line 136 of file qwt_slider.cpp.

QwtSlider::~QwtSlider() [virtual]

Destructor. it's the goodbye era 😭💔

Definition at line 143 of file qwt_slider.cpp.

💅 MEMBER FUNCTION DOCUMENTATION 💅

🎀 int QwtSlider::borderWidth () const 🎀

Bestie, this one just hands you the border width. That's it. Iconic minimalism.

  • Returns — the border width.
  • See also: setBorderWidth()
  • Definition: Definition at line 262 of file qwt_slider.cpp.

🎀 void QwtSlider::changeEvent (QEvent * event) 🎀

[override], [protected], [virtual]

This is the event handler that handles QEvent::StyleChange and QEvent::FontChange events. It's giving "I notice when the vibe shifts."

  • Parameters
    • event — Change event
  • Reimplemented from QwtAbstractScale.
  • Definition: Definition at line 724 of file qwt_slider.cpp.

🎀 void QwtSlider::drawHandle (QPainter * painter, const QRect & handleRect, int pos) const 🎀

[protected], [virtual]

Draws the thumb at a position. Very "main character marker energy."

  • Parameters
    • painter — Painter
    • handleRect — Bounding rectangle of the handle
    • pos — Position of the handle marker in widget coordinates
  • Definition: Definition at line 473 of file qwt_slider.cpp.

🎀 void QwtSlider::drawSlider (QPainter * painter, const QRect & sliderRect) const 🎀

[protected], [virtual]

Draws the slider into the specified rectangle. Slay, but rectangle-bound.

  • Parameters
    • painter — Painter
    • sliderRect — Bounding rectangle of the slider
  • Definition: Definition at line 415 of file qwt_slider.cpp.

🎀 bool QwtSlider::event (QEvent * event) 🎀

[override], [protected], [virtual]

Qt event handler. It's the bouncer at the event club.

  • Parameters
    • event — Event
  • Returns — true, if event was recognized and processed
  • Definition: Definition at line 712 of file qwt_slider.cpp.

🎀 QRect QwtSlider::handleRect () const 🎀

[protected]

Gives you the bounding rectangle of the slider handle. Lowkey useful for knowing where the handle is living.

  • Returns — Bounding rectangle of the slider handle
  • Definition: Definition at line 990 of file qwt_slider.cpp.

🎀 QSize QwtSlider::handleSize () const 🎀

Returns the size of the handle. Not too big, not too small — just handle-sized.

  • Returns — Size of the handle.
  • See also: setHandleSize()
  • Definition: Definition at line 326 of file qwt_slider.cpp.

🎀 bool QwtSlider::hasGroove () const 🎀

Returns True, when the groove is visible. Groove check: passed. 💅

  • Returns — True, when the groove is visible
  • See also: setGroove(), hasTrough()
  • Definition: Definition at line 904 of file qwt_slider.cpp.

🎀 bool QwtSlider::hasTrough () const 🎀

Returns True, when the trough is visible. Trough check: also passed.

  • Returns — True, when the trough is visible
  • See also: setTrough(), hasGroove()
  • Definition: Definition at line 875 of file qwt_slider.cpp.

🎀 bool QwtSlider::isScrollPosition (const QPoint & pos) const 🎀

[override], [protected], [virtual]

Determines what to do when the user presses a mouse button. Basically: "is this mouse press on the handle, or are we somewhere else?"

  • Parameters
    • pos — Mouse position
  • Return values — True,when handleRect() contains pos
  • See also: scrolledTo()
  • Implements QwtAbstractSlider.
  • Definition: Definition at line 503 of file qwt_slider.cpp.

🎀 QSize QwtSlider::minimumSizeHint () const 🎀

[override], [virtual]

Returns the minimum size hint. The "smallest acceptable version of me" vibe.

  • Returns — Minimum size hint
  • See also: sizeHint()
  • Definition: Definition at line 922 of file qwt_slider.cpp.

🎀 void QwtSlider::mousePressEvent (QMouseEvent * event) 🎀

[override], [protected], [virtual]

Mouse press event handler. The moment the mouse goes click.

  • Parameters
    • event — Mouse event
  • Reimplemented from QwtAbstractSlider.
  • Definition: Definition at line 547 of file qwt_slider.cpp.

🎀 void QwtSlider::mouseReleaseEvent (QMouseEvent * event) 🎀

[override], [protected], [virtual]

Mouse release event handler. The click's graceful exit.

  • Parameters
    • event — Mouse event
  • Reimplemented from QwtAbstractSlider.
  • Definition: Definition at line 606 of file qwt_slider.cpp.

🎀 Qt::Orientation QwtSlider::orientation () const 🎀

Returns the orientation. Horizontal? Vertical? The slider knows its lane.

  • Returns — Orientation
  • See also: setOrientation()
  • Definition: Definition at line 202 of file qwt_slider.cpp.

🎀 void QwtSlider::paintEvent (QPaintEvent * event) 🎀

[override], [protected], [virtual]

Qt paint event handler. Time to serve looks on screen.

  • Parameters
    • event — Paint event
  • Definition: Definition at line 675 of file qwt_slider.cpp.

🎀 void QwtSlider::resizeEvent (QResizeEvent * event) 🎀

[override], [protected], [virtual]

Qt resize event handler. When the widget changes shape, this handles the glow-up.

  • Parameters
    • event — Resize event
  • Definition: Definition at line 700 of file qwt_slider.cpp.

🎀 void QwtSlider::scaleChange () 🎀

[override], [protected], [virtual]

Notify changed scale. It's the "hey bestie, the scale changed" announcement.

  • Reimplemented from QwtAbstractSlider.
  • Definition: Definition at line 378 of file qwt_slider.cpp.

🎀 const QwtScaleDraw * QwtSlider::scaleDraw () const 🎀

Returns the scale draw of the slider. The visual blueprint of the scale, basically.

  • Returns — the scale draw of the slider
  • See also: setScaleDraw()
  • Definition: Definition at line 363 of file qwt_slider.cpp.

🎀 QwtSlider::ScalePosition QwtSlider::scalePosition () const 🎀

Returns the position of the scale. Where the scale is sitting, exactly.

  • Returns — Position of the scale
  • See also: setScalePosition()
  • Definition: Definition at line 230 of file qwt_slider.cpp.

🎀 double QwtSlider::scrolledTo (const QPoint & pos) const 🎀

[override], [protected], [virtual]

Determines the value for a new position of the slider handle. Mouse moves, value follows. ✨

  • Parameters
    • pos — Mouse position
  • Returns — Value for the mouse position
  • See also: isScrollPosition()
  • Implements QwtAbstractSlider.
  • Definition: Definition at line 526 of file qwt_slider.cpp.

🎀 void QwtSlider::setBorderWidth (int width) 🎀

Changes the slider's border width. The border width is used for drawing the slider handle and the trough. It's the outfit's trim detail, honestly.

  • Parameters
    • width — Border width
  • See also: borderWidth()
  • Definition: Definition at line 244 of file qwt_slider.cpp.

🎀 void QwtSlider::setGroove (bool on) 🎀

En/Disable the groove. The slider can be customized by showing a groove for the handle. Groove on = little runway moment.

  • Parameters
    • on — When true, the groove is visible
  • See also: hasGroove(), setThrough()
  • Definition: Definition at line 889 of file qwt_slider.cpp.

🎀 void QwtSlider::setHandleSize (const QSize & size) 🎀

Set the slider's handle size. When the size is empty the slider handle will be painted with a default size depending on its orientation() and backgroundStyle().

  • Parameters
    • size — New size
  • See also: handleSize()
  • Definition: Definition at line 311 of file qwt_slider.cpp.

🎀 void QwtSlider::setOrientation (Qt::Orientation orientation) 🎀

Set the orientation. Allowed values are Qt::Horizontal and Qt::Vertical. Gotta pick a lane, bestie.

  • Parameters
    • orientation — Allowed values are Qt::Horizontal and Qt::Vertical.
  • See also: orientation(), scalePosition()
  • Definition: Definition at line 175 of file qwt_slider.cpp.

🎀 void QwtSlider::setScaleDraw (QwtScaleDraw * scaleDraw) 🎀

Set a scale draw. For changing the labels of the scales, it is necessary to derive from QwtScaleDraw and overload QwtScaleDraw::label().

  • Parameters
    • scaleDraw — ScaleDraw object, that has to be created with new and will be deleted in ~QwtSlider() or the next call of setScaleDraw().
  • See also: scaleDraw()
  • Definition: Definition at line 344 of file qwt_slider.cpp.

🎀 void QwtSlider::setScalePosition (ScalePosition scalePosition) 🎀

Change the position of the scale. Move over, scale — new spot just dropped.

  • Parameters
    • scalePosition — Position of the scale.
  • See also: ScalePosition, scalePosition()
  • Definition: Definition at line 213 of file qwt_slider.cpp.

🎀 void QwtSlider::setSpacing (int spacing) 🎀

Change the spacing between trough and scale. A spacing of 0 means, that the backbone of the scale is covered by the trough.

The default setting is 4 pixels.

  • Parameters
    • spacing — Number of pixels
  • See also: spacing();
  • Definition: Definition at line 278 of file qwt_slider.cpp.

🎀 void QwtSlider::setTrough (bool on) 🎀

En/Disable the trough. The slider can be customized by showing a trough for the handle.

  • Parameters
    • on — When true, the groove is visible
  • See also: hasTrough(), setGroove()
  • Definition: Definition at line 860 of file qwt_slider.cpp.

🎀 void QwtSlider::setUpdateInterval (int interval) 🎀

Specify the update interval for automatic scrolling. The minimal accepted value is 50 ms.

  • Parameters
    • interval — Update interval in milliseconds
  • See also: setUpdateInterval()
  • Definition: Definition at line 395 of file qwt_slider.cpp.

🎀 QSize QwtSlider::sizeHint () const 🎀

[override], [virtual]

Returns minimumSizeHint(). Yes, literally that. The size hint said "ask minimum size hint." Teamwork.

  • Returns — minimumSizeHint()
  • Definition: Definition at line 912 of file qwt_slider.cpp.

🎀 QRect QwtSlider::sliderRect () const 🎀

[protected]

Returns the bounding rectangle of the slider — without the scale. Just the slider's own personal space.

  • Returns — Bounding rectangle of the slider - without the scale
  • Definition: Definition at line 1014 of file qwt_slider.cpp.

🎀 int QwtSlider::spacing () const 🎀

Returns the number of pixels between slider and scale. Personal space, measured.

  • Returns — Number of pixels between slider and scale
  • See also: setSpacing()
  • Definition: Definition at line 296 of file qwt_slider.cpp.

🎀 void QwtSlider::timerEvent (QTimerEvent * event) 🎀

[override], [protected], [virtual]

Timer event handler. Handles the timer, when the mouse stays pressed inside the sliderRect().

  • Parameters
    • event — Mouse event
  • Definition: Definition at line 633 of file qwt_slider.cpp.

🎀 int QwtSlider::updateInterval () const 🎀

Returns the update interval in milliseconds for automatic scrolling. Automatic scrolling said "I have a schedule."

  • Returns — Update interval in milliseconds for automatic scrolling
  • See also: setUpdateInterval()
  • Definition: Definition at line 404 of file qwt_slider.cpp.

👑 AUTHOR 👑

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

💖 That's the whole page, bestie! Source/version vibes: Qwt User's Guide, QwtSlider(3), auto-generated by Doxygen for Qwt User's Guide from the source code. Date on the footer? Not printed in this excerpt, so I'm not inventing one — periodt. 🎀

📦 where this page comes from