YStudio Y++

注册表(基础支持库)

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

扁平命令式支持库(不是类)。路径:支持库 → 基础支持库 → 注册表。

硬约束

  1. 扁平命令;写 HKLM 等受保护位置通常需要管理员权限。
  2. 根键可用文本(如 HKEY_CURRENT_USER)或约定整数/常量——以签名与面板为准。
  3. 读不到键值时常见返回空文本 / 0 / 假,先判断键是否存在。
  4. 删除键会递归影响子键,操作前确认路径。
  5. 仅在确有需要时写注册表;错误路径可能导致软件配置损坏。

快速开始

文本 根 = "HKEY_CURRENT_USER"
文本 项 = "Software\YyuyanDemo"
// 具体命令名以签名表为准
输出("见下方完整签名表;读写前请确认权限与路径")

注册表

本分类共 9 条。

写注册表文本

  • 签名:逻辑 写注册表文本(文本 根键, 文本 子键路径, 文本 值名, 文本 值, [整数 值类型=1])
  • 说明:写入注册表文本值(等同于「写注册项」)。
  • 参数一│根键
  • 参数二│子键路径
  • 参数三│值名
  • 参数四│值
  • 参数五│[值类型=1]: 1=文本,4=整数

写注册项

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

删除注册子键

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

删除注册项

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

取注册值名称列表

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

取注册子键列表

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

注册项是否存在

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

读注册表文本

  • 签名:文本 读注册表文本(文本 根键, 文本 子键路径, 文本 值名, [文本 默认值=""])
  • 说明:读取注册表文本值(等同于「读注册项」)。
  • 参数一│根键
  • 参数二│子键路径
  • 参数三│值名
  • 参数四│[默认值=”“]: 可选

读注册项

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

易错对照

错误 正确
路径分隔符写错 注册表项用 \\ 或面板提示的分隔
无管理员写 HKLM 失败;改 HKCU 或提权
删除键未确认 可能删掉整棵子树

相关

系统操作 · 进程操作 · 配置/INI