YStudio Y++

截图类:全屏、区域、窗口、框选与保存复制

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


slug: s2-08-screenshot title: 截图类:全屏、区域、窗口、框选与保存复制 summary: 截图类全屏/区域/窗口/框选得到字节集;可保存、另存为、复制到剪贴板;可置格式与JPEG质量、含光标与隐藏本进程。 tags: 截图类,全屏,框选,区域,保存 series: supportlib-s2 series_order: 8 type: tutorial


截图类:全屏、区域、窗口、框选与保存复制

面板:支持库 → 扩展类库 → 截图类。

硬约束

  1. 类型名必须写「截图类」。
  2. 全屏 / 区域 / 窗口 / 框选 返回图像字节集;也可用类内 保存 / 另存为 / 复制。
  3. 框选() 须在界面线程;无工具窗时 Enter 确认、Esc 取消。
  4. 失败看 取错误();也可用 图片_是否有效 判断返回图。

窗口:按钮全屏 按钮区域 按钮框选 按钮复制 编辑框日志

截图类 g_shot

函数 写日志(文本 s) {
    编辑框日志.文本 = 编辑框日志.文本 + s + 换行符
}

函数 主窗口.创建完毕() {
    g_shot.置格式("png")
    g_shot.置JPEG质量(90)
    g_shot.置含光标(假)
    g_shot.置隐藏本进程(真)
    写日志("显示器数=" + 到文本(g_shot.取显示器数()))
}

函数 按钮全屏.单击(整数 X, 整数 Y) {
    文本 出 = 取临时目录() + "\\ypp_shot_full.png"
    字节集 图 = g_shot.全屏()
    如果 (图片_是否有效(图) == 假) {
        写日志("全屏失败:" + g_shot.取错误())
        返回 ()
    }
    // 写法 A:类内保存
    如果 (g_shot.保存(出) == 假) {
        // 写法 B:图片_写文件
        图片_写文件(图, 出)
    }
    写日志("全屏已存 " + 出 + " 矩形=" + g_shot.取最后矩形())
}

函数 按钮区域.单击(整数 X, 整数 Y) {
    // 区域(左, 上, 宽, 高)
    字节集 图 = g_shot.区域(0, 0, 400, 300)
    如果 (图片_是否有效(图) == 假) {
        写日志("区域失败:" + g_shot.取错误())
        返回 ()
    }
    文本 出 = 取临时目录() + "\\ypp_shot_region.png"
    图片_写文件(图, 出)
    写日志("区域已存 " + 出)
    // 写法 B:窗口截图
    // 字节集 w = g_shot.窗口(主窗口.取窗口句柄())
}

函数 按钮框选.单击(整数 X, 整数 Y) {
    字节集 图 = g_shot.框选()
    如果 (图片_是否有效(图) == 假) {
        写日志("取消或失败:" + g_shot.取错误())
        返回 ()
    }
    文本 出 = 取临时目录() + "\\ypp_shot_box.png"
    g_shot.另存为(出)
    写日志("框选已存 " + 出 + " 选区=" + g_shot.取框选矩形())
}

函数 按钮复制.单击(整数 X, 整数 Y) {
    字节集 图 = g_shot.全屏()
    如果 (图片_是否有效(图) == 假) {
        写日志(g_shot.取错误())
        返回 ()
    }
    如果 (g_shot.复制()) {
        写日志("已复制到剪贴板")
    } 否则 {
        写日志("复制失败:" + g_shot.取错误())
    }
}

对照:截图类