YStudio Y++

系统操作（基础支持库）

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

路径：支持库 → 基础支持库 → 系统操作。

硬约束

  1. 扁平命令：关机/重启/环境变量/打开网址或路径等。
  2. 涉及关机、重启、注销的命令请谨慎；可选倒计时参数以签名为准。
  3. 方法调用须带括号。

快速开始

输出(取环境变量("PATH"))
打开网址("https://www.yddphp.cn")
打开路径(取桌面路径())

系统操作

本分类共 33 条。

区域截图

  • 签名：字节集 区域截图 ([整数 X], [整数 Y], [整数 宽度], [整数 高度])
  • 说明：截取屏幕指定矩形区域；参数均可省略，默认截取整个虚拟屏幕。
  • 参数一│[X,Y]: 屏幕坐标左上角，省略时取虚拟屏起点。
  • 参数二│[宽度,高度]: 截图尺寸，省略或 ≤0 时使用虚拟屏宽高。

取CPU核心数

  • 签名：整数 取CPU核心数()
  • 说明：获取系统的CPU核心数

取CPU温度

  • 签名：小数 取CPU温度()
  • 说明：获取 CPU 温度（摄氏度）。优先通过 Windows 硬件/WMI 传感器读取；读取不到返回 0。部分机器/主板/权限下可能无法读取。

取内存总量

  • 签名：整数 取内存总量()
  • 说明：获取系统总内存大小（字节）

取剪贴板

  • 签名：文本 取剪贴板()
  • 说明：获取剪贴板中的文本内容。

取可用内存

  • 签名：整数 取可用内存()
  • 说明：获取系统可用内存大小（字节）

取屏幕宽度

  • 签名：整数 取屏幕宽度()
  • 说明：获取主显示器屏幕宽度（像素），内部为 GetSystemMetrics(SM_CXSCREEN)。

取屏幕高度

  • 签名：整数 取屏幕高度()
  • 说明：获取主显示器屏幕高度（像素），内部为 GetSystemMetrics(SM_CYSCREEN)。

取操作系统

  • 签名：文本 取操作系统()
  • 说明：获取当前操作系统名称文本。

取显卡温度

  • 签名：小数 取显卡温度()
  • 说明：获取显卡温度（摄氏度）。优先读取 NVIDIA WMI/常见传感器；读取不到返回 0。

取本机IP

  • 签名：文本 取本机IP([逻辑 优先IPv4=真])
  • 说明：获取本机 IP；默认优先 IPv4。
  • 参数一│[优先IPv4]: 是否优先返回IPv4地址，默认为真

取本机MAC

  • 签名：文本 取本机MAC()
  • 说明：获取本机网卡 MAC 地址。

取环境变量

  • 签名：文本 取环境变量(文本 变量名)
  • 说明：读取指定名称的环境变量值。
  • 参数一│变量名: 环境变量的名称

取用户名

  • 签名：文本 取用户名()
  • 说明：获取当前登录用户名。

取磁盘温度

  • 签名：小数 取磁盘温度()
  • 说明：获取磁盘温度（摄氏度）。优先通过 Windows Storage/SMART 传感器读取；读取不到返回 0。

取程序平台

  • 签名：整数 取程序平台()
  • 说明：取得当前编译生成的 Y++ 程序位数。64 位程序返回 64，32 位程序返回 32；返回的是目标程序平台，不受 IDE 自身位数影响。

取系统版本

  • 签名：文本 取系统版本()
  • 说明：获取操作系统版本号文本。

取系统语言

  • 签名：文本 取系统语言()
  • 说明：获取系统当前界面语言。

取计算机名

  • 签名：文本 取计算机名()
  • 说明：获取本机计算机名称。

取运行环境检测报告

  • 签名：文本 取运行环境检测报告()
  • 说明：返回最近一次检测运行环境生成的完整报告；尚未检测时返回空文本。报告可用于输出面板、日志文件或警告框。

