# Changes & New Features

Changes and new features introduced by the current branch of AutoHotkey development (a.k.a. AutoHotkey_L) are listed below.

For older changes, see Archived Changes.

## 1.1.09.02 - December 24, 2012

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.

## 1.1.09.01 - December 15, 2012

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.

## 1.1.09.00 - November 7, 2012

#### Breaking changes:

Removed .aut file compatibility and #AllowSameLineComments.

Removed undocumented AutoIt v2 commands.

#### Backward-compatible changes:

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".

#### Bug-fixes:

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.

#### Debugger:

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.

## 1.1.08.01 - August 3, 2012

Debugger: Fixed max_depth being either half the intended limit or unlimited.

## 1.1.08.00 - July 14, 2012

#### Breaking changes:

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.

#### Other changes:

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 basic support for inspecting Func, ComObject and RegExMatchObject objects.
- Fixed the "attach debugger" message being ignored in some situations. See commit 83f0a0e.

#### New features:

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.

#### Fixes:

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.

## 1.1.07.03 - March 25, 2012

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.

## 1.1.07.02 - March 22, 2012

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)`.

## 1.1.07.01 - March 2, 2012

Fixed FileRead to ignore #MaxMem when reading UTF-16 on Unicode builds.

Fixed dynamic function calls with built-in vars such as %A_ThisLabel%().

## 1.1.07.00 - February 27, 2012

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.

## 1.1.06.02 - February 13, 2012

Fixed IniRead crashing when Section is omitted but Key isn't.

Fixed accuracy of FileGetSize with files which are 4GB or larger.

## 1.1.06.01 - February 12, 2012

Fixed MsgBox smart comma handling to require numeric Options, not Title.

## 1.1.06.00 - February 12, 2012

#### New features:

Integrated #InputLevel directive and SendLevel command by Russell Davis.

Integrated support for Link controls by ChrisS85.

#### Breaking changes:

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.
- If the first arg is an expression, any unescaped comma which is not enclosed in quote marks or parentheses/brackets/braces will cause multi-arg mode to be used. These commas were formerly interpreted as multi-statement operators within the first-and-only arg (Text).
- When Title is an expression, unescaped commas contained within the expression no longer interfere with smart comma handling.
- If there are exactly two args and the first is empty or an integer, multi-arg mode is used. The former behaviour was to combine both into a single arg (Text).
- Timeout can be a literal number or a single deref (and optionally part of a number; for example, `%Timeout%.500`). Contrary to the documentation, the former behaviour interpreted most other cases beginning with `%` as expressions (containing a double-deref).
- Title can be an expression even if Text and Options are omitted.

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:

- Attempting to assign directly to A_IsCompiled or A_IsUnicode always causes a load-time error. Dynamic assignments always fail, either silently or with an error dialog as appropriate. Previously assignments were allowed in uncompiled/non-Unicode scripts.
- Attempting to take the address of A_IsCompiled or A_IsUnicode always fails.
- A_IsCompiled and A_IsUnicode no longer appear in ListVars when referenced by a script which is not compiled/Unicode.

Changed Send and related commands to respect #MenuMaskKey when changing modifier keystates.

#### Other changes:

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.

#### Fixes:

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>.

## 1.1.05.06 - December 31, 2011

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.

## 1.1.05.05 - December 17, 2011

Fixed `continue n` misbehaving when an inner loop has no braces.

Fixed RegExMatchObject[Name] to work correctly with duplicate names.

## 1.1.05.04 - December 5, 2011

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).

## 1.1.05.03 - November 30, 2011

Fixed `Loop ... Until VarContainingObject`.

## 1.1.05.02 - November 20, 2011

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%()`.

## 1.1.05.01 - October 16, 2011

Fixed class declarations to allow directives such as #Include.

## 1.1.05.00 - October 8, 2011

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.

## 1.1.04.01 - September 15, 2011

Fixed FileRemoveDir setting ErrorLevel incorrectly.

## 1.1.04.00 - September 11, 2011

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.
- Class definitions with missing braces are detected as errors.
- If a function call is used on the first line of a class definition, it is now correctly treated as an error.
- GroupAdd now shows an error message when the group name is blank, instead of silently exiting the thread.
- Removed some redundant "unset var" warnings which appeared when using the OutputDebug or StdOut warning modes.
- If an unrecognized option is used with Gui, Gui Show, Gui New or GuiControl, an error message is shown and the thread exits unless try is used. This validation is not done at load-time due to complexity (it is common for the option parameters to contain variable references).
- RegRead, RegWrite and RegDelete now set A_LastError to the result of the operating system's GetLastError() function.
- +LastFoundExist is now treated as an error if it is combined with another option (+LastFound should be used in that case).

Fixed a bug affecting recursive variadic functions.

## 1.1.03.00 - August 28, 2011

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.

## 1.1.02.03 - August 21, 2011

Fixed (Debugger): numchildren attribute did not include Object.Base.

