qk.Screen:截屏
获取屏幕图像:截屏、截窗口、框选截图、Quicker 截图、取色与显示器信息(屏幕物理像素);只要坐标不要图像见 qk.Ui.PickArea。PickCapture 与 CapturePro 合计每次运行 64 次;截屏计入每次运行 1000 次截图;停止脚本会关闭框选界面。
Screen.Capture
Img Capture(Rect? area = null, string screen = "all")
截取屏幕。
| 参数声明 | 说明 |
|---|---|
Rect? area = null | 区域(屏幕物理像素);null 时按 screen。 |
string screen = "all" | all(全部显示器)|primary(主屏)|mouse(鼠标所在屏)。 取值:all、primary、mouse。 |
返回类型:Img。空值、用户取消和异常行为以成员及域说明为准。
Screen.CaptureWindow
Img CaptureWindow(Win window, bool background = false)
前台截图按窗口快照 Bounds(外框)采集,与 ToScreen 优先使用的 DWM 可见边界原点可能不同。图内识别点不能直接传 ToScreen;需要实时定位点击时优先使用窗口范围的 Vision.Find*,其结果已是屏幕坐标。
| 参数声明 | 说明 |
|---|---|
Win window | 见本成员和所在域的说明。 |
bool background = false | 后台截图(PrintWindow):窗口被遮挡也能截,部分程序为黑图;最小化窗口不可截。 |
返回类型:Img。空值、用户取消和异常行为以成员及域说明为准。
Screen.PickCapture
CaptureResult? PickCapture(bool detect = true, int delayMs = 0)
由用户框选区域并截图;取消返回 null。脚本被停止时框选界面随之关闭。
| 参数声明 | 说明 |
|---|---|
bool detect = true | 自动识别窗口/控件区域。 |
int delayMs = 0 | 开始框选前的延迟毫秒。 |
返回类型:CaptureResult?。空值、用户取消和异常行为以成员及域说明为准。
Screen.CapturePro
CaptureResult? CapturePro(string mode = "capture")
打开 Quicker 截图;取消返回 null;截图不写入截图历史。capture/captureNow 在用户确认后以 CaptureResult.Image 返回截图。
| 参数声明 | 说明 |
|---|---|
string mode = "capture" | capture|captureNow|copy|pin|ocr|ocrCopy|table|formula|translate|imageTranslate|quickSave(不区分大小写);仅 ocrCopy 返回文字(识别失败报 CAPTURE_PRO_FAILED),ocr/table/formula/translate/imageTranslate 打开结果界面。copy/ocrCopy 写入剪贴板,quickSave 写入文件;pin/ocr/ocrCopy/table/formula/translate/imageTranslate 的识别可能回退在线或自动下载模型。 取值:capture、captureNow、copy、pin、ocr、ocrCopy、table、formula、translate、imageTranslate、quickSave。 |
返回类型:CaptureResult?。空值、用户取消和异常行为以成员及域说明为准。
Screen.GetPixel
string GetPixel(Pt point)
读取屏幕点(Pt,物理像素)的颜色,返回 "#RRGGBB";不计入 1000 次截图(适合轮询);点不在屏幕上报 INVALID_ARGUMENT。
| 参数声明 | 说明 |
|---|---|
Pt point | 见本成员和所在域的说明。 |
返回类型:string。空值、用户取消和异常行为以成员及域说明为准。
Screen.List
ScreenInfo[] List()
全部显示器信息(主屏在前);ScreenInfo.Id 可传给 qk.Sys.GetBrightness/SetBrightness 的 screen。
返回类型:ScreenInfo[]。空值、用户取消和异常行为以成员及域说明为准。