DSlider一个聚合 QSlider 的滑块. 更多...

类 Dtk::Widget::DSlider 继承关系图:

Dtk::Widget::DSlider 的协作图:

Public 类型
enum	SliderIcons { LeftIcon , RightIcon }

信号
void	valueChanged (int value)
	信号会在 slider value 属性的值改变时被发送.

void	sliderPressed ()

void	sliderMoved (int position)
	信号会在 slider 拖动时被发送. 更多...

void	sliderReleased ()
	信号会在 slider 被松开时被发送.

void	rangeChanged (int min, int max)
	信号会在 range 属性的值改变时被发送. 更多...

void	actionTriggered (int action)
	信号会在 slider action 触发时被发送

void	iconClicked (SliderIcons icon, bool checked)
	信号会在左右 iconbutton 被点击时被发送. 更多...

Public 成员函数
	DSlider (Qt::Orientation orientation=Qt::Horizontal, QWidget *parent=nullptr)
	DSlider的构造函数. 更多...

Qt::Orientation	orientation () const
	滑块方向更多...

QSlider *	slider ()
	返回 QSlider 对象. 更多...

void	setLeftIcon (const QIcon &left)
	设置滑块左侧图标. left 左图标

void	setRightIcon (const QIcon &right)
	设置滑块右图标. right 右图标

void	setIconSize (const QSize &size)
	设置滑块图标大小. size 图标大小

void	setMinimum (int min)
	设置滑动范围的最小值. 更多...

int	minimum () const
	滑动范围的最小值. 更多...

void	setValue (int value)
	设置滑块当前值更多...

int	value () const
	DSlider::value 更多...

void	setPageStep (int pageStep)
	设置页面单步的大小更多...

int	pageStep () const
	返回页面单步大小更多...

void	setMaximum (int max)
	设置滑动范围的最大值更多...

int	maximum () const
	返回滑动范围的最大值更多...

void	setLeftTicks (const QStringList &info)
	设置滑块左侧的刻度值. 更多...

void	setRightTicks (const QStringList &info)
	设置滑块右侧的刻度值. 更多...

void	setAboveTicks (const QStringList &info)
	设置滑块上方的刻度值更多...

void	setBelowTicks (const QStringList &info)
	设置滑块下方的刻度值更多...

void	setMarkPositions (QList< int > list)
	设置显示双边的刻度线（不显示刻度值）. 更多...

void	setMouseWheelEnabled (bool enabled)
	设置鼠标滚轮是否开启. 更多...

void	setTipValue (const QString &value)
	用于创建气泡，气泡将跟随滑块移动. 更多...

QSlider::TickPosition	tickPosition () const
	返回滑块的记号位置. 更多...

QSize	sizeHint () const override
	滑动条的大小策略更多...

void	setHandleVisible (bool b)
	设置滑块是否显示. 更多...

bool	handleVisible () const
	获取滑块是否显示的状态. 更多...

void	setEnabledAcrossStyle (bool enabled)
	该函数用于设置滑槽是否禁用活动色填充已经滑过的滑槽. 更多...

Protected 成员函数
	DSlider (DSliderPrivate &q, QWidget *parent)

bool	event (QEvent *event) override

bool	eventFilter (QObject watched, QEvent event) override
	事件过滤器函数. \reimp 更多...

详细描述

DSlider一个聚合 QSlider 的滑块.

\inmodule dtkwidget

DSlider提供了在滑块两侧设置图标函数 DSlider提供了滑块的刻度及刻度标识

构造及析构函数说明

◆ DSlider()

Dtk::Widget::DSlider::DSlider	(	Qt::Orientation	orientation = `Qt::Horizontal`,
		QWidget *	parent = `nullptr`
	)

DSlider的构造函数.

parent 参数被发送到 QWidget 构造函数。

参见: Qt::Orientation

成员函数说明

◆ eventFilter()

bool Dtk::Widget::DSlider::eventFilter	(	QObject *	watched,
		QEvent *	e
	)

overrideprotected

