Qt 4.8
Public Types | Public Functions | Public Variables | Protected Functions | List of all members
QStyleOptionSlider Class Reference

The QStyleOptionSlider class is used to describe the parameters needed for drawing a slider. More...

#include <qstyleoption.h>

Inheritance diagram for QStyleOptionSlider:
QStyleOptionComplex QStyleOption

Public Types

enum  StyleOptionType { Type = SO_Slider }
 This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass. More...
 
enum  StyleOptionVersion { Version = 1 }
 This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass. More...
 
- Public Types inherited from QStyleOptionComplex
enum  StyleOptionType { Type = SO_Complex }
 This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass. More...
 
enum  StyleOptionVersion { Version = 1 }
 This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass. More...
 
- Public Types inherited from QStyleOption
enum  OptionType {
  SO_Default, SO_FocusRect, SO_Button, SO_Tab,
  SO_MenuItem, SO_Frame, SO_ProgressBar, SO_ToolBox,
  SO_Header, SO_Q3DockWindow, SO_DockWidget, SO_Q3ListViewItem,
  SO_ViewItem, SO_TabWidgetFrame, SO_TabBarBase, SO_RubberBand,
  SO_ToolBar, SO_GraphicsItem, SO_Complex = 0xf0000, SO_Slider,
  SO_SpinBox, SO_ToolButton, SO_ComboBox, SO_Q3ListView,
  SO_TitleBar, SO_GroupBox, SO_SizeGrip, SO_CustomBase = 0xf00,
  SO_ComplexCustomBase = 0xf000000
}
 This enum is used internally by QStyleOption, its subclasses, and qstyleoption_cast() to determine the type of style option. More...
 
enum  StyleOptionType { Type = SO_Default }
 This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass. More...
 
enum  StyleOptionVersion { Version = 1 }
 This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass. More...
 

Public Functions

 QStyleOptionSlider ()
 Constructs a QStyleOptionSlider, initializing the members variables to their default values. More...
 
 QStyleOptionSlider (const QStyleOptionSlider &other)
 Constructs a copy of the other style option. More...
 
- Public Functions inherited from QStyleOptionComplex
 QStyleOptionComplex (int version=QStyleOptionComplex::Version, int type=SO_Complex)
 Constructs a QStyleOptionComplex of the specified type and version, initializing the member variables to their default values. More...
 
 QStyleOptionComplex (const QStyleOptionComplex &other)
 Constructs a copy of the other style option. More...
 
- Public Functions inherited from QStyleOption
void init (const QWidget *w)
 Use initFrom(widget) instead. More...
 
void initFrom (const QWidget *w)
 
QStyleOptionoperator= (const QStyleOption &other)
 Assign other to this QStyleOption. More...
 
 QStyleOption (int version=QStyleOption::Version, int type=SO_Default)
 Constructs a QStyleOption with the specified version and type. More...
 
 QStyleOption (const QStyleOption &other)
 Constructs a copy of other. More...
 
 ~QStyleOption ()
 Destroys this style option object. More...
 

Public Variables

bool dialWrapping
 whether the dial should wrap or not More...
 
int maximum
 the maximum value for the slider More...
 
int minimum
 the minimum value for the slider More...
 
qreal notchTarget
 the number of pixel between notches More...
 
Qt::Orientation orientation
 the slider's orientation (horizontal or vertical) More...
 
int pageStep
 the size of the page step of the slider More...
 
int singleStep
 the size of the single step of the slider More...
 
int sliderPosition
 the position of the slider handle More...
 
int sliderValue
 the value of the slider More...
 
int tickInterval
 the interval that should be drawn between tick marks More...
 
QSlider::TickPosition tickPosition
 the position of the slider's tick marks, if any More...
 
bool upsideDown
 the slider control orientation More...
 
- Public Variables inherited from QStyleOptionComplex
QStyle::SubControls activeSubControls
 This variable holds a bitwise OR of the sub-controls that are active for the complex control. More...
 
QStyle::SubControls subControls
 This variable holds a bitwise OR of the sub-controls to be drawn for the complex control. More...
 
- Public Variables inherited from QStyleOption
Qt::LayoutDirection direction
 the text layout direction that should be used when drawing text in the control More...
 
QFontMetrics fontMetrics
 the font metrics that should be used when drawing text in the control More...
 
QPalette palette
 the palette that should be used when painting the control More...
 
QRect rect
 the area that should be used for various calculations and painting More...
 
QStyle::State state
 the style flags that are used when drawing the control More...
 
int type
 the option type of the style option More...
 
int version
 the version of the style option More...
 

