44 lines
1.3 KiB
Markdown
44 lines
1.3 KiB
Markdown
# 123 ChartCrosshair 十字光标
|
||
|
||
## 用途
|
||
|
||
绘制横纵十字线和轴侧读数标签，提供最近数据点吸附。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
view := func(c *ui.Context) {
|
||
core.Use(c, core.Settings{})
|
||
x := chart.ChartAxis(c, chart.ChartAxisOptions{Max: 10})
|
||
y := chart.ChartAxis(c, chart.ChartAxisOptions{Side: chart.SideLeft, Max: 100})
|
||
hair := chart.ChartCrosshair(c, chart.ChartCrosshairOptions{X: &x, Y: &y})
|
||
ui.Box(c).Fill().Draw(func(p *ui.Painter, r ui.Rect) {
|
||
plot := ui.Rect{X: r.X + 60, Y: r.Y + 20, W: r.W - 80, H: r.H - 60}
|
||
x.Draw(p, plot)
|
||
y.Draw(p, plot)
|
||
hair.Draw(p, plot, x.Map(plot, 5), y.Map(plot, 70))
|
||
})
|
||
}
|
||
ui.Render(view, 400, 300, 1)
|
||
```
|
||
|
||
## 参数
|
||
|
||
`X, Y *ChartAxisPart`：至少提供一条轴。`Reach` 默认 24 DIP，负值 panic。返回 `ChartCrosshairPart`；`Snap(n, at, x, y)` 返回范围内最近索引，范围外为 -1。
|
||
|
||
## 状态
|
||
|
||
静态部件；随调用方传入的坐标变化。移动路径使用像素网格对齐。
|
||
|
||
## 事件
|
||
|
||
吸附返回索引；读数变化使用所属 `ChartResult.Changed()`。
|
||
|
||
## 键盘操作
|
||
|
||
与 Chart 的 `Pick`、`Anchor`、`Readout` 组合，方向键逐点显示并朗读数值。
|
||
|
||
## 限制
|
||
|
||
`Draw` 使用窗口坐标，`Snap` 和 at 必须采用相同坐标系；轴部件在每帧创建。
|