检测运行环境

  • 签名：逻辑 检测运行环境([文本 附加DLL=""], [逻辑 显示提示=真])
  • 说明：检测程序当前运行所需的核心 Windows DLL，并可追加检查指定 DLL。返回真表示本次列出的 DLL 都可加载；返回假时用 取运行环境检测报告 取得 DLL 名称、错误码和中文说明。建议在主窗口.创建完毕中调用。
  • 参数一│附加DLL：可选。多个名称使用逗号、分号、竖线或换行分隔；可省略.dll后缀，例如winhttp,mfplat,WebView2Loader。
  • 参数二│显示提示：默认为真，检测完成后显示结果窗口；传假时只返回结果并保存报告。

取风扇转速

  • 签名：整数 取风扇转速()
  • 说明：获取风扇转速 RPM。优先通过 Windows WMI 读取；读取不到返回 0。

执行命令

  • 签名：文本 执行命令(文本 命令, [逻辑 等待完成=真])
  • 说明：执行系统命令；默认可等待完成并返回结果文本。
  • 参数一│命令: 要执行的系统命令

终止程序

  • 签名：无 终止程序([整数 退出码=0])
  • 说明：立即结束当前 Y++ 程序进程。适合验证不通过、授权失败等场景直接退出本程序；可选指定退出码。
  • 参数一│退出码: 可选，默认 0

结束程序

  • 签名：无 结束程序([整数 退出码=0])
  • 说明：立即结束当前 Y++ 程序进程。适合验证不通过、授权失败等场景直接退出本程序；可选指定退出码。
  • 参数一│退出码: 可选，默认 0

置剪贴板

  • 签名：逻辑 置剪贴板(文本 内容)
  • 说明：将文本内容写入系统剪贴板。
  • 参数一│内容: 要复制到剪贴板的文本

置环境变量

  • 签名：逻辑 置环境变量(文本 变量名, 文本 值)
  • 说明：设置环境变量的值（仅对当前进程有效）
  • 参数一│变量名: 环境变量的名称
  • 参数二│值: 环境变量的值

运行程序

  • 签名：逻辑 运行程序(文本 程序路径, [文本 参数=""], [逻辑 等待完成=假], [逻辑 显示窗口=真])
  • 说明：启动外部程序；不等待时底层为 ShellExecute open。打开网址/目录请优先用 打开网址 / 打开路径。
  • 参数一│程序路径: 要运行的程序完整路径或系统命令
  • 参数二│[文本 参数=”“]: 传给程序的命令行参数
  • 参数三│[逻辑 等待完成=假]: 是否等待进程结束
  • 参数四│[逻辑 显示窗口=真]: 是否显示程序窗口

打开网址

  • 签名：逻辑 打开网址(文本 网址)
  • 说明：用系统默认浏览器打开 URL（http/https/mailto 等）。
  • 参数一│网址: 完整 URL，如 https://www.yddphp.cn

打开路径

  • 签名：逻辑 打开路径(文本 路径)
  • 说明：用系统关联程序打开文件，或在资源管理器中打开目录。
  • 参数一│路径: 文件或文件夹完整路径

用默认程序打开

  • 签名：逻辑 用默认程序打开(文本 目标)
  • 说明：ShellExecute open：文件、目录、网址等均可。
  • 参数一│目标: 路径或 URL

退出程序

  • 签名：无 退出程序([整数 退出码=0])
  • 说明：立即结束当前 Y++ 程序进程。适合验证不通过、授权失败等场景直接退出本程序；可选指定退出码。
  • 参数一│退出码: 可选，默认 0

取系统目录

  • 签名：文本 取系统目录([整数 类型=0])
  • 说明：返回常用系统特殊目录路径。
  • 参数一│[整数 类型=0]: 0=System32，1=Windows，2=当前用户 AppData，3=桌面

易错对照

错误 正确
关机倒计时当取消 以各命令说明为准
环境变量名写错 区分大小写与用户/系统作用域

相关

进程 · 磁盘 · 窗口操作