PathView QML Type

这些属性设置了视图中高亮显示（当前项目）的首选范围。首选值必须在0 至1 的范围内。

highlightRangeMode 的有效值为

默认值是PathView.StrictlyEnforceRange。

定义高亮范围是影响视图移动时当前项目最终位置的正确方法。例如，如果您希望当前选中的项目位于路径的中间，那么请将高亮范围设置为 0.5,0.5，并将highlightRangeMode 设置为PathView.StrictlyEnforceRange。这样，当路径滚动时，当前选中的项目将是位于该位置的项目。这也适用于当前选定项发生变化时--它会滚动到首选高亮范围内。此外，无论是否存在高亮显示，当前项目索引的行为都会发生。

该属性保留了在路径外缓存的最大项目数。

例如，如果PathView 的模型包含 20 个项目，pathItemCount 为 10，cacheItemCount 为 4，则最多将创建 14 个项目，其中 10 个在路径上可见，4 个为不可见的缓存项目。

缓存委托是异步创建的，允许在多个帧中创建，并减少跳帧的可能性。

另请参阅 pathItemCount 。

此属性保存模型中的项目数。

该属性保存当前项目的索引。

该属性保存视图中的当前项目。

委托提供了一个模板，定义了视图实例化的每个项目。索引作为可访问的index 属性公开。根据数据模型的类型，模型的属性也是可用的。

当指定pathItemCount 时，委托中对象和绑定的数量会直接影响视图的闪烁性能。如果可能，请将正常显示委托时不需要的功能放在Loader 中，以便在需要时加载其他组件。

请注意，PathView 将根据委托中根项目的大小来布局项目。

下面是一个委托示例：

    Component {
        id: delegate
        Column {
            id: wrapper

            required property url icon
            required property string name

            opacity: PathView.isCurrentItem ? 1 : 0.5

            Image {
                anchors.horizontalCenter: nameText.horizontalCenter
                width: 64; height: 64
                source: wrapper.icon
            }
            Text {
                id: nameText
                text: wrapper.name
                font.pointSize: 16
            }
        }
    }

该属性保留了启动鼠标拖动的路径的最大距离。

默认情况下，只有单击项目才能拖动路径。如果 dragMargin 大于零，则在路径的 dragMargin 像素范围内单击即可启动拖动。

此属性显示当前视图是否因用户拖动而移动。

该属性设置了弹动减速的速度。

默认值为 100。

该属性显示当前视图是否因用户弹动而移动。

该属性显示用作高亮显示的组件。

将为每个视图创建一个高亮组件实例。生成的组件实例的几何形状将由视图管理，以便与当前项目保持一致。

下面的示例演示了如何制作一个简单的突出显示。请注意PathView.onPath attached 属性的使用，以确保从路径上弹开时隐藏高亮显示。

Component {
    Rectangle {
        visible: PathView.onPath
        // ...
    }
}

另请参阅 highlightItem 和highlightRangeMode 。

highlightItem 在 组件中创建的高亮显示项。highlight

另请参阅 highlight 。

该属性保存高亮显示委托的移动动画持续时间。

如果highlightRangeMode 是 StrictlyEnforceRange，那么该属性将决定项目沿路径移动的速度。

持续时间的默认值为 300ms。

用户不能拖动或滑动非交互式的PathView 。

该属性可用于暂时禁用弹动功能。这允许与PathView 的子项进行特殊交互。

该属性是用户弹动视图的大约最大速度，单位为像素/秒。

默认值取决于平台。

该属性包含为视图提供数据的模型。

模型提供一组数据，用于为视图创建项目。对于大型或动态数据集，模型通常由 C++ 模型对象提供。也可使用ListModel 类型直接在 QML 中创建模型。

另请参阅 数据模型。

此属性决定设置当前索引时项目移动的方向。可能的值有

例如，假设模型中有 5 个条目，currentIndex 是0 。如果currentIndex 设置为2 、

• Positive 移动方向的顺序如下：0, 1, 2
• Negative 移动方向将导致以下顺序：0, 5, 4, 3, 2
• Shortest 移动方向与Positive 移动方向的顺序相同。

该属性表示视图当前是否因用户拖动或滑动而移动。

偏移量指定项目从初始位置沿路径移动的距离。这是一个实数，范围从0 到模型中的项目计数。

该属性保存用于布局项目的路径。更多信息请参阅Path 文档。

该属性表示在同一时间路径上可见的项目数。

将 pathItemCount 设置为未定义，将显示路径上的所有项目。

此属性决定项目在拖动或轻移后的沉降方式。可能的值有

snapMode currentIndex要在移动视图时更新 ，请将 设置为 （默认为 ）。currentIndex highlightRangeMode PathView.StrictlyEnforceRange PathView

另请参阅 highlightRangeMode 。

如果此委托是当前项目，则此附加属性为 true；否则为 false。

它附加到委托的每个实例。

此属性可用于调整当前项目的外观。

    Component {
        id: delegate
        Column {
            id: wrapper

            required property url icon
            required property string name

            opacity: PathView.isCurrentItem ? 1 : 0.5

            Image {
                anchors.horizontalCenter: nameText.horizontalCenter
                width: 64; height: 64
                source: wrapper.icon
            }
            Text {
                id: nameText
                text: wrapper.name
                font.pointSize: 16
            }
        }
    }

此附加属性可确定项目当前是否在路径上。

如果已设置pathItemCount ，则可能会出现某些项目已被实例化，但不被视为当前在路径上的情况。例如，这些项目通常会被设置为不可见：

Component {
    Rectangle {
        visible: PathView.onPath
        // ...
    }
}

它附加到委托的每个实例。

此附加属性包含管理此委托实例的视图。

它附加到委托的每个实例。

该信号在用户停止拖动视图时发出。

如果在松开触摸/鼠标按钮时拖动的速度足够大，则会开始弹动。

当用户交互导致视图开始被拖动时，将发出该信号。

当视图因弹动而停止移动时，将发出该信号。

该信号在视图被弹动时发出。当鼠标或触控被释放时，视图仍在运动，此时视图开始弹动。

当视图因用户交互而停止移动时，会发出该信号。如果产生了滑动，则一旦滑动停止，就会发出该信号。如果未生成弹动，则在用户停止拖动（即释放鼠标或触摸）时发出此信号。

当视图因用户交互而开始移动时，将发出该信号。

减小当前索引。

注意：方法只能在组件完成后调用。

递增当前索引。

注意：方法只能在组件完成后调用。

返回包含点x 的项目索引，y （以内容坐标表示）。如果在指定的点上没有项目，则返回-1。

注意：方法只能在组件完成后调用。

Returns the item containing the pointx,y in content coordinates.如果在指定的点上没有项目，则返回 null。

注意：方法只能在组件完成后调用。

返回index 的项目。如果该索引没有项目，例如因为尚未创建，或因为已从可见区域平移并从缓存中删除，则返回 null。

注意：此方法只能在组件完成后调用。也不应存储返回值，因为如果视图释放了该项目，一旦控件离开调用范围，返回值就会变为空值。

定位视图，使index 位于mode 指定的位置：

注意：方法只能在组件完成后调用。要在启动时定位视图，应通过 Component.onCompleted 调用此方法。例如，在结束时定位视图：

Component.onCompleted: positionViewAtIndex(count - 1, PathView.End)