NirCmd v2.37帮助文档中文译本（三）

win [action] [find] [window to find] [Additional Parameters] 针对子窗口 win child [find] [top window to find] [action] [find] [child window to find] [Additional Parameters] 通过此命令，可以关闭、隐藏、显示、最大化和最小化指定的窗口。 参数 [action]:对指定的窗口要进行的操作： child: 对指定顶级窗口的子窗口进行操作。 close:关闭指定窗口。 hide: 隐藏指定窗口。 show: 显示指定窗口(在用hide命令隐藏后)。 hideshow:隐藏指定窗口然后再显示此窗口。可用此命令重新填写窗口内容。 activate: 把指定窗口放到上层。 max: 最大化指定窗口。 min: 最小化指定窗口。 normal:最大、最小化指定窗口后，恢复其到正常状态。 trans:使指定窗口透明。参数[Additional Parameters]指定透明程度，值位于0 - 255之间。0 = 完全透明。255 = 完全不透明。 setsize: 设定指定窗口的大小。参数[Additional Parameters]指定窗口的大小，值包括x，y，width，height。 move: 移动/调整窗口。参数[Additional Parameters]指定要移动/调整的像素点数，值包括：x，y，width，height。 center: 指定窗口居中。 settopmost:设置指定窗口的最上层显示状态。如果参数[Additional Parameters]为1，指定窗口为最上层显示，如果为0，则取消最上层显示。 redraw:刷新指定窗口。 settext:修改指定窗口标题/名称。 focus: 在指定窗口上设置焦点。 disable:禁用指定窗口。 enable: 启用指定窗口。 +style: 对指定窗口增加样式常量。参数[Additional Parameters] 指定了增加的样式常量。 -style:移除指定窗口的样式常量。参数[Additional Parameters]指定要移除的样式常量。 +exstyle: 对指定窗口增加扩展样式常量。参数[Additional Parameters]指定要增加的扩展样式常量。 -exstyle:移除指定窗口的扩展样式常量。参数[Additional Parameters]指定要移除的扩展样式常量。 postmsg: 传递信息到指定窗口。参数[Additional Parameters]中的三个值指定了信息参数：Msg, wParam, lParam。 sendmsg: 发送信息到指定窗口。参数[Additional Parameters]中的三个值指定了信息参数：Msg, wParam, lParam。 dlgclick:发送一个鼠标单击命令到对话框内的按钮。参数[Additional Parameters] 指定了按钮的控件ID，或者下列预定义的按钮之一： yes, no, ok, cancel, retry, ignore, close, help。 dlgsettext: 设置文本到对话框内部指定控件。参数[Additional Parameters] 指定了控件ID。 dlgsetfocus: 设置焦点到对话框内部指定控件。参数[Additional Parameters] 指定了按钮的控件ID。 [find]:指定了找到窗口的方式： handle: 通过在参数[window to find]中指定窗口句柄来查找指定窗口。 id: 通过指定子窗口的ID查找需要的子窗口。适用于子窗口。 class: 通过在参数[window to find]中指定窗口类名来查找指定窗口。 title: 通过在参数[window to find]中指定精确的窗口名来查找指定窗口。 stitle:通过在参数[window to find]中指定窗口的前几个字符来查找指定窗口。 ititle: 通过指定一系列存在于窗口标题中的字符来查找指定窗口。 alltop: 所有顶层窗口。 alltopnodesktop: 所有顶层窗口，除了桌面与盘符窗口。 active: 当前活动窗口。 foreground: 前台窗口。 desktop: 桌面窗口 [window to find]: 根据前面参数的值，通过句柄、类名或标题来指定窗口。 例: win close title "calculator" win hide stitle "calculat" win hide ititle "culat" win show class "SciCalc" win activate title "my computer" win max handle 0x00009c01 win redraw alltop win trans ititle "internet explorer" 192 win setsize class "IEFrame" 50 50 400 300 win settopmost class "SciCalc" 1 win child class "Shell_TrayWnd" hide class "button" win child class "Shell_TrayWnd" show class "button" win child title "calculator" hide id 128 win -style title "my computer" 0x00C00000 win child title "my computer" +exstyle all 0x00400000 win sendmsg title "calculator" 0x10 0 0 win dlgclick class "#32770" cancel

cdrom [action] {drive:} 此命令允许弹出/弹入光驱。参数[action]可以为：open或者close。如果不指定{drive:}参数，会使用默认驱动器。 例: cdrom open cdrom close cdrom open J: cdrom close R:

