下面列出了 AutoHotkey 当前开发分支(也称为 AutoHotkey_L)新增的功能。
对于较旧的变更,请参阅存档变更。
改变内置的错误和警告对话框为置顶。
修正 Until
不会从递归的文件和注册表循环中中断的错误。
添加 A_OSVersion 值 WIN_8.1
。
改变 Hotkey 命令根据是否存在颚化符(~)前缀应用或移除热键已有变体的穿透行为。
改变 exe manifest 以允许 GetVersion/GetVersionEx 检测到 Windows 8.1。
修正当 Function 为纯整数 0 时 DllCall() 会让脚本崩溃的问题。
修正 IsFunc("ComObj(")
返回错误而不抛出异常的问题。
修正 ControlClick 发送 XButton1/XButton2 时存在的问题。
修正当 X.__Init
中止线程时 new X
中内存泄漏的问题。
修正当断点散布在方法定义中时会转移到类变量初始化位置的问题。
修正 x::
和 x up::
,当 x 作为修饰键被阻止在按下触发时则让它们都在弹起时才触发。在 v1.1.14 中的预期行为是当 x 还用于自定义组合键(如 x & y::
)的时候,则 x 的单独热键和组合键都会在弹起时触发。
修正不带 Catch/Finally 的 Try 过程中无异常抛出时崩溃的错误。
增加 Finally 语句用于 try/catch 后的清理操作。[fincs]
改变自定义组合键中 ~ 前缀的行为,使之更直观。
修正 x & y::
热键中,在释放x时会触发 x::
和 x up::
热键的问题。
修正 ImageSearch,当 GDI 调用失败时设置 ErrorLevel=2(而非0)。
修正 EnvGet,当变量超过 32767 个字符时致使程序崩溃的问题。
修正在 StatusBarWait 的 ErrorLevel 中一个小的错误处理缺陷。
修正 ANSI 版本中 FileRead *c 存在的堆损坏。
修正递归调用中传递局部变量到可变参数函数。
修正脚本第一行为小括号括住的表达式时,脚本加载失败的问题。
修正 PixelSearch 快速模式,使其仅在成功时才设置 OutputVarX/Y。
Fixed variadic function calls with named values for required parameters.
Ported StrSplit() from v2 alpha.
Optional parameters can be omitted by writing two consecutive commas, as in InStr(a, b,, 2)
. Unlike previous versions, this now works for objects (including COM objects) and built-in functions. [a,,b]
can be used to create a sparse array.
Object properties can now be set using variadic syntax, as in x[y*]:=z
, where y contains an array of keys/indices or parameters.
Fixed GuiControl/Get to accept the ClassNN of a ComboBox's child Edit. Specifying the HWND of a ComboBox's child Edit was already supported as a means of identifying the ComboBox.
Fixed InputBox default width/height (broken by v1.1.11.00 - commit 7373cc6443).
Fixed DllCall arg type validation to handle SYM_OBJECT safely, and to respect #Warn UseUnset (when var name is not a valid type).
Changed VarSetCapacity(var) to never warn about uninitialized vars.
Added support for %A_LineFile%
in #Include.
Reduced the file size of AutoHotkeySC.bin by reducing the resolution of the (rarely used) filetype icon.
Fixed class X extends Y
to allow Y to be defined after X.
Developed by fincs: AutoHotkey is now DPI-aware. The Gui commands automatically compensate when DPI is not 96. See Gui -DPIScale.
Improved RegRead to support REG_BINARY values larger than 64K.
Improved RegWrite to support REG_BINARY/REG_MULTI_SZ values larger than 64K.
Fixed Process Close (and possibly other things) on Windows XP.
Added basic support for custom Gui control types.
Revised SoundSet, SoundGet and 'WaveVolume commands to better support Windows Vista and later.
Fixed Run "<file>" <args>
to not pass the space as part of the args.
Fixed some issues with reading from console input (CONIN$).
Fixed Gui menu accelerator keys not working when the Gui itself (not a control) has focus.
Fixed two bugs which affected certain assignments where the target variable contains an unflushed binary number but has zero capacity.
Fixed GuiControl and GuiControlGet acting on the wrong control when given a HWND which does not belong to the current Gui. Instead, the condition is treated as an error.
Fixed OnMessage functions to set A_Gui and A_GuiControl correctly when the target Gui is a child window.
Fixed MsgBox to show an error message when given invalid Options, instead of silently exiting the thread.
Fixed syntax errors in class var initializers causing the program to crash without the proper error message.
Fixed AND/OR following a multi-statement comma, like ((x, y) and z)
.
Fixed RegExReplace to support duplicate subpattern names correctly.
Fixed Object.Remove() not freeing string keys.
Fixed base.Invoke() to not depend on dynamic variable resolution.
Removed .aut file compatibility and #AllowSameLineComments.
Removed undocumented AutoIt v2 commands.
Allow optional parameters to be declared with :=
instead of =
, for consistency with variable declarations and expressions.
Allow non-ASCII characters in unquoted keys ({key: x}
and obj.key
).
Changed name in version info from "AutoHotkey_L" to "AutoHotkey".
Fixed instability caused by warning dialogs appearing part-way through evaluation of a command's args.
Fixed PixelSearch Fast mode treating "not found" as an error.
Fixed ahk_exe to allow other ahk_ criteria after it.
Fixed else continue 2
and similar requiring braces around the loop.
Fixed RegRead indicating failure after successfully reading binary data.
Fixed File.Length
to compensate for or flush any buffered data.
Fixed Gui sizing to account for scrollbars when present.
Added support for asynchronous commands.
Improved handling of breakpoints on lines like else foo()
or { bar()
so that the debugger will actually break when appropriate.
Optimized code size, fixed several bugs and made the debugger generally more robust.
Debugger: Fixed max_depth being either half the intended limit or unlimited.
Changed the default script codepage to ANSI, as the previous behaviour was a common source of confusion. UTF-8 files must now have a byte order mark (BOM) to be recognized correctly. Notepad adds a BOM to any file saved as UTF-8.
Changed return x
to preserve formatting of numeric strings; it is now equivalent to return (x)
.
Changed Gui, Name: New
to set the new GUI as the default.
Changed ClipboardAll to prefer CF_UNICODETEXT over other text formats.
Changed Gui Show to allow floating-point numbers.
Changed A_OSVersion to return WIN_8 on Windows 8.
Changed AutoHotkey.exe file description to include "ANSI/Unicode 32/64-bit".
Changed the parser to allow lines like new MyObject()
with no assignment.
Upgraded PCRE to 8.30.
Improved wording of some warnings and added a pointer to the documentation at the bottom of the warning dialog.
Improvements to the debugger:
Added support for the PCRE construct (*MARK:NAME)
via RegExMatchObject.Mark
.
Added support for classvar.x := y
assignments in class definitions (after declaring classvar).
Added A_Is64bitOS.
Added SetRegView and A_RegView.
Fixed Func.()
to merely skip the function call if mandatory parameters were omitted instead of causing the thread to silently exit.
Fixed Object.Remove()
not releasing object keys.
Fixed key-down/key-up hotkey pairs to suppress input correctly when only one hotkey in the pair is enabled.
Fixed #Include <Lib>
to not affect the working directory used by subsequent #include directives.
Fixed objaddref()
acting like ObjRelease()
when called with a lower-case 'a'.
Fixed A_AhkPath in 32-bit compiled scripts to detect 64-bit AutoHotkey installations and vice versa.
Fixed TreeView controls with -Background
option rendering incorrectly on older OSes.
Fixed error messages shown during execution of While/Until to identify the appropriate line.
Fixed Ctrl/Alt/Shift key-down hotkey breaking any corresponding key-up hotkey defined before it.
Fixed key-down hotkeys to always use the hook if defined after a key-up hotkey of the same key. If the key-down hotkey used the "reg" method, the hook would block the key-down event and trigger only the key-up hotkey.
Fixed load-time checks interpreting expressions with no derefs as raw text. For example, gosub % "foo"
resolved to "foo":
at load-time. Similarly, % ""
was seen as invalid in various cases even if an empty string should be allowed.
Fixed a rare crash which can occur when GetClipboardData() fails.
Fixed ComObjArray() to return an empty string on failure instead of an arbitrary integer.
Fixed Object.Remove(i, "")
affecting integer keys when !Object.HasKey(i)
.
Fixed FileRead to ignore #MaxMem when reading UTF-16 on Unicode builds.
Fixed dynamic function calls with built-in vars such as %A_ThisLabel%()
.
Enhanced %var%()
to support function references, objects imitating functions and the default __Call meta-function.
Fixed ControlGet List to work for ListViews where the script and the target process aren't both 32-bit or both 64-bit.
Fixed SendEvent with a key delay of 0; a change introduced by v1.1.05.04 caused it to be slower than intended.
Fixed Object.Remove(i) not adjusting keys if Object[i] doesn't exist.
Fixed an error in ComObjType() which may have caused unpredictable behaviour when it is called via an alternative name.
Fixed ExitApp to exit the thread if an OnExit subroutine prevents the script from terminating, instead of resuming execution after the block which contained ExitApp.
Calling a function via an object no longer acts as a barrier to exiting the thread. Consequently, if Exit is used or a runtime error occurs within a class method, the entire thread exits instead of just the function.
Calling a base-class method using base.Method() or similar inside a class definition no longer causes a UseUnset warning if the method doesn't exist. Consequently, instantiating an object which has instance variables no longer causes a warning about the internal base.__Init
method if the base class has no instance variables.
Fixed IniRead crashing when Section is omitted but Key isn't.
Fixed accuracy of FileGetSize with files which are 4GB or larger.
Fixed MsgBox smart comma handling to require numeric Options, not Title.
Integrated #InputLevel directive and SendLevel command by Russell Davis.
Integrated support for Link controls by ChrisS85.
Changed command parser to avoid trimming escaped characters such as `t
or `
at the beginning or end of an arg.
Changed MsgBox's smart comma handling to improve flexibility and consistency.
%
can now be used to make Options or Timeout an expression.%Timeout%.500
). Contrary to the
documentation, the former behaviour interpreted most other cases
beginning with %
as expressions (containing a double-deref).Changed A_IsUnicode/A_IsCompiled to be defined as an empty string in ANSI versions/uncompiled scripts instead of being left undefined. This allows them to be checked without triggering #Warn warnings. Side effects include:
Changed Send and related commands to respect #MenuMaskKey when changing modifier keystates.
Changed GuiControl Choose to remove the ListBox/ComboBox/DDL's current selection when N=0.
Changed RegisterCallback to allow a Func object in place of a name.
Changed ListLines to show filenames (except when compiled).
Improved Run to output a process ID if possible when ShellExecuteEx is used.
Fixed handle leaks in RegRead.
Fixed x.y++
and similar to assign an empty string if x.y is non-numeric.
Fixed SendInput Win+L workaround causing Win key to "stick down".
Fixed Ahk2Exe auto-including the wrong file if an auto-include used #Include <Lib>.
Fixed inc (++) and dec (--) having no effect when used on an object field containing a string.
Fixed inc (++) and dec (--) to cause a warning when used on an uninitialized variable.
Fixed continue n
misbehaving when an inner loop has no braces.
Fixed RegExMatchObject[Name]
to work correctly with duplicate names.
Fixed: Selected sub-command of ControlGet was unreliable on x64.
Fixed: CPU was maxed out while waiting if an underlying thread displayed a dialog (and possibly in other cases).
Fixed Loop ... Until VarContainingObject
.
Fixed false detection of end-of-file when loading a compiled script in some cases.
Fixed SendInput to automatically release modifier keys when sending special characters or {U+xxxx} (which was broken by v1.1.00.01).
Fixed ComObjConnect to filter out non-dispatch interfaces instead of allowing the script to crash.
Fixed new %VarContainingClassName%()
.
Fixed class declarations to allow directives such as #Include.
Added Client coordinate mode.
Added object output mode for RegExMatch and RegEx callouts.
Added super-global declarations, which avoid the need to repeat global declarations.
Breaking change: Class declarations such as Class c
now create a super-global variable instead of an ordinary global.
Added more detail to unhandled exception error dialogs.
Changed Gui +Owner
to work even after the GUI is created.
Changed instance var declarations in class definitions to avoid leaving empty key-value pairs in the class object.
Changed #Include to use standard error message formatting when it fails (more detail; also respects ErrorStdOut).
Changed Throw to throw an Exception object by default when its parameter is omitted.
Changed format of runtime error messages slightly to improve consistency and code size.
Modified PCRE to use UTF-16 for input on Unicode builds, for performance.
Upgraded PCRE to 8.13.
Fixed thread not exiting as intended when an assignment in an expression fails.
Fixed #MaxMem preventing assignments to variables which don't require expansion.
Fixed inability of Try/Catch to catch COM errors.
Fixed GuiControlGet incorrectly treating parameter #2 as invalid in some cases.
Fixed input vars being resolved too soon, allowing them to be invalidated by an expression later on the same line.
Fixed RegEx callouts not causing matching to abort when an exception is thrown.
Fixed DllCall setting ErrorLevel to -4 when it should be -3.
Fixed While appearing twice in ListLines for its first iteration.
Fixed Try/Catch to allow If/Loop/For/While with no enclosing block.
Fixed enumerator object not being released when Until is used to break a For-loop.
Fixed FileRemoveDir setting ErrorLevel incorrectly.
This release contains a number of potentially script-breaking changes.
Added exception handling support: try/catch/throw and Exception().
Added StdOut mode for #Warn.
Added Gui +HwndVARNAME option.
Added Gui, New [, Options, Title].
Added automatic support for keyboard accelerators such as Ctrl+O in Gui menus.
Changed handling of #Include <Lib>
when the /iLib command-line switch is present to resolve a problem with Ahk2Exe.
Changed GuiControl to retain the Progress control's current value when its style is changed.
Changed GuiControl and GuiControlGet to allow a HWND to be passed in the ControlID parameter.
Removed the 1GB limit from FileRead.
Improved error detection:
Hotkey, If, Expression
, where Expression does not match an existing #If expression, is caught at load-time when possible.Hotkey, IfSomething
, where Something is invalid, is caught at load-time.Fixed a bug affecting recursive variadic functions.
Added support for GUI names.
Added support for identifying a GUI by its HWND.
Added +Parent%ParentGui%
Gui option.
Added support for external windows as Gui owners via +Owner%HWND%
.
Added Name sub-command for GuiControlGet.
Added support for ActiveX controls via the Gui command.
Fixed: Empty hotkey control returned "vk00".
Fixed: Crashes and memory leaks related to COM events/ComObjConnect.
Fixed: GuiControlGet OutputVar, Subcmd, %OutputVar%
always failed.
Changed "Missing (/[/{" error messages to "Unexpected )/]/}" for greater clarity.
Changed ListLines to display While and Until lines which are executed each iteration.
Changed ~= to have higher precedence than =/!=/</>/<=/>= but lower than concat, and added it to the documentation.
Fixed (Debugger): numchildren attribute did not include Object.Base.
Fixed: Variable capacity was capped at 2GB on x64 builds.
Fixed: Last Found Window not set by #if WinExist(T)
.
Changed A_PriorKey to exclude key-up events.
Fixed process name/path retrieval in certain cases, including:
Added TV_SetImageList().
Characters which require non-standard shift states 16 and 32 now use a fallback method instead of producing the wrong keystrokes.
Revised handling of dead keys to solve problems which occur when multiple scripts with hotstrings are active.
Added support for instance variables in class definitions, using simple assignment syntax.
Removed var
keyword used in class definitions; use static
instead.
Added new built-in variables: A_ScriptHwnd and A_PriorKey.
Added new built-in functions: GetKeyName(), GetKeyVK(), GetKeySC() and IsByRef().
Added new sub-command: WinGet, OutputVar, ProcessPath.
Added the capability to specify a window by process name or path: ahk_exe %Name%.exe
or ahk_exe %FullPath%
.
Optimized ProcessName sub-command of WinGet.
Changed SetTimer to use A_ThisLabel if Label is omitted.
Updated ComObjConnect() to support using an object in place of a function name prefix.
Improved ComObjConnect() to allow the prefix/object to be updated without first disconnecting.
Improved parsing of continuation sections to allow expressions like (x.y)[z]()
without escaping "(".
Replaced the method used to store script text in 32-bit compiled scripts; now consistent with 64-bit.
Fixed detection of AltGr in the active window's keyboard layout (on Unicode builds).
Fixed SendInput applying a redundant LCtrl-up some time after AltGr-up.
Fixed: Modifier keys weren't auto-released when sending special chars.
Fixed: Scancode/modifier-key mapping conflicts such as sc1xx vs ^sc0xx.
Fixed: $ and #UseHook had no effect if used only on the second or subsequent instance(s) of a hotkey.
Fixed: Potential crash when returning a value from a __Delete meta-function.
Fixed: "Uninitialized variable" warnings were triggered by the debugger.
Changed: base.Method()
no longer triggers a default meta-function or a warning.
Changed: Gui +(Ex)Style
no longer hides/shows the Gui.
Changed the debugger to report type="undefined" for uninitialized variables.
Added check to avoid incorrectly sending keystrokes for characters which actually require the "hankaku" key.
Added support for integers as class variable names.
Added "Static" keyword for declaring class variables.
Implemented basic class definition syntax.
Implemented the new
keyword for creating a derived object.
Added Func() for retrieving a reference to an existing function and improved IsFunc to recognize function references.
Added support for ++
and --
with object fields, such as x.y[z]++
.
Changed __Delete to not trigger __Call.
Changed OnClipboardChange to use AddClipboardFormatListener when available (i.e. on Windows Vista and later) to improve reliability.
Auto-concat with (
is more selective, so some invalid expressions like 12(34)
will no longer work.
Fixed SetTimer Label, -0
to be treated as "run-once, very soon".
Fixed A_MyDocuments etc. to use SHGetFolderPath instead of undocumented registry keys.
Fixed non-empty ExcludeText causing windows with no text to be excluded.
Fixed misinterpretation of comma as an arg delimiter when enclosed in {}
in an expression.
Fixed For-loop to set A_Index only after the Expression arg is evaluated, so that the outer loop's value can be used.
Fixed default script location to be based on the directory containing the EXE (as documented), not the working directory.
Improved load-time validation to detect invalid attempts to jump out of a function with Goto.
Fixed the 64-bit build to not truncate HWNDs or SendMessage/PostMessage params to 32 bits.
Fixed */::
being treated as an invalid hotkey (broken since L54).
Fixed the icons.
Added {key: value}
as syntax sugar for Object("key", value)
.
Added [x, y, z]
as syntax sugar for Array(x, y, z)
, which is a new function equivalent to Object(1, x, 2, y, 3, z)
.
Added slight optimization: resolve any reference to True, False, A_PtrSize or A_IsUnicode in expressions at load-time.
Fixed hotkey parser to treat x & ^y
as an error instead of ignoring ^
.
ComObjQuery: Queries a COM object for an interface or service.
ComObjFlags: Retrieves or changes flags which control a COM wrapper object's behaviour.
ComObjCreate allows non-dispatch objects to be created if an interface identifier (IID) is given.
COM arrays support for-loops and the Clone() method.
ListVars shows the inner variant type and value of each COM wrapper object, in addition to the wrapper's address.
When a literal integer or variable containing both a numeric string and cached binary integer is assigned to a field of an object, an integer is stored instead of a string. This particularly benefits scripts calling COM methods which accept integers but not strings, or have different behaviour depending on the type of value.
NULL values are now allowed with ComObjParameter for the VT_UNKNOWN and VT_DISPATCH types.
Improved support for Common Language Runtime (.NET) objects via COM.
FileRecycle should now warn before deleting a file which is too large to recycle.
When a SafeArray created with ComObjArray is assigned to an element of another SafeArray, a separate copy is created. This prevents the script from crashing due to a second attempt at "destroying" the array. ComObjFlags allows this behaviour to be avoided.
Assigning to a COM array of VT_DISPATCH or VT_UNKNOWN crashed the script.
Break and Continue were tolerated outside of loops in some cases.
Standalone carriage-return (`r) was not correctly interpreted as end-of-line.
MouseMove miscalculated negative coordinates with the Input and Event send modes.
Selecting Edit This Script from the tray menu or using the Edit command crashed the script (broken by v1.0.95).
Error dialogs pointed at irrelevant lines of code in some cases.
All file I/O has been heavily optimized.
Added #Warn to assist with debugging; initial design by ac.
By default, if name_var contains a function name, name_var.()
calls the function. This can be overidden via the default base object, as before.
Run supports verbs with parameters, such as Run *RunAs %A_ScriptFullPath% /Param
.
If an operator which can accept either one operand (&x
) or two numeric operands (x & y
) follows a quoted literal string, auto-concat occurs and the operator is applied only to the right-hand operand. This is because quoted literal strings are always considered non-numeric and are therefore not valid input for numeric operators. For example, expressions like "x" &y
and "x" ++y
now work.
Fixed:
^!+
in specific cases.~x::
now affects x & y::
in the same way that ~x & z::
would, instead of having no effect.Fixed a memory leak which occurred when the return value of an object invocation or built-in function was not used, such as file.ReadLine()
or SubStr(x,y,z)
alone on a line.
Replaced the fix from v1.0.92.01 with a better fix, which also fixes k::MsgBox(),x:=y
and doesn't break if()
.
Changed: FileCreateDir now sets A_LastError.
Fixed: GuiControl()
or similar was sometimes misinterpreted as a command.
Added support for compound assignments with objects, such as x.y += z
.
Improved IniWrite in Unicode builds to prevent an empty line from appearing at the top of each new file.
Improved the parser to be more permissive about what can follow {
/}
/Else
, especially when combined.
Fixed: Cleanup code in COM method calls was freeing the wrong parameters.
Fixed (ANSI): DllCall set incorrect length for wstr parameters on output.
Fixed: Variadic function calls were unstable when param object was empty.
Fixed (Unicode): RegExReplace omitted all text up to StartingPosition (broken by v1.0.90.00).
Fixed: RegEx callout subpattern vars - broken by v1.0.90.00.
COM: Added protection against NULL IDispatch/IUnknown pointers.
COM: Skip QueryInterface for IDispatch if VT_DISPATCH is passed explicitly.
Minor fix for maintainability: obj.field := var
now correctly yields SYM_STRING, not SYM_OPERAND.
Fixed: Unexpected results with File.Write(Str)
after text-reading.
Fixed: UTF BOM check caused unexpected results in files without a BOM.
Fixed (ANSI): Parsing loops and File.ReadLine()
treated Chr(255)
as EOF.
Fixed (Unicode): RegExReplace errors where the UTF-8 and UTF-16 lengths differed.
Fixed: Disabling the last hook hotkey breaks Input.
Added: Simple optimization for RegExMatch/Replace.
All changes in this release are COM-related.
Added: ComObjError now returns the previous setting.
Added: ComObjType(co) and ComObjValue(co).
Added: ComObjMissing().
Added: ComObjArray() and basic SAFEARRAY support.
Added: "Take ownership" parameter for ComObjParameter().
Changed: Values passed to COM functions via ComObjParameter are no longer freed in the process of calling the function.
Changed: ComObj.x()
now falls back to PROPERTYGET if member 'x' is not found. This fixes for-loops for some objects.
Changed: Wrap unhandled variant types in an object rather than returning integer value.
Changed: Manage VT_UNKNOWN/VT_ARRAY lifetime automatically, by default.
Fixed: UrlDownloadToFile in Unicode builds on Windows < 7.
Fixed: Upper-ANSI characters were sent as Alt+0 in ANSI build.
Fixed: File.Pos was incorrect after attempting to read past EOF.
Fixed: Escape sequences in #If expressions and static initializers.
Fixed: ClipboardAll sometimes crashed the script with certain formats.
Fixed: Transform HTML calculated length incorrectly for &#NNN; entities.
Fixed: VarSetCapacity now correctly ignores #MaxMem for ByRef variables.
Fixed: FileAppend,,file.txt
set ErrorLevel=1 even on success.
Fixed: Match length was miscalculated for RegEx callouts with the P) option.
Integrated Sean's improvements to number handling in COM interop.
Optimized RegExReplace and RegExMatch in Unicode builds.
Added: ObjClone(Object)
, forgotten when Object.Clone()
was implemented.
Added: Support for RegEx Unicode properties in Unicode builds. Also upgraded PCRE to 8.10.
Added: Object.Remove(int, "")
removes Object[int]
without affecting other keys.
Changed: ComObj.xyz()
is now always treated as a method-call.
Changed: Var := 123
is now left as an expression, for consistency. This makes Var := 123
and Var := (123)
equivalent, whereas previously the former assigned only a string and the latter assigned both a string and a cached binary integer. In particular, this avoids some confusing type mismatch errors with COM objects.
Fixed: Dynamic variadic calls to functions with mandatory parameters.
Fixed: The final parameter of an assume-global variadic function had to be explicitly declared local.
Fixed: Static initializers interfering with setting of breakpoints.
Fixed: More pointer size-related errors with PCRE callouts on x64 builds.
Fixed: Input with 'M' option treated Ctrl-M (`r
) as Ctrl-J (`n
).
Fixed: Object.Remove(n)
returned 0 (not "") if Object[n]
didn't exist.
Added: File.Encoding for changing or retrieving the codepage in use by a File object.
Added: Variadic functions and function-calls and indirect mode for callbacks.
Added: Object.Clone()
Changed: ByRef parameters no longer require the caller to supply a variable.
Changed: Obj.foo := ""
now frees foo's contents as originally intended (but still doesn't remove the field).
Changed: OnMessage functions now tolerate optional and ByRef parameters.
Changed: RegisterCallback now enables execute access on callbacks in 32-bit builds (already did in 64-bit builds).
Changed: RegisterCallback now treats explicit ParamCount="" as omitted.
Fixed: For-loop was treating non-expression "0" as true for scripted enumerators.
Fixed: ComEvent (ComObjConnect) not working on the ANSI build.
Fixed: ComEvent (ComObjConnect) not correctly backing up/restoring local vars when calling a function which is already running.
Fixed: Buffer overflow in A_EndChar when there is no end char.
Fixed: Func->mNextFunc not inititialized to NULL (used only by LowLevel scripts).
Debugger: Added the capability to retrieve an object's contents (with a supported debugger client).
Debugger: Fixed a few bugs.
Fixed: #If expression should now evaluate each expression at most once per keypress in all cases.
Changed: SplashImage uses common image-loading routines; now supports PNG and similar, but results may differ from before for icon files.
Added: For x,y in z
.
Added: Loop .. Until expression
, usable with any Loop or For-loop.
Added: Named loops; continue outer_loop
, break 2
, etc.
Debugger: Encode stdout and stderr packets as UTF-8.
Debugger: Allow user to Abort, Retry or Ignore when the initial connection fails.
Debugger: Allow attaching a debugger client by sending the script a registered window message.
Debugger: Allow detaching debugger client by sending the "detach" DBGp command.
Added: static var := expression
.
Fixed Str*, WStr* and AStr* DllCall return types on x64.
Added functionality to InStr to bring it in line with StringGetPos:
Added #include <LibName>
for explicitly including a script from a function library folder.
Added functionality to IniRead and IniWrite allowing an entire section to be read or written.
Added functionality to IniRead allowing a list of section names to be retrieved.
Added support for custom verbs to Run/RunWait: Run *verb file
.
Made improvements to the way Run/RunWait extracts the action and its parameters from the Target parameter.
Changed NumGet/NumPut to allow Offset to be omitted entirely since Type is always non-numeric.
Removed the restriction that a label can't point to the end of a block.
Added support for x64 compiled scripts. Requires Ahk2Exe_L and x64 AutoHotkeySC.bin.
Fixed: Deref operator (*addr
) rejected addresses outside 32-bit range.
Fixed: #If expression
memory allocation error on x64.
Fixed: Custom hotstring end chars with code points greater than U+00FF.
Fixed: Special characters being sent out of sequence by SendInput/Play.
Fixed: */
being discarded in continuation sections (see L54).
Fixed: GroupActivate not setting ErrorLevel=1 if no Label was specified.
Fixed: Tab controls in x64 build.
Fixed: String-copy mode of StrPut when length is omitted; broken by L53.
Fixed: Data-alignment issues in x64 builds.
Changed: Set A_LastError for more File* commands to assist debugging.
Includes FileAppend, FileRead, FileReadLine, FileDelete, FileCopy, FileMove, FileGetAttrib/Time/Size/Version and FileSetAttrib/Time.
Excludes FileCopyDir, FileRecycle, FileMoveDir, FileRemoveDir, FileRecycleEmpty, FileCreateDir and FileInstall as the APIs used do not consistently set or return a Win32 error code.
Fixed: RunAs in Unicode build. [jackieku]
Fixed: RegisterCallback in x64 build. [fincs]
Fixed: Executables failing to run on Win2k and WinXP prior to SP2. Win2k requires SP4 and updates (probably KB 816542). XP not tested.
Fixed: Dialogs such as MsgBox became unresponsive when interrupted by another script thread. Message filter/workaround added in L45 had to be removed. [Bug report]
Fixed: Multi-byte characters in default ANSI codepage; this was also causing a memory leak. [Bug report]
Fixed: ComObject now allows purely numeric property/method names. [Bug report]
Enhanced usability and capabilities of FileOpen/File object.
File := FileOpen(handle,"h")
wraps an existing file handle in an object.File.Seek(n)
defaults to SEEK_END when n is negative.File.Pos
(or File.Position
) can be used in place of Tell and Seek.File.Pos
, File.Length
, File.AtEOF
and File.__Handle
can be used without empty parentheses()
.File.Length
can be set, as in File.Length:=n
.File.ReadNum()
and File.WriteNum(n)
read or write a number, where Num is a NumGet-compatible type name.File.WriteLine(s)
is equivalent to File.Write(s "`n")
, for symmetry with File.ReadLine()
.File.Read()
reads and returns the remainder of the file when used without parameters.Changed: GroupAdd's Label parameter now applies to the whole group. [Discussion]
Changed: GroupActivate sets ErrorLevel on success/failure. (Same thread as above.)
Changed: */
at the beginning of a line is ignored if there was no /*
. [Discussion]
Removed ToCodePage and FromCodePage subcommands of Transform.
Merged AutoHotkey64 - COM support and x64 compatibility.
x64 (changes since AutoHotkey64):
COM (changes since AutoHotkey64):
Implemented common syntax validation code for enumerators. Enum[]
and Enum.Next()
are now supported with or without parameters. Enum[]:=val
and similar obscure forms which worked in AutoHotkey_COM/AutoHotkey64 are not allowed.
"Ptr" type is still signed (unlike AutoHotkey64), for maximum flexibility and consistency.
Other changes:
Added: Object.HasKey(key)
.
Added: Object(obj)
increments obj's reference count and returns its address.
Added: ObjAddRef()
and ObjRelease()
.
Fixed: A_ThisHotkey now has the expected value when used with #If.
Fixed: RunAs in Unicode build (fixed by jackieku).
Changed: Default script codepage for ANSI builds is now CP0 (ANSI).
Changed: x.y[]
is now equivalent to (x.y)[]
rather than x["y"]
.
Changed: Built-in methods can now be called with or without the underscore prefix (e.g. obj.MaxIndex()
or obj._MaxIndex()
).
Added support for built-in and environment variables in double-derefs.
Improved support for multi-byte characters in certain codepages (previously only 932, 936, 949, 950 and 1361 were supported).
Fixed: StrPut failed for codepages which don't support WC_NO_BEST_FIT_CHARS, such as UTF-7.
Fixed: Double-deref as object - literal%var%.literal
.
Fixed: StrPut("", Encoding)
null-terminated an invalid address.
Fixed: ObjRemove's Key parameter is now optional, as with Object._Remove.
Fixed: Files were improperly locked while reading, unlike in older versions.
Fixed: Uppercase Hex format caused negative integers to become unsigned.
Fixed: RegExMatch was corrupting output array items when specific conditions were met. See bug report.
Changed: Use <EXENAME>.ahk instead of AutoHotkey.ini or AutoHotkey.ahk.
Changed: Default to UTF-8 for script files; override with /CPnnn.
Fixed: Unpause when the script exits so that object __Delete meta-functions can run.
Improved flexibility of Object._Insert.
Object._Insert(x)
- inserts x at _MaxIndex()="" ? 1 : _MaxIndex() + 1
.Object._Insert(i,x,y,z)
- inserts x,y,z
at i,i+1,i+2
.Improved flexibility of Object._Remove.
Object._Remove(k)
- removes and returns the value associated with k.Object._Remove()
- removes and returns the value at _MaxIndex().Added file share mode flags to FileOpen [by jackieku].
Fixed: 'P' option of RegExMatch incorrectly output 1 for subpatterns which did not match anything.
Fixed: Object._SetCapacity(key,n)
was not null-terminating in some cases.
Fixed: StatusBarGetText returned only half of the text in Unicode builds.
Added obj._NewEnum().
Added ObjMethod(obj) for each built-in obj._Method()
.
Changed: ObjSet/Get/Call can no longer be called/overridden by script.
Fixed: Potential crash caused by VK_PACKET check added in L48.
Fixed: Character codes in VK_PACKET events were potentially misinterpreted as scancodes.
Fixed: ExcludeText was ineffective after the first matching control.
Fixed: Standalone obj.()
was not recognized as a valid expression.
ControlSend now uses WM_CHAR to support characters which have no associated keycode. For instance, this applies to "
" (en-US), "∞" in a Unicode build and {U+221e}
in either build.
KeyHistory now shows the full 16-bit character code for VK_PACKET (VK=E7) events. Send may indirectly cause these to be generated for Unicode characters.
Fixed (Unicode): ControlGet,List with ListView controls.
Added A_FileEncoding, which returns the current default file encoding.
Added StrPut and extended StrGet with additional features.
Added _GetAddress; _SetCapacity/_GetCapacity may now operate on a given field. [more info]
Added workaround for WM_PAINT infinite loop often caused by subclassing.
Allow obj.()
as a means to call the default method of an object; equivalent to obj[""]()
.
Dev: Added solution and project files for MSBuild 4.0 & VS2010. [more info]
Fixed (Unicode): 'Running' column in ListHotkeys.
Fixed: Attempting to set "nothing" crashed the script. For instance, x[]:=z
.
Fixed (Unicode): Unable to find default script (Documents\AutoHotkey.ahk).
Fixed (Unicode): A_Desktop, A_ProgramFiles and several other built-in variables which read their value from the registry caused strings to be incorrectly terminated.
Fixed (ANSI): Characters in the range 0x80-0xFF couldn't be found by InStr or StringReplace.
Changed (ANSI): Treat ToCodePage/FromCodePage like other unsupported/invalid subcommands.
Fixed: obj.Func() resulting in a random integer when it should be an empty string.
Merged with AutoHotkeyU.
Numerous bug-fixes and improvements, some relating to the merge.
Fixed: Floating-point numbers were equivalent to an empty string when used as keys in objects. They are now converted to numeric strings in the current float format, as originally intended.
Changed meta-functions and multi-param behaviour to improve flexibility. Meta-functions are now invoked *before* searching for an appropriate field in each base object; however, values in x.base will override meta-functions defined in x.base.base. Chaining meta-functions (inheritence) is now possible by avoiding "Return"
Improved Default Base functionality to be more consistent with real objects.
Changed (Debugger): While stepping through code, skip all braces except those which end a function.
Changed (Debugger): When stepping onto the hidden "Exit" at end of the script, consider it to be *below* the last physical line to avoid confusion.
Fixed (Debugger): Error in Base64 decoding used by property_set.
Added: #MenuMaskKey directive to change which key is used to mask Alt/Win keyup events. See this thread for background information.
Changed: If x[1,2]:=3
creates an object for x[1]
, it's base is no longer automatically set to x.base
. See the documentation for a method of controlling this behaviour.
Added: Support for obj[method_name](params)
object-call syntax.
Changed: If x.y
or similar is immediately followed by an open-bracket ([
), the right-most identifier preceding the bracket is treated as the first parameter of the operation. For instance, a.b.c[d]
is equivalent to ObjGet(a.b,"c",d)
and x.y[z]:=v
is equivalent to ObjSet(x,"y",z,v)
. Previously each sub-expression preceding a bracket was evaluated separately.
Changed: If a method-call such as x.y()
is followed immediately by an assignment, the parentheses are treated as brackets. For instance, x.y(z):=v
is now equivalent to ObjSet(x,"y",z,v)
.
Fixed: If(expr) and While(expr) with no delimiting space or comma.
Fixed: Standalone expressions beginning with two or more "dots", such as x.y.z()
. (Broken by L34.) Note that '(' or '[' or ':=' is still required.
Changed: Setting a value within an object to an empty string now stores the empty string rather than removing the key-value pair from the object. _Remove can still be used to completely remove key-value pairs.
Changed: Command names must be terminated with a space, tab or comma. The following characters no longer bypass this requirement: <>:+-*/!~&|^[]. For instance, syntax errors such as MsgBox< foo and If!foo
are now caught at load-time.
Fixed: Return now properly handles expressions which result in a variable containing an object. For instance, Return x:=y
, Return (x)
, Return x,...
and similar should work now (Return x
already worked).
Fixed: Multi-parameter get/set did not correctly support meta-functions for multiple objects (such as for x
and x[y]
in the expression x[y,z]
).
Fixed: Cascading object-assignments such as the x[y]:=z
in r:=x[y]:=z
could not yield numbers or objects - broken by L33.
Fixed: x._Remove(y)
crashed the script or removed the wrong item if x
did not contain y
.
Fixed: x.=y
, if x.y=...
and similar. May affect other expressions.
Fixed: Standalone ternary expressions no longer requires spaces. For instance, x? F(1) : F(2)
is now allowed.
Debugger: On script exit, disconnect debugger *after* releasing objects to allow debugging of __Delete handlers.
Fixed: Local variables were not automatically freed for functions which return objects or pure numbers.
Fixed: Two separate reference-counting errors related to ternary operator and Object().
Fixed: If a string returned by a scripted object function was assigned directly to a variable, the variable's length was set incorrectly.
Fixed: If the last operation in an expression retrieved a string from a temporary object, the object and string were freed prematurely.
Fixed: Numeric strings with special formatting were not preserved when returned from a function via a variable or passed to a recursive function.
Fixed: If the final result of an expression (other than for Return) is an object, correctly yield an empty string instead of silently aborting the thread.
Fixed: __Delete meta-functions sometimes overwrote temporary values in the deref buffer.
Added: An address retrieved via &object may be cast back into an object reference by using Object(address).
Fixed: Send/PostMessage crash when less than three parameters were specified.
Added: Object/array support and numerous minor changes to make this possible.
Added: Support for While(expression) with no delimiting space.
Added: Trim, LTrim, RTrim.
Added: A ~= B; equivalent to RegExMatch(A, B). May be removed in a future revision.
Fixed: An incompatibility with LowLevel.
Changed: Characters [, ] and ? are no longer valid in variable names. Consequently, ? (ternary) no longer requires a space on either side.
Changed: Optional parameters may now be omitted at any position in the parameter list of a non-dynamic function call. Since this works by automatically inserting the parameter's default value at load-time, it is not supported or allowed for dynamic function-calls.
Debugger: Various minor changes to make program flow easier to follow while stepping through code.
Optimization: If DllCall's first parameter is a literal string which identifies a function already present in memory, it is replaced with the actual address of the function.
Updated from v1.0.48.03 to v1.0.48.04.
Updated from v1.0.48.02 to v1.0.48.03.
All supported image formats may now be used as menu icons. 当前在 Windows Vista 和更高版本中如果需要被设置的图标保留透明度时, 则必须指定 "真实的大小". 例如:
Menu, Icon, MenuItemName, Filename.png,, 0
Improved average-case performance of dynamic function calls by implementing binary search for function name look-ups. This change also applies to other areas, such as load-time resolution of function references in expressions and run-time resolution by OnMessage, RegisterCallback, etc.
Updated from v1.0.48.00 to v1.0.48.02.
Fixed: Menu icons were not drawn on items which have sub-menus if owner-drawing was in use.
Fixed: Menu icons were not freed if all menu items were deleted at once.
Changed (Source): Renamed AutoHotkey.sln to AutoHotkey_L.sln to allow VS window to be identified more easily.
Fixed: Send {U+xxxx} correctly sets modifier key-state as with any normal key.
Fixed: Send {U+..xx} no longer triggers hotkey SCxx.
Added: Support for Send {U+xxxx}. SendInput() is used where available for proper unicode support, otherwise falls back to Alt+Numpad.
Fixed: GuiControl, Enable/Disable now only resets focus if the focused control was disabled.
Optimized If var [not] in/contains MatchList, especially for long lists containing shorter fields.
Minor optimizations to While. [thanks Chris]
Fixed (Debugger): Revisions 19 and 20 omitted timer threads from the call stack.
Fixed (Debugger): XML-reserved characters were not escaped in most situations.
Fixed (Debugger): Incorrect command and transaction_id were used in the final response before exiting the script.
Changed: If an icon cannot be loaded with the new method, fall back to the old method.
Added: Gui, Font, qN option to set font quality/control anti-aliasing, where N is between 0 and 5.
Fixed: IL_Add now loads icons at the most appropriate size when multiple sizes exist.
Merged with AutoHotkey v1.0.48, introducing bug fixes, optimizations and other changes by Chris. Some AutoHotkey_L features were integrated into the mainstream release; changes to these features since previous revisions are as follows:
Fixed: Incomplete bug-fix in previous revision causing concat followed by assignment to skip the rest of the expression in some cases.
Added: Menu icons via Icon and NoIcon sub-commands of the Menu command.
Changed: Negative icon numbers can now be used to indicate a resource ID within an executable.
Changed: Set default style of menus to include MNS_CHECKORBMP.
Changed: Load both small and large versions of custom tray icons to allow the correct icons to be shown in the appropriate places.
Fixed: Loading of icons from executable files at sizes other than the system small/large.
Fixed: Deleting a menu item partially deleted its associated sub-menu.
Fixed: SetFormat's presence in a *compiled* script was not disabling binary number write-caching. SetFormat should now work correctly in compiled scripts.
Numerous bug-fixes and optimizations by Chris (pre-v1.0.48 beta).
Added: Support for regex callouts and the auto-callout option 'C'.
Changed: A_AhkVersion now includes the revision number. For instance, this is 1.0.47.07.L14.
Fixed: HWND's/window ID's were sign-extended to 64-bit. For instance, 0xb482057e became 0xffffffffb482057e.
Fixed: Invalid DllCall types were treated as INT in some build environments.
Added: Workaround for GuiEscape issue when disabling focused control.
Changed version info: InternalName, ProductName and FileDescription are now "AutoHotkey_L" instead of "AutoHotkey".
Fixed: Potential access violation when using property_get on a built-in variable. -- DBGP
Fixed: Remove checksum from AutoHotkeySC.bin via post-build script (AutoHotkey must be installed).
Added: .L suffix to A_AhkVersion.
Added: Preliminary support for DBGp (interactive debugging).
Fixed: WheelLeft/WheelRight support, which was broken in revision 9.
Fixed: Allow Break/Continue in While.
Fixed: TrayTip in non-English Windows and possibly other side-effects of using Vista headers.
Added: #IfTimeout directive to set the timeout for evaluation of #If expressions, in milliseconds. Default is 1000.
Added: Assume-static mode for functions. "Static" must precede any local/global variable declarations.
Added: One-true-brace support for While.
Changed: While now sets A_Index to the iteration about to begin.
Added: IsFunc(FuncName) - Returns a non-zero number if FuncName exists in the script or as a built-in function.
Cleaned up obsolete references to test scripts.
Added basic default test script.
Added: #if (expression) - Similar to #IfWinActive, but for arbitrary expressions.
Added: WheelLeft, WheelRight - Support for WM_MOUSEHWHEEL, which was introduced with Windows Vista. (Requires Vista.)
Added: While, expression - Loop while a condition is true.
Added: A_IsPaused - True if the underlying thread is paused.
Added: A_IsCritical - True if the current thread has been marked uninterruptible by the "Critical" command.
Changed: Allow any number of parameters to be passed in dynamic function calls.
Fixed: Access Violation caused by WinGetClass and subclassed windows.
Fixed: Access Violation caused by empty dynamic function references.