Protected Functions

 QStyleOptionSlider (int version)
 

Additional Inherited Members

Detailed Description

The QStyleOptionSlider class is used to describe the parameters needed for drawing a slider.

QStyleOptionSlider contains all the information that QStyle functions need to draw QSlider and QScrollBar.

For performance reasons, the access to the member variables is direct (i.e., using the . or -> operator). This low-level feel makes the structures straightforward to use and emphasizes that these are simply parameters used by the style functions.

For an example demonstrating how style options can be used, see the widgets/styles{Styles} example.

See also
QStyleOptionComplex, QSlider, QScrollBar

Definition at line 701 of file qstyleoption.h.

Enumerations

◆ StyleOptionType

This enum is used to hold information about the type of the style option, and is defined for each QStyleOption subclass.

  • Type The type of style option provided (SO_Slider for this class).

The type is used internally by QStyleOption, its subclasses, and qstyleoption_cast() to determine the type of style option. In general you do not need to worry about this unless you want to create your own QStyleOption subclass and your own styles.

See also
StyleOptionVersion
Enumerator
Type 

Definition at line 704 of file qstyleoption.h.

◆ StyleOptionVersion

This enum is used to hold information about the version of the style option, and is defined for each QStyleOption subclass.

  • Version 1

The version is used by QStyleOption subclasses to implement extensions without breaking compatibility. If you use qstyleoption_cast(), you normally do not need to check it.

See also
StyleOptionType
Enumerator
Version 

Definition at line 705 of file qstyleoption.h.

Constructors and Destructors

◆ QStyleOptionSlider() [1/3]

QStyleOptionSlider::QStyleOptionSlider ( )

Constructs a QStyleOptionSlider, initializing the members variables to their default values.

Definition at line 3343 of file qstyleoption.cpp.

3347  dialWrapping(false)
3348 {
3349 }
qreal notchTarget
the number of pixel between notches
Definition: qstyleoption.h:717
int sliderValue
the value of the slider
Definition: qstyleoption.h:714
int tickInterval
the interval that should be drawn between tick marks
Definition: qstyleoption.h:711
QSlider::TickPosition tickPosition
the position of the slider&#39;s tick marks, if any
Definition: qstyleoption.h:710
bool dialWrapping
whether the dial should wrap or not
Definition: qstyleoption.h:718
bool upsideDown
the slider control orientation
Definition: qstyleoption.h:712
int sliderPosition
the position of the slider handle
Definition: qstyleoption.h:713
int maximum
the maximum value for the slider
Definition: qstyleoption.h:709
int minimum
the minimum value for the slider
Definition: qstyleoption.h:708
Qt::Orientation orientation
the slider&#39;s orientation (horizontal or vertical)
Definition: qstyleoption.h:707
int pageStep
the size of the page step of the slider
Definition: qstyleoption.h:716
int singleStep
the size of the single step of the slider
Definition: qstyleoption.h:715
QStyleOptionComplex(int version=QStyleOptionComplex::Version, int type=SO_Complex)
Constructs a QStyleOptionComplex of the specified type and version, initializing the member variables...

◆ QStyleOptionSlider() [2/3]

QStyleOptionSlider::QStyleOptionSlider ( const QStyleOptionSlider other)
inline

Constructs a copy of the other style option.

Definition at line 721 of file qstyleoption.h.

721 : QStyleOptionComplex(Version, Type) { *this = other; }
QStyleOptionComplex(int version=QStyleOptionComplex::Version, int type=SO_Complex)
Constructs a QStyleOptionComplex of the specified type and version, initializing the member variables...

◆ QStyleOptionSlider() [3/3]

QStyleOptionSlider::QStyleOptionSlider ( int  version)
protected
Warning
This function is not part of the public interface.

Definition at line 3354 of file qstyleoption.cpp.

3358  dialWrapping(false)
3359 {
3360 }
int version
the version of the style option
Definition: qstyleoption.h:86
qreal notchTarget
the number of pixel between notches
Definition: qstyleoption.h:717
int sliderValue
the value of the slider
Definition: qstyleoption.h:714
int tickInterval
the interval that should be drawn between tick marks
Definition: qstyleoption.h:711
QSlider::TickPosition tickPosition
the position of the slider&#39;s tick marks, if any
Definition: qstyleoption.h:710
bool dialWrapping
whether the dial should wrap or not
Definition: qstyleoption.h:718
bool upsideDown
the slider control orientation
Definition: qstyleoption.h:712
int sliderPosition
the position of the slider handle
Definition: qstyleoption.h:713
int maximum
the maximum value for the slider
Definition: qstyleoption.h:709
int minimum
the minimum value for the slider
Definition: qstyleoption.h:708
Qt::Orientation orientation
the slider&#39;s orientation (horizontal or vertical)
Definition: qstyleoption.h:707
int pageStep
the size of the page step of the slider
Definition: qstyleoption.h:716
int singleStep
the size of the single step of the slider
Definition: qstyleoption.h:715
QStyleOptionComplex(int version=QStyleOptionComplex::Version, int type=SO_Complex)
Constructs a QStyleOptionComplex of the specified type and version, initializing the member variables...