clipboard [Action] [Parameter] 允许写入以及清空剪切板。 [Action] 包含下列值之一： set - 把指定文本放入剪切板。 readfile - 把指定文本文件中的内容放入剪切板。 clear - 清空剪切板。 writefile - 把剪切板中内容写入文件。(只适用于文本文件) addfile - 把剪切板中内容添加到文件。(只适用于文本文件) saveimage - 保存剪切板中的图像到文件。 copyimage - 复制指定图像文件中的图像到剪切板。 saveclp - 保存当前剪贴板数据到系统剪贴板文件。 loadclp -加载系统剪贴板文件到剪贴板 对于copyimage 和 saveimage操作，支持以下格式：.bmp, .gif, .jpg, .png, .tiff - 只在安装有GDI+的计算机上有效(在XP/2003/Vista上，GDI+已经作为操作系统的一部分被安装在计算机上)。 例: clipboard set "123456" clipboard set ~$folder.desktop$ clipboard set ~$folder.start_menu$ clipboard readfile "c:\temp\info1.txt" clipboard addfile "c:\temp\clip1.txt" clipboard clear clipboard saveimage "c:\temp\clip01.png" clipboard saveimage "c:\temp\clip01.gif" clipboard copyimage "c:\temp\img01.gif" clipboard saveclp "c:temp\1.clp" clipboard loadclp "c:temp\1.clp"

gac [Action] [Parameter] 允许安装全局程序集缓存(GAC)中的一个程序集。 例: gac install "C:\temp\MyAssembly\bin\Release\6\MyAssembly.dll"

beep [Frequency] [Duration] 发出嘟嘟声。参数[Frequency]指定发声频率，单位赫兹。参数[Duration]指定发声持续时间，单位毫秒。在Windows 95/98/ME中, 以上参数被忽略，只会发出一声标准的嘟嘟声。 例: beep 500 2000

stdbeep 发出Windows标准嘟嘟声。 例: stdbeep

setvolume [device] [left-volume] [right-volume] 设置音量。参数[device]代表声音设备标识符。大多数情况下，此参数设置为0。在Windows Vista下，默认重放设备指定为1，默认录音设备指定为0。 参数[left-volume]和[right-volume]值位于0(静音)和65535(最大音量)之间，代表了音量的左右声道。 例: setvolume 0 0 0 setvolume 0 32768 32768 setvolume 0 0xffff 0

setsysvolume [volume] {Component} {Device Index} 设置系统音量。修改此值亦会影响控制面板下的音量设置。参数[volume]的值位于0(静音)和65535(最大音量) 之间。 {Component}是可选参数，指定了下列声音组件之一：master(主音量)、waveout(波形输出)、synth(合成器)、cd、microphone(麦克风)、phone、aux(音频输入口)、line(线路)、headphones(耳机)、wavein(波形输入)。默认值是master(主音量)。在Windows Vista下，声音窗口(控制面板->声音)下的显示的设备必须识别此组件名。如果设备名包含空格，两边必须加引号。 {Device Index}是可选参数，指定了声音设备索引。如果有一个以上声卡，那么可以使用此参数。如果没有制定此参数，默认使用控制面板中指定的声卡。 例: setsysvolume 0x8000 setsysvolume 0 setsysvolume 25000 waveout setsysvolume 25000 master 1 Vista例: setsysvolume 0x8000 setsysvolume 0 "front mic" setsysvolume 25000 speakers setsysvolume 25000 "line in"

setsysvolume2 [left volume] [right volume] {Component} {Device Index} 类似于setsysvolume命令，但此命令不是设置整个音量，而是单独设置左声道和右声道。 例: setsysvolume2 10000 20000 setsysvolume2 30000 0 setsysvolume2 25000 15000 waveout setsysvolume2 30000 0 master 1

changesysvolume [volume change] {Component} {Device Index} 增加或降低系统音量。参数[volume change]指定增加或降低的单位。(负数降低，正数增加) {Component} 是可选参数，指定了下列声音组件之一：master(主音量)、waveout(波形输出)、synth(合成器)、cd、microphone(麦克风)、phone、aux(音频输入口)、line(线路)、headphones(耳机)、wavein(波形输入)。默认值是master(主音量)。在Windows Vista下，声音窗口(控制面板->声音)下的显示的设备必须识别此组件名。如果设备名包含空格，两边必须加引号。 {Device Index}是可选参数，指定了声音设备索引。如果有一个以上声卡，那么可以使用此参数。如果没有制定此参数，默认使用控制面板中指定的声卡。 例: changesysvolume 5000 changesysvolume -3000 changesysvolume 0x1000 waveout changesysvolume 0x1000 master 1 Vista 例: changesysvolume 5000 changesysvolume -3000 changesysvolume 0x1000 "line in" changesysvolume 0x1000 "speakers" 1