## 1.1.02.02 - August 20, 2011

Fixed: Variable capacity was capped at 2GB on x64 builds.

Fixed: Last Found Window not set by #if WinExist(T).

## 1.1.02.01 - August 13, 2011

Changed A_PriorKey to exclude key-up events.

Fixed process name/path retrieval in certain cases, including:

- Retrieving name/path of a 64-bit process from a 32-bit script.
- Retrieving name/path of an elevated process from a non-elevated process (UAC).

## 1.1.02.00 - August 6, 2011

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.

## 1.1.01.00 - July 30, 2011

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.

## 1.1.00.01 - July 17, 2011

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.

## 1.1.00.00 - May 1, 2011

#### New features:

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]++`.

#### Changes:

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.

#### Fixes:

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.

## 1.0.97.02 - April 14, 2011

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.

## 1.0.97.01 - April 2, 2011

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.

## 1.0.97.00 - March 28, 2011

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 `^`.

## 1.0.96.00 - March 21, 2011

#### New features:

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.

#### Changes:

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.

#### Fixes:

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.

## 1.0.95.00 - March 12, 2011

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:

- Wildcard hotkeys were not respecting modifiers such as `^!+` in specific cases.
- File.Pos returned garbage for non-seeking file types; now it returns -1.
- File.AtEOF was incorrectly true in some cases.
- COM wrapper objects left A_LastError unset in some cases.
- Gui submenu icons did not work on Windows 2000/XP/Server 2003.
- SplashImage clipped the image if height > width.
- ComObjConnect did not alert when the first parameter is invalid.
- SplashImage now uses GDI+ only when the other methods fail, for compatibility.
- Tilde in `~x::` now affects `x & y::` in the same way that `~x & z::` would, instead of having no effect.
- A_PriorHotkey and A_TimeSincePriorHotkey now have the expected values when used with #If.
- RegExReplace did not advance through the string correctly after a match failure if the string contained non-ASCII characters.

## 1.0.92.02 - January 19, 2011

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()`.

## 1.0.92.01 - January 18, 2011

Changed: FileCreateDir now sets A_LastError.

Fixed: `GuiControl()` or similar was sometimes misinterpreted as a command.

## 1.0.92.00 - January 13, 2011

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.

## 1.0.91.05 - January 1, 2011

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.

## 1.0.91.04 - December 29, 2010

Fixed (Unicode): RegExReplace omitted all text up to StartingPosition (broken by v1.0.90.00).

## 1.0.91.03 - December 27, 2010

Fixed: RegEx callout subpattern vars - broken by v1.0.90.00.

## 1.0.91.02 - December 26, 2010

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.

## 1.0.91.01 - December 24, 2010

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.

## 1.0.91.00 - December 21, 2010

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.

## 1.0.90.00 - November 27, 2010

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.

## Revision 61 - October 3, 2010

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.

## Revision 60 - September 24, 2010

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.

## Revision 59 - September 12, 2010

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.

## Revision 58 - September 5, 2010

Added: `static var := expression`

## Revision 57 - September 4, 2010

Fixed Str*, WStr* and AStr* DllCall return types on x64.

Added functionality to InStr to bring it in line with StringGetPos:

- If StartingPos is negative, the search is conducted right-to-left beginning at that offset from the end.
- An additional parameter is available to specify which occurrence of the string to find.

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.

## Revision 56 - August 29, 2010

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).

## Revision 55 - August 19, 2010

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.

## Revision 54 - August 15, 2010

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.

- FileOpen's Flags parameter accepts a human-readable string of flags.
- FileOpen's "update" mode has been renamed "read/write" and now creates the file if it didn't already exist.
- FileOpen sets A_LastError as appropriate.
- `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.
- File object now returns "" for unrecognized methods and invalid syntax rather than the numeric address of "".

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.

## Revision 53 - August 8, 2010

Merged AutoHotkey64 - COM support and x64 compatibility.

x64 (changes since AutoHotkey64):

- Fixed floating-point return values and exception handling for DllCall.
- Fixed RegEx callouts.
- Re-enabled GetProcAddress optimisation for DllCall.
- NumPut and NumGet default to "Int64" in x64 builds.

COM (changes since AutoHotkey64):

- Allow ComObjParameter to wrap 64-bit values in 32-bit builds.
- Implemented more standard ref counting conventions in ComObjActive.
- Prevent extraneous AddRef for new ComObjects in certain cases.
- Don't treat pdispVal==NULL return value from Invoke as an error.
- Fail more predictably when given wrong type of object.
- Require explicit second param in ComObjType, don't assume "IID".
- Free local vars after ComEvent calls a function.
- Remove pVarResult param from ComEvent; use return value instead.
- Pass the original wrapper ComObject in each ComEvent call.
- Add context to ComError dialog; let the buttons make more sense.

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()`).

## Revision 52 (again) - July 10, 2010

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.

