Dhanya Thattil 38cd10d4e6
Qt5 built in qwt (#570)
- qt4->qt5
- in built qt5 6.1.5 because rhel7 is not upto date with qt5, removed findqwt.cmake
- made a fix in qwt lib (qwt_plot_layout.h) to work with 5.15 and lower versions for qrect constr.
- qt5 forms fixed, qt4 many hard coding forms switched to forms including qtabwidget, scrolls etc, fonts moved to forms
 - docking option enabled by default, removed option to disable docking feature from "Mode"
- added qVersionResolve utility functions to handle compatibility before and after qt5.12
- qtplots (ian's code) takes in gain mode enable to set some settings within the class, with proper gain plot ticks
- ensure gain plots have no zooming of z axis in 2d and y axis in 1d
- removed placeholder text in qpalette in main window form as its not supportd until 5.12 (so using qt5.9 designer insted of qt5.15 to cope)
- tab order
Servers:
- fixed some error messages that were empty for fail in funcs (mostly minor as if this error, major issues)
2022-11-11 15:15:10 +01:00

663 lines
12 KiB
Groff

.TH "QwtSlider" 3 "Mon Jun 1 2020" "Version 6.1.5" "Qwt User's Guide" \" -*- nroff -*-
.ad l
.nh
.SH NAME
QwtSlider \- The Slider Widget\&.
.SH SYNOPSIS
.br
.PP
.PP
\fC#include <qwt_slider\&.h>\fP
.PP
Inherits \fBQwtAbstractSlider\fP\&.
.SS "Public Types"
.in +1c
.ti -1c
.RI "enum \fBScalePosition\fP { \fBNoScale\fP, \fBLeadingScale\fP, \fBTrailingScale\fP }"
.br
.in -1c
.SS "Public Member Functions"
.in +1c
.ti -1c
.RI "\fBQwtSlider\fP (QWidget *parent=NULL)"
.br
.ti -1c
.RI "\fBQwtSlider\fP (Qt::Orientation, QWidget *parent=NULL)"
.br
.ti -1c
.RI "virtual \fB~QwtSlider\fP ()"
.br
.RI "Destructor\&. "
.ti -1c
.RI "void \fBsetOrientation\fP (Qt::Orientation)"
.br
.RI "Set the orientation\&. "
.ti -1c
.RI "Qt::Orientation \fBorientation\fP () const"
.br
.ti -1c
.RI "void \fBsetScalePosition\fP (\fBScalePosition\fP)"
.br
.RI "Change the position of the scale\&. "
.ti -1c
.RI "\fBScalePosition\fP \fBscalePosition\fP () const"
.br
.ti -1c
.RI "void \fBsetTrough\fP (bool)"
.br
.ti -1c
.RI "bool \fBhasTrough\fP () const"
.br
.ti -1c
.RI "void \fBsetGroove\fP (bool)"
.br
.ti -1c
.RI "bool \fBhasGroove\fP () const"
.br
.ti -1c
.RI "void \fBsetHandleSize\fP (const QSize &)"
.br
.RI "Set the slider's handle size\&. "
.ti -1c
.RI "QSize \fBhandleSize\fP () const"
.br
.ti -1c
.RI "void \fBsetBorderWidth\fP (int)"
.br
.RI "Change the slider's border width\&. "
.ti -1c
.RI "int \fBborderWidth\fP () const"
.br
.ti -1c
.RI "void \fBsetSpacing\fP (int)"
.br
.RI "Change the spacing between trough and scale\&. "
.ti -1c
.RI "int \fBspacing\fP () const"
.br
.ti -1c
.RI "virtual QSize \fBsizeHint\fP () const"
.br
.ti -1c
.RI "virtual QSize \fBminimumSizeHint\fP () const"
.br
.ti -1c
.RI "void \fBsetScaleDraw\fP (\fBQwtScaleDraw\fP *)"
.br
.RI "Set a scale draw\&. "
.ti -1c
.RI "const \fBQwtScaleDraw\fP * \fBscaleDraw\fP () const"
.br
.ti -1c
.RI "void \fBsetUpdateInterval\fP (int)"
.br
.RI "Specify the update interval for automatic scrolling\&. "
.ti -1c
.RI "int \fBupdateInterval\fP () const"
.br
.in -1c
.SS "Protected Member Functions"
.in +1c
.ti -1c
.RI "virtual double \fBscrolledTo\fP (const QPoint &) const"
.br
.RI "Determine the value for a new position of the slider handle\&. "
.ti -1c
.RI "virtual bool \fBisScrollPosition\fP (const QPoint &) const"
.br
.RI "Determine what to do when the user presses a mouse button\&. "
.ti -1c
.RI "virtual void \fBdrawSlider\fP (QPainter *, const QRect &) const"
.br
.ti -1c
.RI "virtual void \fBdrawHandle\fP (QPainter *, const QRect &, int pos) const"
.br
.ti -1c
.RI "virtual void \fBmousePressEvent\fP (QMouseEvent *)"
.br
.ti -1c
.RI "virtual void \fBmouseReleaseEvent\fP (QMouseEvent *)"
.br
.ti -1c
.RI "virtual void \fBresizeEvent\fP (QResizeEvent *)"
.br
.ti -1c
.RI "virtual void \fBpaintEvent\fP (QPaintEvent *)"
.br
.ti -1c
.RI "virtual void \fBchangeEvent\fP (QEvent *)"
.br
.ti -1c
.RI "virtual void \fBtimerEvent\fP (QTimerEvent *)"
.br
.ti -1c
.RI "virtual void \fBscaleChange\fP ()"
.br
.RI "Notify changed scale\&. "
.ti -1c
.RI "QRect \fBsliderRect\fP () const"
.br
.ti -1c
.RI "QRect \fBhandleRect\fP () const"
.br
.in -1c
.SS "Additional Inherited Members"
.SH "Detailed Description"
.PP
The Slider Widget\&.
\fBQwtSlider\fP is a slider widget which operates on an interval of type double\&. Its position is related to a scale showing the current value\&.
.PP
The slider can be customized by having a through, a groove - or both\&.
.PP
.SH "Member Enumeration Documentation"
.PP
.SS "enum \fBQwtSlider::ScalePosition\fP"
Position of the scale
.PP
\fBSee also\fP
.RS 4
\fBQwtSlider()\fP, \fBsetScalePosition()\fP, \fBsetOrientation()\fP
.RE
.PP
.PP
\fBEnumerator\fP
.in +1c
.TP
\fB\fINoScale \fP\fP
The slider has no scale\&.
.TP
\fB\fILeadingScale \fP\fP
The scale is right of a vertical or below a horizontal slider\&.
.TP
\fB\fITrailingScale \fP\fP
The scale is left of a vertical or above a horizontal slider\&.
.SH "Constructor & Destructor Documentation"
.PP
.SS "QwtSlider::QwtSlider (QWidget * parent = \fCNULL\fP)\fC [explicit]\fP"
Construct vertical slider in QwtSlider::Trough style with a scale to the left\&.
.PP
The scale is initialized to [0\&.0, 100\&.0] and the value set to 0\&.0\&.
.PP
\fBParameters\fP
.RS 4
\fIparent\fP Parent widget
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetOrientation()\fP, \fBsetScalePosition()\fP, setBackgroundStyle()
.RE
.PP
.SS "QwtSlider::QwtSlider (Qt::Orientation orientation, QWidget * parent = \fCNULL\fP)\fC [explicit]\fP"
Construct a slider in QwtSlider::Trough style
.PP
When orientation is Qt::Vertical the scale will be aligned to the left - otherwise at the the top of the slider\&.
.PP
The scale is initialized to [0\&.0, 100\&.0] and the value set to 0\&.0\&.
.PP
\fBParameters\fP
.RS 4
\fIparent\fP Parent widget
.br
\fIorientation\fP Orientation of the slider\&.
.RE
.PP
.SH "Member Function Documentation"
.PP
.SS "int QwtSlider::borderWidth () const"
.PP
\fBReturns\fP
.RS 4
the border width\&.
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetBorderWidth()\fP
.RE
.PP
.SS "void QwtSlider::changeEvent (QEvent * event)\fC [protected]\fP, \fC [virtual]\fP"
Handles QEvent::StyleChange and QEvent::FontChange events
.PP
\fBParameters\fP
.RS 4
\fIevent\fP Change event
.RE
.PP
.SS "void QwtSlider::drawHandle (QPainter * painter, const QRect & handleRect, int pos) const\fC [protected]\fP, \fC [virtual]\fP"
Draw the thumb at a position
.PP
\fBParameters\fP
.RS 4
\fIpainter\fP Painter
.br
\fIhandleRect\fP Bounding rectangle of the handle
.br
\fIpos\fP Position of the handle marker in widget coordinates
.RE
.PP
.SS "void QwtSlider::drawSlider (QPainter * painter, const QRect & sliderRect) const\fC [protected]\fP, \fC [virtual]\fP"
Draw the slider into the specified rectangle\&.
.PP
\fBParameters\fP
.RS 4
\fIpainter\fP Painter
.br
\fIsliderRect\fP Bounding rectangle of the slider
.RE
.PP
.SS "QRect QwtSlider::handleRect () const\fC [protected]\fP"
.PP
\fBReturns\fP
.RS 4
Bounding rectangle of the slider handle
.RE
.PP
.SS "QSize QwtSlider::handleSize () const"
.PP
\fBReturns\fP
.RS 4
Size of the handle\&.
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetHandleSize()\fP
.RE
.PP
.SS "bool QwtSlider::hasGroove () const"
.PP
\fBReturns\fP
.RS 4
True, when the groove is visisble
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetGroove()\fP, \fBhasTrough()\fP
.RE
.PP
.SS "bool QwtSlider::hasTrough () const"
.PP
\fBReturns\fP
.RS 4
True, when the trough is visisble
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetTrough()\fP, \fBhasGroove()\fP
.RE
.PP
.SS "bool QwtSlider::isScrollPosition (const QPoint & pos) const\fC [protected]\fP, \fC [virtual]\fP"
.PP
Determine what to do when the user presses a mouse button\&.
.PP
\fBParameters\fP
.RS 4
\fIpos\fP Mouse position
.RE
.PP
\fBReturn values\fP
.RS 4
\fITrue,when\fP \fBhandleRect()\fP contains pos
.RE
.PP
\fBSee also\fP
.RS 4
\fBscrolledTo()\fP
.RE
.PP
.PP
Implements \fBQwtAbstractSlider\fP\&.
.SS "QSize QwtSlider::minimumSizeHint () const\fC [virtual]\fP"
.PP
\fBReturns\fP
.RS 4
Minimum size hint
.RE
.PP
\fBSee also\fP
.RS 4
\fBsizeHint()\fP
.RE
.PP
.SS "void QwtSlider::mousePressEvent (QMouseEvent * event)\fC [protected]\fP, \fC [virtual]\fP"
Mouse press event handler
.PP
\fBParameters\fP
.RS 4
\fIevent\fP Mouse event
.RE
.PP
.PP
Reimplemented from \fBQwtAbstractSlider\fP\&.
.SS "void QwtSlider::mouseReleaseEvent (QMouseEvent * event)\fC [protected]\fP, \fC [virtual]\fP"
Mouse release event handler
.PP
\fBParameters\fP
.RS 4
\fIevent\fP Mouse event
.RE
.PP
.PP
Reimplemented from \fBQwtAbstractSlider\fP\&.
.SS "Qt::Orientation QwtSlider::orientation () const"
.PP
\fBReturns\fP
.RS 4
Orientation
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetOrientation()\fP
.RE
.PP
.SS "void QwtSlider::paintEvent (QPaintEvent * event)\fC [protected]\fP, \fC [virtual]\fP"
Qt paint event handler
.PP
\fBParameters\fP
.RS 4
\fIevent\fP Paint event
.RE
.PP
.SS "void QwtSlider::resizeEvent (QResizeEvent * event)\fC [protected]\fP, \fC [virtual]\fP"
Qt resize event handler
.PP
\fBParameters\fP
.RS 4
\fIevent\fP Resize event
.RE
.PP
.SS "const \fBQwtScaleDraw\fP * QwtSlider::scaleDraw () const"
.PP
\fBReturns\fP
.RS 4
the scale draw of the slider
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetScaleDraw()\fP
.RE
.PP
.SS "\fBQwtSlider::ScalePosition\fP QwtSlider::scalePosition () const"
.PP
\fBReturns\fP
.RS 4
Position of the scale
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetScalePosition()\fP
.RE
.PP
.SS "double QwtSlider::scrolledTo (const QPoint & pos) const\fC [protected]\fP, \fC [virtual]\fP"
.PP
Determine the value for a new position of the slider handle\&.
.PP
\fBParameters\fP
.RS 4
\fIpos\fP Mouse position
.RE
.PP
\fBReturns\fP
.RS 4
Value for the mouse position
.RE
.PP
\fBSee also\fP
.RS 4
\fBisScrollPosition()\fP
.RE
.PP
.PP
Implements \fBQwtAbstractSlider\fP\&.
.SS "void QwtSlider::setBorderWidth (int width)"
.PP
Change the slider's border width\&. The border width is used for drawing the slider handle and the trough\&.
.PP
\fBParameters\fP
.RS 4
\fIwidth\fP Border width
.RE
.PP
\fBSee also\fP
.RS 4
\fBborderWidth()\fP
.RE
.PP
.SS "void QwtSlider::setGroove (bool on)"
En/Disable the groove
.PP
The slider can be cutomized by showing a groove for the handle\&.
.PP
\fBParameters\fP
.RS 4
\fIon\fP When true, the groove is visible
.RE
.PP
\fBSee also\fP
.RS 4
\fBhasGroove()\fP, setThrough()
.RE
.PP
.SS "void QwtSlider::setHandleSize (const QSize & size)"
.PP
Set the slider's handle size\&. When the size is empty the slider handle will be painted with a default size depending on its \fBorientation()\fP and backgroundStyle()\&.
.PP
\fBParameters\fP
.RS 4
\fIsize\fP New size
.RE
.PP
\fBSee also\fP
.RS 4
\fBhandleSize()\fP
.RE
.PP
.SS "void QwtSlider::setOrientation (Qt::Orientation orientation)"
.PP
Set the orientation\&.
.PP
\fBParameters\fP
.RS 4
\fIorientation\fP Allowed values are Qt::Horizontal and Qt::Vertical\&.
.RE
.PP
\fBSee also\fP
.RS 4
\fBorientation()\fP, \fBscalePosition()\fP
.RE
.PP
.SS "void QwtSlider::setScaleDraw (\fBQwtScaleDraw\fP * scaleDraw)"
.PP
Set a scale draw\&. For changing the labels of the scales, it is necessary to derive from \fBQwtScaleDraw\fP and overload \fBQwtScaleDraw::label()\fP\&.
.PP
\fBParameters\fP
.RS 4
\fIscaleDraw\fP ScaleDraw object, that has to be created with new and will be deleted in \fB~QwtSlider()\fP or the next call of \fBsetScaleDraw()\fP\&.
.RE
.PP
\fBSee also\fP
.RS 4
scaleDraw()
.RE
.PP
.SS "void QwtSlider::setScalePosition (\fBScalePosition\fP scalePosition)"
.PP
Change the position of the scale\&.
.PP
\fBParameters\fP
.RS 4
\fIscalePosition\fP Position of the scale\&.
.RE
.PP
\fBSee also\fP
.RS 4
\fBScalePosition\fP, \fBscalePosition()\fP
.RE
.PP
.SS "void QwtSlider::setSpacing (int spacing)"
.PP
Change the spacing between trough and scale\&. A spacing of 0 means, that the backbone of the scale is covered by the trough\&.
.PP
The default setting is 4 pixels\&.
.PP
\fBParameters\fP
.RS 4
\fIspacing\fP Number of pixels
.RE
.PP
\fBSee also\fP
.RS 4
\fBspacing()\fP;
.RE
.PP
.SS "void QwtSlider::setTrough (bool on)"
En/Disable the trough
.PP
The slider can be cutomized by showing a trough for the handle\&.
.PP
\fBParameters\fP
.RS 4
\fIon\fP When true, the groove is visible
.RE
.PP
\fBSee also\fP
.RS 4
\fBhasTrough()\fP, \fBsetGroove()\fP
.RE
.PP
.SS "void QwtSlider::setUpdateInterval (int interval)"
.PP
Specify the update interval for automatic scrolling\&. The minimal accepted value is 50 ms\&.
.PP
\fBParameters\fP
.RS 4
\fIinterval\fP Update interval in milliseconds
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetUpdateInterval()\fP
.RE
.PP
.SS "QSize QwtSlider::sizeHint () const\fC [virtual]\fP"
.PP
\fBReturns\fP
.RS 4
\fBminimumSizeHint()\fP
.RE
.PP
.SS "QRect QwtSlider::sliderRect () const\fC [protected]\fP"
.PP
\fBReturns\fP
.RS 4
Bounding rectangle of the slider - without the scale
.RE
.PP
.SS "int QwtSlider::spacing () const"
.PP
\fBReturns\fP
.RS 4
Number of pixels between slider and scale
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetSpacing()\fP
.RE
.PP
.SS "void QwtSlider::timerEvent (QTimerEvent * event)\fC [protected]\fP, \fC [virtual]\fP"
Timer event handler
.PP
Handles the timer, when the mouse stays pressed inside the \fBsliderRect()\fP\&.
.PP
\fBParameters\fP
.RS 4
\fIevent\fP Mouse event
.RE
.PP
.SS "int QwtSlider::updateInterval () const"
.PP
\fBReturns\fP
.RS 4
Update interval in milliseconds for automatic scrolling
.RE
.PP
\fBSee also\fP
.RS 4
\fBsetUpdateInterval()\fP
.RE
.PP
.SH "Author"
.PP
Generated automatically by Doxygen for Qwt User's Guide from the source code\&.