QML之PathView的独立属性,信号,方法介绍

前言

Qt版本:6.8.0

属性

父类属性

参考Item

普通属性

movementDirection : enumeration 指定项的移动方向

• PathView.Shortest

  • 默认值

  • 自动选择到目标位置的最短路径

  • 根据目标位置距离当前位置的远近来决定移动方向

  • 最优化移动距离

• PathView.Negative

  • 强制逆时针方向移动

  • 不管目标位置在哪里，都会按照负方向移动

  • 适用于需要固定逆时针旋转的场景

• PathView.Positive

  • 强制顺时针方向移动

  • 不管目标位置在哪里，都会按照正方向移动

  • 适用于需要固定顺时针旋转的场景

offset : real 偏移量指定了项目在路径上距离其初始位置有多远。这是一个从0到模型中项目数量的实数。

offset属性用于控制模型中的哪个项目显示在路径的起始位置。它是一个实数值，可以精确调整视图中的元素位置。
主要作用：

• 偏移量决定哪个项目放置在路径起始点
• 默认值为0，表示模型的第一个项目位于路径起始处
• 可以是小数值，允许精确定位
• 通过改变此属性可以使所有项目沿路径移动，实现滚动效果
• 在动画和交互中很有用，可以通过改变offset来平滑过渡视图位置

path : Path 定义项展示时的路径轨迹

pathItemCount : int 指定沿路径显示的项的数量

总数量为5

cacheItemCount : int 指定 PathView 在视图中缓存的项的数量

直接使用即可

preferredHighlightBegin : real 控制高亮区域的开始位置，通常与路径的总长度有关
preferredHighlightEnd : real 控制高亮区域的结束位置，通常与路径的总长度有关

项会根据数值来决定从路径的何处开始排序

• 数值选择(0.0-1.0)

  • 0.0 表示路径起点(默认)
    

  • 1.0 表示路径终点

  • 0.5 表示路径中点
    

  • Begin 和 End 相等时表示固定位置

  • Begin 和 End 不等时表示可移动范围

• 注意事项

  • Begin 值应小于或等于 End 值

  • 值必须在 0.0 到 1.0 之间

  • 建议配合 highlightRangeMode 使用

  • 可以通过动态修改这些值来改变展示效果

dragMargin : real 在拖动时，指定项和路径边缘之间的距离

count : int
currentIndex : int
currentItem : Item
delegate : Component
highlight : Component
highlightItem : Item
highlightMoveDuration : int
highlightRangeMode : enumeration
maximumFlickVelocity : real
model : model
moving : bool
interactive : bool
dragging : bool
flickDeceleration : real
flicking : bool
snapMode : enumeration

参考listview和flickable

附加属性

PathView.isCurrentItem : bool 指示当前项是否是 PathView 中的选中项

直接使用即可

PathView.onPath : bool 指示当前项是否位于路径上

直接使用即可

PathView.view : PathView 指向包含当前项的 PathView 实例

直接使用即可

信号

dragEnded()
dragStarted()
flickEnded()
flickStarted()
movementEnded()
movementStarted()

参考listview

方法

decrementCurrentIndex()
incrementCurrentIndex()
int indexAt(real x, real y)
Item itemAt(real x, real y)
Item itemAtIndex(int index)
positionViewAtIndex(int index, PositionMode mode)

参考listview