事件过滤器函数. \reimp

此函数目前仅处理了鼠标滚轮事件 watched 被监听的子控件，e 对应的事件指针。

◆ handleVisible()

bool Dtk::Widget::DSlider::handleVisible ( ) const

获取滑块是否显示的状态.

返回: 返回滑块是否显示的状态

◆ iconClicked

void Dtk::Widget::DSlider::iconClicked	(	SliderIcons	icon,
		bool	checked
	)

signal

信号会在左右 iconbutton 被点击时被发送.

icon 表示按钮被点击的位置，checked 表示按钮是否被选中。

◆ maximum()

int Dtk::Widget::DSlider::maximum ( ) const

返回滑动范围的最大值

返回: 滑动范围的最大值

参见: QSlider::maximum

◆ minimum()

int Dtk::Widget::DSlider::minimum ( ) const

滑动范围的最小值.

返回: 返回滑动范围的最小值。

参见: QSlider::minimum() DSlider::setMinimum()

◆ orientation()

Qt::Orientation Dtk::Widget::DSlider::orientation ( ) const

滑块方向

返回: 返回当前滑块的方向。

参见: QSlider::orientation()

◆ pageStep()

int Dtk::Widget::DSlider::pageStep ( ) const

返回页面单步大小

返回: 页面单步大小的值。

参见: QSlider::pageStep() DSlider::setPageStep()

◆ rangeChanged

void Dtk::Widget::DSlider::rangeChanged	(	int	min,
		int	max
	)

signal

信号会在 range 属性的值改变时被发送.

min 为 range 的最小值， max 为 range 的最大值。

◆ setAboveTicks()

void Dtk::Widget::DSlider::setAboveTicks ( const QStringList & info )

设置滑块上方的刻度值

info 刻度标识.

参见: DSlider::setLeftTicks()

◆ setBelowTicks()

void Dtk::Widget::DSlider::setBelowTicks ( const QStringList & info )

设置滑块下方的刻度值

info 刻度标识.

参见: DSlider::setRightTicks()

◆ setEnabledAcrossStyle()

void Dtk::Widget::DSlider::setEnabledAcrossStyle ( bool enabled )

该函数用于设置滑槽是否禁用活动色填充已经滑过的滑槽.

默认普通 DSlider 滑过的滑槽是活动色填充，调用过 setXXXTicks 的 DSlider 则默认禁用活动色填充 enabled true 无活动色，可用于音量平衡等不需要显示滑过的，false 滑过的位置(如左侧)是高亮色显示，如调节亮度等(默认) 默认地，改属性为 false 。

◆ setHandleVisible()

void Dtk::Widget::DSlider::setHandleVisible ( bool b )

设置滑块是否显示.

b 为 true 时滑块显示，否则滑块隐藏。默认地，滑块为显示状态。

◆ setLeftTicks()

void Dtk::Widget::DSlider::setLeftTicks ( const QStringList & info )

设置滑块左侧的刻度值.

根据 QStringList 数量，绘制刻度的个数，绘制刻度标识：滑块为水平,刻度在滑块上方；滑块为垂直,刻度在滑块左侧。

info 刻度标识

◆ setMarkPositions()

void Dtk::Widget::DSlider::setMarkPositions ( QList< int > list )

设置显示双边的刻度线（不显示刻度值）.

举例用途：比如调节音量的 DSlider ，需要在 value = 100 的地方标记一个刻度，而不需要显示其他的刻度值（并且实际音量值是可以超过 100 的）其他：设置指定数值的刻度线(setMarkPositions)和设置刻度线+刻度值(setBelowTicks)是两个相互独立的，且互不干扰，若是同时使用，也会同时绘画各自的线；另外两个的先后顺序也并没有关系.

list 双边刻度线的值.

 示例代码