## Revision 52 - June 12, 2010

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.

## Revision 51 - April 11, 2010

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.

## Revision 50 - March 27, 2010

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.

## Revision 49 - March 14, 2010

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.

## Revision 48 - February 21, 2010

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.

## Revision 47 - February 13, 2010

Fixed (Unicode): ControlGet,List with ListView controls.

## Revision 46 - February 11, 2010

Added A_FileEncoding, which returns the current default file encoding.

Added StrPut and extended StrGet with additional features.

## Revision 45 - February 8, 2010

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.

## Revision 44 - February 7, 2010

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.

## Revision 43 - January 29, 2010

Fixed: obj.Func() resulting in a random integer when it should be an empty string.

## Revision 42 - January 28, 2010

Merged with AutoHotkeyU.

Numerous bug-fixes and improvements, some relating to the merge.

## Revision 41 - December 20, 2009

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.

## Revision 40 - December 13, 2009

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.

## Revision 39 - December 2, 2009

Fixed (Debugger): Error in Base64 decoding used by property_set.

## Revision 38 - November 17, 2009

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.

## Revision 37 - November 7, 2009

Added: Support for `obj[method_name](params)` object-call syntax.

## Revision 36 - November 4, 2009

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.

## Revision 35 - October 25, 2009

Fixed: Standalone expressions beginning with two or more "dots", such as `x.y.z()`. (Broken by L34.) Note that '(' or '[' or ':=' is still required.

## Revision 34 - October 24, 2009

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.

## Revision 33 - October 3, 2009

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).

## Revision 32 - September 26, 2009

Fixed: Send/PostMessage crash when less than three parameters were specified.

## Revision 31 - September 26, 2009

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.

## Revision 30 - May 31, 2009

Updated from v1.0.48.02 to v1.0.48.03.

## Revision 29 - May 2, 2009

All supported image formats may now be used as menu icons. Currently it is necessary to specify "actual size" when setting the icon to preserve transparency on Windows Vista and later. For example:

    Menu, Icon, MenuItemName, Filename.png,, 0

## Revision 28 - May 2, 2009

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.

## Revision 27 - April 26, 2009

Updated from v1.0.48.00 to v1.0.48.02.

## Revision 26 - April 11, 2009

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.

## Revision 25 - March 30, 2009

Fixed: Send {U+xxxx} correctly sets modifier key-state as with any normal key.

Fixed: Send {U+..xx} no longer triggers hotkey SCxx.

## Revision 24 - March 30, 2009

Added: Support for Send {U+xxxx}. SendInput() is used where available for proper unicode support, otherwise falls back to Alt+Numpad.

## Revision 23 - March 30, 2009

Fixed: GuiControl, Enable/Disable now only resets focus if the focused control was disabled.

## Revision 22 - March 26, 2009

Optimized If var [not] in/contains MatchList, especially for long lists containing shorter fields.

## Revision 21 - March 16, 2009

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.

## Revision 20 - February 27, 2009

Changed: If an icon cannot be loaded with the new method, fall back to the old method.

## Revision 19 - February 26, 2009

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:

- Legacy behaviour is no longer applied to While - e.g. "While %x%" is correctly interpreted as a double-deref rather than as "While x".
- One-True-Brace style is now supported for While.
- Static vars may now be declared and initialized in assume-static functions.
- Passing too few parameters in a dynamic function call is no longer allowed, as it allows the function's caller to second-guess the function's designer, reduces the ability to detect script bugs at runtime, and may cause the application to crash if calling a built-in function.

## Revision 18 - February 21, 2009

Fixed: Incomplete bug-fix in previous revision causing concat followed by assignment to skip the rest of the expression in some cases.

## Revision 17 - February 20, 2009

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.

## Revision 16 - February 4, 2009

Fixed: Deleting a menu item partially deleted its associated sub-menu.

## Revision 15 - February 1, 2009

Fixed: SetFormat's presence in a *compiled* script was not disabling binary number write-caching. SetFormat should now work correctly in compiled scripts.

## Revision 14 - February 1, 2009

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.

## Revision 13 - November 29, 2008

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".

## Revision 12 - September 6, 2008

Fixed: Potential access violation when using property_get on a built-in variable. -- DBGP

## Revision 11 - September 5, 2008

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).

## Revision 10 - August 2, 2008

Fixed: WheelLeft/WheelRight support, which was broken in revision 9.

## Revision 9 - July 29, 2008

Fixed: Allow Break/Continue in While.

Fixed: TrayTip in non-English Windows and possibly other side-effects of using Vista headers.

## Revision 8 - July 27, 2008

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.

## Revision 7 - July 26, 2008

Added: IsFunc(FuncName) - Returns a non-zero number if FuncName exists in the script or as a built-in function.

## Revision 5 - July 19, 2008

Cleaned up obsolete references to test scripts.

Added basic default test script.

## Revision 4 - July 18, 2008

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.