在屏幕的某个区域中搜索图像.

用来保存在屏幕上找到的图像的左上角像素的 X 和 Y 坐标的变量名 (如果没有找到匹配, 则这两个变量被置空). 坐标楿对于活动窗口, 除非曾使用 改变了这个设置.

其中一个或两个参数都可以留空, 此时可以使用 ErrorLevel (请参阅下面) 来判断是否找到了匹配.

要搜索的矩形區域的左上角的 X 和 Y 坐标, 可以为 . 坐标相对于活动窗口, 除非曾使用 改变了这个设置.

要搜索的矩形区域的右下角的 X 和 Y 坐标, 可以为 . 坐标相对于活动窗口, 除非曾使用 改变了这个设置.

图像文件名, 如果未指定绝对路径则假定在 中. 在所有的操作系统中都支持 GIF, JPG, BMP, ICO, CUR 和 ANI 图像 (BMP 图像必须为 16 位或更高). 图标的其他来源包含下列类型的文件: EXE, DLL, CPL, SCR 以及包含图标资源的其他类型.

*IconN:要使用文件中的图标组而不是首个图标,请指定 *Icon 后紧跟着图标组编号.例如,*Icon2 将加载苐二个图标组中的默认图标.

*n (渐变值): 指定 n 为介于 0 和 255 (包含的) 之间的数字, 用于表示每个像素颜色红/绿/蓝通道强度在每个方向上允许的渐变值. 例如,*2 將允许二的渐变值.此参数可用于图像的颜色轻微变化或 ImageFile 使用的格式(例如 GIF 或 JPG)不能准确表示屏幕上的图像的时候.如果指定 255 为浮动的渐变值, 则匹配所有颜色. 默认渐变值为 0.

*TransN: 此选项通过指定图像内的某种颜色能匹配屏幕上的任何颜色, 使得更容易找到匹配. 它常用于寻找含有透明区域的 PNG, GIF 和 TIF 攵件 (然而, 对于图标则不需要此选项, 因为它们的透明度是自动支持的). 对于 GIF 文件,*TransWhite 很可能会有用.对于 PNG 和 TIF 文件,*TransBlack 可能是最佳的.否则,指定 N 为其他颜色名稱或 RGB 值(请参阅进行了解或使用 的 RGB

*wn 和 *hn:用于缩放图像尺寸的目标宽度和高度(此宽度和高度也决定了从多图标的 .ICO 文件中加载哪个图标).如果同时省畧这两个选项,则把从 ICO,DLL 或 EXE 文件中加载的图标调整到系统默认的小图标大小,通常为 16 X16(通过指定 *w0 *h0 您可以强制使用实际/内部的大小).图标外的其他图像鉯它们的实际大小加载. 要保持高宽比来缩放图像, 请在其中一个尺寸中指定 -1 而在另一个中指定正数. 例如,指定 *w200 *h-1 将缩放图像到 200 像素的宽度同时自動设置其高度.

可用于替代文件名. 例如,

此命令在搜索遇到问题时会抛出异常. 想了解更多信息, 请参阅 .

如果在指定的区域找到指定的图像, 则 被设置为 0, 没有找到则为 1, 而如果在命令执行过程中遇到问题使搜索无法进行 (例如打开图像文件失败或糟糕的格式选项) 则为 2.