YStudio Y++

注册表(基础支持库)

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

路径:支持库 → 基础支持库 → 注册表。

硬约束

  1. 扁平命令;根键如「当前用户」「本地机器」。
  2. 读写失败以返回值判断;注意权限与路径拼写。

快速开始

如果 (写注册表文本("当前用户", "Software\\Yyuyan", "名", "测试")) {
    输出(读注册表文本("当前用户", "Software\\Yyuyan", "名"))
}

注册表操作

本分类共 7 条。

读注册项

  • 签名:文本 读注册项(文本 根键, 文本 子键路径, 文本 值名, [文本 默认值=""])
  • 说明:读取指定根键、子键下某注册值的文本表示;值不存在或读取失败时返回默认值。整数型值返回十进制文本;二进制值返回十六进制文本。
  • 参数一│根键: 如 当前用户、本地机器、类根
  • 参数二│子键路径: 如 Software\MyCompany\MyApp
  • 参数三│值名: 要读取的值名称;默认项可传空文本
  • 参数四│[默认值=”“]: 可选,读失败时返回

写注册项

  • 签名:逻辑 写注册项(文本 根键, 文本 子键路径, 文本 值名, 文本 值, [整数 值类型=1])
  • 说明:写入或覆盖注册表值;子键不存在时会自动创建。成功返回真。
  • 参数一│根键: 如 当前用户、本地机器
  • 参数二│子键路径: 目标子键
  • 参数三│值名: 值名称
  • 参数四│值: 要写入的内容
  • 参数五│[值类型=1]: 1=文本,4=整数

删除注册项

  • 签名:逻辑 删除注册项(文本 根键, 文本 子键路径, 文本 值名)
  • 说明:删除指定子键下的某个值(不是删除整个子键)。
  • 参数一│根键
  • 参数二│子键路径
  • 参数三│值名: 要删除的值名

删除注册子键

  • 签名:逻辑 删除注册子键(文本 根键, 文本 子键路径)
  • 说明:删除指定子键(该键下不能再有子键,否则失败)。
  • 参数一│根键
  • 参数二│子键路径: 要删除的子键完整路径

注册项是否存在

  • 签名:逻辑 注册项是否存在(文本 根键, 文本 子键路径, 文本 值名)
  • 说明:判断指定注册值是否存在。
  • 参数一│根键
  • 参数二│子键路径
  • 参数三│值名

取注册子键列表

  • 签名:数组 取注册子键列表(文本 根键, 文本 子键路径)
  • 说明:列出指定子键下的全部子键名称,返回文本数组。
  • 参数一│根键
  • 参数二│子键路径: 空文本表示根键下一级

取注册值名称列表

  • 签名:数组 取注册值名称列表(文本 根键, 文本 子键路径)
  • 说明:列出指定子键下全部值的名称,返回文本数组。
  • 参数一│根键
  • 参数二│子键路径

易错对照

错误 正确
根键写 HKCU 英文缩写 用面板中文根键名
无权限写 HKLM 需管理员或改当前用户

相关

系统操作 · INI支持库