51 lines
1.8 KiB
Markdown
51 lines
1.8 KiB
Markdown
# 326 ProcessList · 进程列表
|
|
|
|
## 用途
|
|
|
|
以表格列出进程，可按名称、PID、CPU、内存排序；结束进程前必须确认，确认后通过结果交给调用方执行。
|
|
|
|
## 最小示例
|
|
|
|
```go
|
|
procs := []mujica.Process{{PID: 7, Name: "archivist", CPU: 42, Memory: 50 << 20}, {PID: 9, Name: "herald", CPU: 3, Memory: 8 << 20}}
|
|
var state mujica.ProcessListState
|
|
view := func(c *ui.Context) {
|
|
mujica.Use(c, mujica.Settings{})
|
|
r := mujica.ProcessList(c, procs, &state, mujica.ProcessListOptions{})
|
|
r.Element.Height(240)
|
|
if r.End != nil {
|
|
fmt.Println("kill", r.End.PID)
|
|
}
|
|
}
|
|
ui.Render(view, 400, 300, 1)
|
|
```
|
|
|
|
## 参数
|
|
|
|
`func ProcessList(c *ui.Context, procs []Process, s *ProcessListState, opts ProcessListOptions) ProcessListResult`。排序只在切片或排序方式变化时进行；刷新数据请传入新切片。
|
|
|
|
| 字段 | 类型 | 默认值 | 含义 |
|
|
| --- | --- | --- | --- |
|
|
| `Process.PID`, `Name` | `int`, `string` | — | 进程号与名称；PID 是行的稳定键。 |
|
|
| `Process.CPU` | `float64` | 0 | 占用百分比。 |
|
|
| `Process.Memory` | `uint64` | 0 | 常驻内存字节数，显示为 KB/MB/GB。 |
|
|
| `ProcessListState.Sort` | `ui.SortOrder` | CPU 降序 | 列为 `name`、`pid`、`cpu`、`memory`，其他值 panic。 |
|
|
| `Disabled` | `bool` | false | 不能排序与结束进程。 |
|
|
|
|
## 状态
|
|
|
|
选中行（Selection 背景与菱形）、排序列箭头、确认对话框（默认聚焦“取消”）、无进程、禁用。
|
|
|
|
## 事件
|
|
|
|
`End`：用户确认要结束的进程，没有则为 nil。
|
|
|
|
## 键盘操作
|
|
|
|
- Tab 到达表格；↑/↓、Home/End 选择；Delete 结束所选进程（先确认）。
|
|
- 点击列头排序，再点反向；每行结束按钮可用 Tab 到达。
|
|
|
|
## 限制
|
|
|
|
- 组件不发送信号，只回报确认结果。
|