属性
import QtQuick
import QtQuick.Controls
Slider {
/*----------值----------*/
from: real//起始值
to: real//结束值
value: real//当前值
/*----------滑块----------*/
handle: Item
//用于保存句柄项,自定义滑块时使用
//需启用模糊或阴影效果
live: bool//拖动滑块时,值是否实时更新,默认:true
orientation: enumeration //方向
orientation: Qt.Horizontal//水平,默认
orientation: Qt.Vertical//垂直
pressed: bool
//滑块是通过触摸、鼠标还是按键按下的
snapMode: enumeration //滑块抓取模式
snapMode: Slider.NoSnap//不抓取,默认
snapMode: Slider.SnapAlways//按步长滑动(卡顿效果)
snapMode: Slider.SnapOnRelease//释放滑块后按步长停留位置
stepSize: real//步长,默认:0.0
touchDragThreshold: real
//触发触摸拖动事件的阈值(以逻辑像素为单位)
//鼠标拖动阈值不受影响,默认:Application.styleHints.startDragDistance
}
只读属性
import QtQuick
import QtQuick.Controls
Slider {
horizontal: bool//滑块是否水平
vertical: bool//滑块是否垂直
implicitHandleWidth(Height): real
//隐式手柄宽、高
position: real
//手柄的逻辑位置,范围 0.0~1.0,即滑块最左为0,适用于数据绑定、计算
visualPosition: real
//手柄的可视位置,范围 0.0~1.0,即滑块最左为0,适用于自定义、布局使用
}
信号
import QtQuick
import QtQuick.Controls
Slider {
moved()
onMoved: {
//通过触摸、鼠标、滚轮或按键交互式移动滑块时,就会发出该信号
}
}
方法
import QtQuick
import QtQuick.Controls
Slider {
void decrease();
//减小stepSize 或0.1 (如果stepSize 未定义)
void increase();
//增加stepSize 或0.1 (如果stepSize 未定义)
real valueAt(real position);
//返回给定position 的值,即逻辑位置对应的 value 值
}
}
自定义
import QtQuick
import QtQuick.Controls
Slider {
background: Item {
//背景
}
handle: Item {
//滑块
}
}