changesysvolume2 [left volume change] [right volume change] {Component} {Device Index} 类似changesysvolume命令，但此命令不是设置整个音量，而是单独设置左声道和右声道。 例: changesysvolume2 1000 -1000 changesysvolume2 -3000 0 changesysvolume2 0 -5000 waveout changesysvolume2 -3000 0 master 1

mutesysvolume [action] {Component} {Device Index} 静音/取消静音 参数[action]中，指定1表示静音，0表示取消静音，2表示在静音与正常之间切换。 第二个参数为可选参数，可以指定下列声音组件之一：master(主音量)、waveout(波形输出)、synth(合成器)、cd、 microphone(麦克风)、phone、aux(音频输入口)、line(线路)、headphones(耳机)、wavein(波形输入)。默认 值是master(主音量)。在Windows Vista下，声音窗口(控制面板->声音)下的显示的设备必须识别此组件名。如果设备名包含空格，两边必须加引号。 {Device Index}是可选参数，指定了声音设备索引。如果有一个以上声卡，那么可以使用此参数。如果没有制定此参数，默认使用控制面板中指定的声卡。 例: mutesysvolume 1 mutesysvolume 0 mutesysvolume 2 waveout mutesysvolume 1 master 1 Vista 例: mutesysvolume 1 mutesysvolume 0 mutesysvolume 2 "rear mic" mutesysvolume 1 speakers 1

wait [milliseconds] 等待指定的毫秒数。 例: wait 1000 wait 500

shellrefresh 进行Windows资源管理器的全面刷新。如果更改了注册表中相关的外壳文件类型，并且需要立即生效，此命令非常有效。 (例：如果改变了gif文件图标)

sysrefresh {Refresh Type} 进行全面的系统刷新。在更改了注册表中的系统设置后可以使用此命令刷新系统(例：更改了图标大小，环境变量等等)。{Refresh Type}为可选参数。可以指定下列值之一： "environment" - 更新系统变量，"policy" - 更新策略设置， "intl" - 更新本地设置。 例: sysrefresh sysrefresh environment sysrefresh policy

setcursor [X] [Y] 设置鼠标位置。参数[x]和[y]指定光标位置。 例: setcursor 100 50

setcursorwin [X] [Y] 设置鼠标位置，此位置相对于活动窗口的左上角。参数[x]和[y]指定光标位置。 例: setcursorwin 100 50

movecursor [X] [Y] 移动鼠标。参数[x]和[y]指定移动的像素点数。 例: movecursor 10 10

dlg [Process Name] [Window Title] [Action] [Parameters] 允许与Windows标准对话框和信息框进行交互。打开一个对话框时，可以使用此命令"点击"确认/取消/是/否按钮，或者将文本框填入对话框。 例如，下面的命令会将calc.exe进程填入Windows的"运行"对话框，然后点击"确认"按钮。12298是"运行"对话框中文本框的控件ID。 可以使用微软的Spy++或者使用my WinExplorer utility来查找控件ID。 dlg "explorer.exe" "run" settext 12298 "calc.exe" dlg "explorer.exe" "run" click ok 下面的命令会对任何资源管理器的询问对话框点击"是"。 dlg "explorer.exe" "" click yes 下面的命令会对任何进程的询问对话框点击"否"。 dlg "" "" click cancel 参数描述: [Process Name]: 指定要操作的窗口所从属的进程。可以仅指定进程名或者进程的完整路径。如果此参数为空串("")，命令会在任何进程上执行。 [Window Title]: 指定要操作的窗口的标题。如果此参数为空("")，命令会不管标题而在任何窗口上执行。 [Action]:可以指定下列选项之一： click: 点击指定按钮。可以指定下列预设值之一(仅适用于标准Windows对话框)： yes, no, ok, cancel, retry, ignore, close, help.还可以指定任何控件ID作为数字型值。 settext: 设置指定控件的文本。此操作的第一个参数指定控件ID，第二个参数指定文本。

dlgany [Process Name] [Window Title] [Action] [Parameters] 类似于dlg命令，但还可以用于其他任何窗口，包括非标准Windows对话框。

returnval [Return Value] 此命令允许为NirCmd命令指定返回值。在外部程序调用NirCmd.exe是会用到返回值。 例如，在下面命令中，如果用户选择"是"，则NirCmd返回值为0x30。 qboxcom "Do you want to continue ?" "question" returnval 0x30