Properties

◆ dialWrapping

QStyleOptionSlider::dialWrapping

whether the dial should wrap or not

The default value is false, i.e. the dial is not wrapped.

See also
QDial::wrapping()

Definition at line 718 of file qstyleoption.h.

Referenced by calcArrow(), QStyleHelper::calcLines(), QStyleHelper::calcRadialPos(), and QDial::initStyleOption().

◆ maximum

QStyleOptionSlider::maximum

◆ minimum

QStyleOptionSlider::minimum

◆ notchTarget

QStyleOptionSlider::notchTarget

the number of pixel between notches

The default value is 0.0.

See also
QDial::notchTarget()

Definition at line 717 of file qstyleoption.h.

Referenced by QDial::initStyleOption().

◆ orientation

QStyleOptionSlider::orientation

◆ pageStep

QStyleOptionSlider::pageStep

the size of the page step of the slider

The default value is 0.

See also
QAbstractSlider::pageStep

Definition at line 716 of file qstyleoption.h.

Referenced by QStyleHelper::calcLines(), QMacStylePrivate::getSliderInfo(), QScrollBar::initStyleOption(), QDial::initStyleOption(), and QSlider::initStyleOption().

◆ singleStep

QStyleOptionSlider::singleStep

the size of the single step of the slider

The default value is 0.

See also
QAbstractSlider::singleStep

Definition at line 715 of file qstyleoption.h.

Referenced by QScrollBar::initStyleOption(), QDial::initStyleOption(), and QSlider::initStyleOption().

◆ sliderPosition

QStyleOptionSlider::sliderPosition

the position of the slider handle

If the slider has active feedback (i.e., QAbstractSlider::tracking is true), this value will be the same as sliderValue . Otherwise, it will have the current position of the handle. The default value is 0.

See also
QAbstractSlider::tracking, sliderValue

Definition at line 713 of file qstyleoption.h.

Referenced by calcArrow(), QStyleHelper::calcRadialPos(), QMacStylePrivate::getSliderInfo(), QScrollBar::initStyleOption(), QDial::initStyleOption(), and QSlider::initStyleOption().

◆ sliderValue

QStyleOptionSlider::sliderValue

the value of the slider

If the slider has active feedback (i.e., QAbstractSlider::tracking is true), this value will be the same as sliderPosition . Otherwise, it will have the value the slider had before the mouse was pressed.

The default value is 0.

See also
QAbstractSlider::tracking sliderPosition

Definition at line 714 of file qstyleoption.h.

Referenced by QScrollBar::initStyleOption(), QDial::initStyleOption(), and QSlider::initStyleOption().

◆ tickInterval

QStyleOptionSlider::tickInterval

the interval that should be drawn between tick marks

The default value is 0.

Definition at line 711 of file qstyleoption.h.

Referenced by QStyleHelper::calcLines(), QDial::initStyleOption(), and QSlider::initStyleOption().

◆ tickPosition

QStyleOptionSlider::tickPosition

the position of the slider's tick marks, if any

The default value is QSlider::NoTicks.

See also
QSlider::TickPosition

Definition at line 710 of file qstyleoption.h.

Referenced by QMacStylePrivate::getSliderInfo(), QDial::initStyleOption(), and QSlider::initStyleOption().

◆ upsideDown

QStyleOptionSlider::upsideDown

the slider control orientation

Normally a slider increases as it moves up or to the right; upsideDown indicates that it should do the opposite (increase as it moves down or to the left). The default value is false, i.e. the slider increases as it moves up or to the right.

See also
QStyle::sliderPositionFromValue(), QStyle::sliderValueFromPosition(), QAbstractSlider::invertedAppearance

Definition at line 712 of file qstyleoption.h.

Referenced by calcArrow(), QStyleHelper::calcRadialPos(), QMacStylePrivate::getSliderInfo(), QScrollBar::initStyleOption(), QDial::initStyleOption(), QSlider::initStyleOption(), QSliderPrivate::pixelPosToRangeValue(), and QScrollBarPrivate::pixelPosToRangeValue().


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