DSlider* slider = new DSlider(Qt::Horizontal, wTemp);
QStringList list1;
list1 << "0" << "25" << "50" << "75" << "100";
slider->setBelowTicks(list1);
QStringList list2;
list2 << "0" << "25" << "50" << "75" << "100"";
slider->setAboveTicks(list2);
QList<int> list3;
list3 << 0 << 30 << 80;
slider->setMarkPositions(list3);
slider->setMinimum(0);
slider->setMaximum(100);

◆ setMaximum()

void Dtk::Widget::DSlider::setMaximum ( int max )

设置滑动范围的最大值

max 滑动范围的最大值。

参见: QSlider::setMaximum() DSlider::maximum()

◆ setMinimum()

void Dtk::Widget::DSlider::setMinimum ( int min )

设置滑动范围的最小值.

min 滑动最小值。

参见: QSlider::setMinimum() DSlider::minimum()

◆ setMouseWheelEnabled()

void Dtk::Widget::DSlider::setMouseWheelEnabled ( bool enabled )

设置鼠标滚轮是否开启.

开启鼠标滚轮后，用户可以通过鼠标滚轮来控制滑块的滑动。

enabled 是否开启鼠标滚轮

◆ setPageStep()

void Dtk::Widget::DSlider::setPageStep ( int pageStep )

设置页面单步的大小

使用按键 PageUp 或者 PageDown 时，滑块滑动的单步大小。

pageStep 单步大小.

参见: QSlider::setPageStep()

◆ setRightTicks()

void Dtk::Widget::DSlider::setRightTicks ( const QStringList & info )

设置滑块右侧的刻度值.

根据 QStringList 数量，绘制刻度的个数，绘制刻度标识：滑块为水平,刻度在滑块下方；滑块为垂直,刻度在滑块右侧。

info 刻度标识

◆ setTipValue()

void Dtk::Widget::DSlider::setTipValue ( const QString & value )

用于创建气泡，气泡将跟随滑块移动.

value 非空开启气泡 value 空关闭气泡(销毁)

◆ setValue()

void Dtk::Widget::DSlider::setValue ( int value )

设置滑块当前值

value 滑块的当前值。

参见: QSlider::setValue()

◆ sizeHint()

QSize Dtk::Widget::DSlider::sizeHint ( ) const

override

滑动条的大小策略

这个函数会返回该滑动条推荐的大小，如果滑动条没有布局，这个大小将会是一个无效值，如果存在布局，将返回该布局下的推荐大小。

参见: QSlider::sizeHint

◆ slider()

QSlider * Dtk::Widget::DSlider::slider ( )

返回 QSlider 对象.

若 DSlider 不满足输入框的使用需求，请用此函数抛出的对象。

返回: QSlider 对象。

◆ sliderMoved

void Dtk::Widget::DSlider::sliderMoved ( int position )

signal

信号会在 slider 拖动时被发送.

position 为 slider 被拖动的指针的位置。

◆ tickPosition()

QSlider::TickPosition Dtk::Widget::DSlider::tickPosition ( ) const

返回滑块的记号位置.

获取滑块刻度当前朝向。

返回: 滑块刻度的朝向

参见: QSlider::TickPosition

◆ value()

int Dtk::Widget::DSlider::value ( ) const

DSlider::value

参见: QSlider::value()

该类的文档由以下文件生成:

include/dtkwidget/widgets/dslider.h
src/widgets/dslider.cpp

Public 类型

信号

Public 成员函数

Protected 成员函数

详细描述

构造及析构函数说明

◆ DSlider()

成员函数说明

◆ eventFilter()

◆ handleVisible()

◆ iconClicked

◆ maximum()

◆ minimum()

◆ orientation()

◆ pageStep()

◆ rangeChanged

◆ setAboveTicks()

◆ setBelowTicks()

◆ setEnabledAcrossStyle()

◆ setHandleVisible()

◆ setLeftTicks()

◆ setMarkPositions()

◆ setMaximum()

◆ setMinimum()

◆ setMouseWheelEnabled()

◆ setPageStep()

◆ setRightTicks()

◆ setTipValue()

◆ setValue()

◆ sizeHint()

◆ slider()

◆ sliderMoved

◆ tickPosition()

◆ value()