sendkey [Key] [press | down | up] 向系统发送击键命令。操作系统会按照执行，就好像用户真的按压了键盘上指定键一样。 参数[key]指定虚拟键代码(如：0x2e代表delete键)，或者作为下列预设值之一：a - z 和 0 - 9(对应字母数字键)，F1 - F24 (对应Fxx键), shift, ctrl, alt, enter, esc。 第二个参数指定了指定键的操作：'press', 'down',或者 'up'。 对每一个down操作，还应该添加up操作。 在下面的脚本例子中，系统会执行就好像用户按了Shift+Ctrl+Esc一样 (会显示任务管理器): sendkey shift down sendkey ctrl down sendkey esc down sendkey shift up sendkey ctrl up sendkey esc up 更多例子: sendkey a press sendkey f10 press sendkey enter press sendkey 0x2e press

sendmouse [right | left | middle] [down | up | click | dblclick] sendmouse [move] [x] [y] sendmouse [wheel] [Wheel Value] 向系统发送指定的鼠标事件。操作系统会执行就好像用户真的做出了指定的鼠标操作。 一些sendmouse命令的例子: 发送点击鼠标右键事件(对大多数应用程序而言，会打开一个上下文本目录)： sendmouse right click 发送一个双击鼠标左键事件： sendmouse left dblclick 按下鼠标左键，把鼠标往左移动20像素点，向下移动30像素点，然后松开鼠标左键。 sendmouse left down sendmouse move -30 20 sendmouse left up 滚动10个单位(标准滑轮鼠标)的鼠标滑轮。(在标准滑轮鼠标上，滑轮值是120的倍数) sendmouse wheel 1200

convertimage [source filename] [destionation filename] 把图像文件转化为其他格式。支持一下格式：.bmp, .gif, .png, .jpg, .tiff 适用于Windows XP/2003/Vista (需要GDI+) 例: convertimage "c:\temp\test1.gif" "c:\temp\test1.png" convertimage "c:\temp\test1.jpg" "c:\temp\test1.gif"

convertimages [source wildcard] [extension] 把多个图像文件转化为其他格式。支持以下格式：.bmp, .gif, .png, .jpg, .tiff 适用于Windows XP/2003/Vista (需要GDI+) 例: convertimages "c:\temp\a*.gif" .png convertimages "c:\temp\*.jpg" .gif

savescreenshot [filename] 保存当前屏幕截图到指定的图像文件。支持以下格式.bmp, .gif, .png, .jpg, .tiff 适用于Windows XP/2003/Vista (需要GDI+) 例: savescreenshot "c:\temp\shot.png"

savescreenshotfull [filename] 类似savescreenshot，但在具有多个监视器的计算机上，该命令将采集所有监视器的屏幕截图， savescreenshot只采集主监视器的屏幕截图。

savescreenshotwin [filename] 保存当前活动窗口截图到指定图像文件支持以下格式 .bmp, .gif, .png, .jpg, .tiff 适用于Windows XP/2003/Vista (需要GDI+) 例: savescreenshotwin "c:\temp\win.png"

shellcopy [source file or wildcard] [destination] {Flags} 从一个文件夹复制一个或多个文件到其他文件夹，并且就像资源管理器下复制文件时一样显示进程框。 对于参数{Flags}，可以指定一个或多个下列值： yestoall: 对所有询问回答"是"。 noerrorui: 在用户界面不显示错误信息。 silent: 安静模式 - 不显示复制进度信息。 nosecattr:不复制文件的相关属性。 例: shellcopy "c:\temp\*.*" "d:\temp" shellcopy "c:\temp\*.*" "d:\temp" yestoall noerrorui

filldelete [source file or wildcard] 零字节填充指定文件或通配符文件，然后删除文件。这也就意味着用此命令删除掉的文件不可再被恢复。 例: filldelete "c:\temp\*.*" filldelete "c:\temp\myfile.dat"

speak [type] [text/Filename] {rate} {volume} 通过使用Windows XP和Windows Vista中的语音库（SAPI），朗读指定的文本或者文件的内容。 在[type]参数可以指定下列类型： text:简单的文本。 xml: 语音XML数据文本。 file:文本文件的文件名。 {rate}是一个可选的指定语速的参数，数值在-10（非常缓慢）和10（非常快）之间。{volume}参数指定音量，数值在0和100之间。 例: speak text ~$clipboard$ speak text "Please visit the Web site of NirSoft at http://www.nirsoft.net" 2 80 speak file "c:tempspeak1.txt"