ValueAxis QML Type

向图形的坐标轴添加数值。更多...

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

属性

• labelDecimals : int
• labelFormat : string
• labelPostFormat : string (since 6.12)
• 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)
• labelPostFormatChanged(string format) (since 6.12)
• 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。随后，格式化后的字符串将通过ValueAxis::labelPostFormat 进行处理。

默认值为空，此时将使用“f”格式。

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

另请参阅 QString::asprintf()。

labelPostFormat : string [since 6.12]

该标签首先通过ValueAxis::labelFormat 对值进行格式化，然后经过此处处理。

默认值为“%1”。

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

该属性在 Qt 6.12 中引入。

另请参阅 QString::arg()。

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 时，会发出此信号。

[since 6.12] labelPostFormatChanged(string format)

当坐标轴标签的 Post 格式更改为format 时，会触发此信号。

该信号在 Qt 6.12 中引入。

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 时，会触发此信号。