YStudio Y++

计划任务类

Y++ / YStudio 开发文档 · 一点滴

类对象支持库。路径:支持库 → 扩展类库 → 计划任务类。

类型名写「计划任务类」。声明时自动创建。

创建、查询、启用/禁用、立即运行与删除 Windows 计划任务。开通票位后才能编译;发行程序不再验票。

能力包:plugins/supportlib.tasksched/。部分操作(最高权限运行、系统级任务)可能需要管理员。

带界面演示:examples/计划任务冒烟/(创建后可到系统「任务计划程序」taskschd.msc 查看)。

作用

把「到点跑某个程序」注册进系统计划程序(与「任务计划程序」里看到的一致)。
不是界面控件:没有「画在窗上」的效果;结果在系统计划库里。
先 置任务名 / 置程序 / 置触发类型… 写到对象上,再调无参 创建。

创建一次任务

计划任务类 任
任.置任务名("YppDemoTask")
任.置描述("Y++ 演示任务")
任.置程序("")                 // 空=本程序
任.置参数("--once")
任.置触发类型(0)               // 0一次 1每天 2登录时 3开机时
任.置开始时间("")              // 空≈两分钟后;也可 "2026-12-01 09:30:00" 或 "09:30"
如果 (!任.创建()) {
    输出(任.取错误())
} 否则 {
    输出("已创建,状态=" + 到文本(任.取状态()))
}

每天 / 登录 / 开机

任.置任务名("YppDaily")
任.置程序("C:\\Windows\\System32\\notepad.exe")
任.置触发类型(1)               // 每天
任.置开始时间("09:30")
任.创建()

任.置任务名("YppOnLogon")
任.置触发类型(2)               // 当前用户登录时
任.创建()

任.置任务名("YppOnBoot")
任.置触发类型(3)               // 开机时(常需管理员)
任.置提升运行(真)
任.创建()

查询 / 启停 / 删除

计划任务类 任
任.置任务名("YppDemoTask")
如果 (任.是否存在()) {
    任.读取配置()
    输出(任.取程序() + " / " + 任.取开始时间())
    任.立即运行()
    任.禁用()
    任.启用()
    任.删除()
}
输出(任.列举("\\"))            // 根目录任务名,多行

取状态

值 含义
0 不存在
1 已禁用
2 就绪
3 运行中
4 排队

命令摘要

方法 说明
置/取任务名 · 置/取文件夹 · 置/取程序 · 置/取参数 · 置/取工作目录 · 置/取描述 配置
置/取触发类型 · 置/取开始时间 · 置/取提升运行 触发与权限
创建 / 删除 / 是否存在 / 启用 / 禁用 管理
立即运行 / 停止 / 取状态 / 读取配置 / 列举 运行与查询
是否管理员 / 取错误 自检

与 Windows服务类 不同:服务常驻后台;计划任务是「到条件再跑一次/周期性跑」。