ValueAxis QML Type

为图表的坐标轴添加数值。更多

• 所有成员（包括继承成员）的列表
• ValueAxis 是Qt Graphs QML Types for 2D 的一部分。

属性

• labelDecimals : int
• labelFormat : string
• max : real
• min : real
• pan : real (since 6.9)
• subTickCount : int
• tickAnchor : real
• tickInterval : real
• visualMax : real (since 6.11)
• visualMin : real (since 6.11)
• zoom : real (since 6.9)

信号

• labelDecimalsChanged(int decimals)
• labelFormatChanged(string format)
• maxChanged(real max)
• minChanged(real min)
• rangeChanged(real min, real max)
• subTickCountChanged(int subTickCount)
• tickAnchorChanged(real tickAnchor)
• tickIntervalChanged(real tickInterval)

详细说明

ValueAxis 类型可设置为显示带有刻度线、网格线和阴影的轴线。坐标轴上的值绘制在刻度线的位置上。

以下示例代码说明了如何使用 ValueAxis 类型：

GraphsView {
    axisX: ValueAxis {
        max: 10
        tickInterval: 1
    }
    axisY: ValueAxis {
        min -20
        max: 40
    }
    LineSeries {
        // Add a few XYPoint data...
    }
}

属性文档

labelDecimals : int

用于显示标签的小数位数。设置为-1 时，小数点会根据数值范围自动调整。默认值为-1。

labelFormat : string

格式字符串支持标准 C++ 库printf() 提供的下列转换指定符、长度修饰符和标志：d、i、o、x、X、f、F、e、E、g、G、c。

默认值为空，在这种情况下使用 "f "格式。

另请参见 QString::asprintf().

max : real

轴上的最大值。

设置此属性时，如有必要，会对最小值进行调整，以确保范围保持有效。默认值为 10.0

min : real

轴上的最小值。

设置该属性时，必要时会调整最大值，以确保范围保持有效。默认值为 0.0

pan : real [since 6.9]

坐标轴的平移值。

平移值会移动坐标轴的中心，但不会影响网格和标签的间隔。默认值为 0。

此属性在 Qt 6.9 中引入。

subTickCount : int

坐标轴上的小标点数量。这表示在图表的主要线条之间绘制了多少个子线。副刻线不绘制标签。默认值为 0。

tickAnchor : real

动态刻度线和标签的基准值。默认值为 0。

tickInterval : real

动态放置的刻度线和标签之间的间隔。默认值为 0，即根据最小和最大范围自动计算间隔。

visualMax : real [read-only, since 6.11]

轴的视觉最大值。

该属性用于保存轴被平移或缩放时的可视最大值。默认值为max

此属性在 Qt 6.11 中引入。

visualMin : real [read-only, since 6.11]

坐标轴的视觉最小值。

该属性用于保存轴被平移或缩放时的视觉最小值。默认值为min

此属性在 Qt 6.11 中引入。

zoom : real [since 6.9]

坐标轴的缩放值。

缩放值可放大或缩小坐标轴，从而放大或缩小图表，但不会影响网格和标签的间隔。默认值为 1。

此属性在 Qt 6.9 中引入。

信号文档

labelDecimalsChanged(int decimals)

当坐标轴标签小数点的数量变为decimals 时，将发出该信号。

labelFormatChanged(string format)

当坐标轴标签格式更改为format 时，将发出此信号。

maxChanged(real max)

当轴的最大值变为max 时，将发出该信号。

minChanged(real min)

当轴的最小值变为min 时，将发出该信号。

rangeChanged(real min, real max)

当轴的最小值或最大值分别变为min 和max 时，将发出该信号。

subTickCountChanged(int subTickCount)

当subTickCount 指定的坐标轴上的子刻度数发生变化时，将发出该信号。

tickAnchorChanged(real tickAnchor)

当 tick 锚定值更改为tickAnchor 时，将发出该信号。

tickIntervalChanged(real tickInterval)

当 tick 间隔值变为tickInterval 时，将发出该信号。