AutoHotkey Community

• Keep A_Tab / A_Space
• Keep A_IsUnicode, no need for A_ChrSize or A_StrEncoding.
• Sub Commands for DriveGet, Drive should be created, or even better to rewrite in AutoHotkey for stdlib
• Control... and Gui, should keep their sub commands.

Standard Library:

• For next release of AutoHotkey_H v2 I have already converted following functions that can be used where we agree, I plan to convert even more:
  • DirCreate.ahk
  • Download.ahk
  • FileCreateShortcut.ahk
  • FileGetShortcut.ahk
  • FileGetVersion.ahk
  • FileRecycle.ahk
  • FileRecycleEmpty.ahk
  • ImageSearch.ahk
  • MenuSelect.ahk
  • PixelGetColor.ahk
  • PixelSearch.ahk
  • ProcessClose.ahk
  • ProcessExist.ahk
  • ProcessSetPriority.ahk
  • ProcessWait.ahk
  • ProcessWaitClose.ahk
  • SplitPath.ahk
  • ToolTip.ahk
  • TrayTip.ahk
• Rename MouseClickDrag to MouseDrag.
• Remove Click and don't use flexible parameter ordering, keep MouseClick for consistent syntax.

Error Handling:

• Exception vs. ErrorLevel
• I suggest adding a directive or command to change the setting as user likes, default should be ErrorLevel.
• The directive and command can have a list of functions/commands the user wants to change, also supporting * wildcard

Code: Select all

#UseException ; enables to use exception where appropriate for all build in functions/commands
#UseException * ;same as above
#UseException, DllCall File* Control* Gui*
UseExcepiton("Gui* Control* File*",1) ; Set to use Exception
ExceptionIsOn := UseException("Gui* Control* File*") ; returns 1 which means all given commands use exception
ExceptionIsOn := UseException("Drive") ; returns 0 so Drive uses ErrorLevel
ExceptionIsOn := UseException("Drive Gui*") ; returns -1 to indicate mixture

• ErrorLevel should be always set or returned, even if id does not make sense, even for successful DllCall, just for consistency.
• Errors directly relating to expression evaluation, such as invalid dynamic function calls or stack underflow (typically caused by undetected syntax errors) should throw exception.

Math:

• Use exception for error in math operation where appropriate.
• Treat "" as 0, but optionally display a warning (enabled by #Warn).
• Math functions such as Round() should have the same behaviour as math operators.

Based on the fact that "" stands for nothing and from my understanding human brains says (nothing + 1) = 1 and not (nothing + 1) = nothing.
Another reason is the way Autohotkey implements the variable, it is treated like a placeholder for numbers, strings, memory, object.... Imagine variable is a container, then: [container with 5 kg of something] + [empty container] = 5 kg of something ; or does your brain think different?

Objects:

• Throw an exception when a memory allocation failure occurs
• Throw an exception when a method call fails if it was because the method doesn't exist or there were too few parameters.
• No need for in/contains/is, use Type() and other workarounds like InStr( ",list,of,items," , "," item "," ) or {list:1,of:1,items:1}.HasKey(item)
• Obj.HasValue() would be great to have, then even ["list","of","items"].HasValue(item) can be used

Classes:

• Make base a reserved word in class methods.
• leave "".base as it is.
• Allow the script to define global methods, skip that for the moment.

WinGroup:

• Remove ExcludeTitle and ExcludeText from all commands, and add a new command or parameter for adding negative rules to a window group

COM:

• Remove the "polymorphic" behaviour of the ComObj() function

Wishes from my side, simple to take over from AutoHotkey_H (lexikos, if you like I can do a poll request on github):

• Implement Struct() and sizeof()
• Implement OnMessage for specific hwnd, e.g. OnMessage(0x0,0x123ahk,"Function")
• Allow Function object in OnMessage, e.g. OnMessage(0x0,func) ; where func is a function object.
• ahk_parent %hwnd% for all Win... commands. Useful when you have 2 MsgBox from separate AutoHotkey scripts
• Sleep {} in Send command, e.g. Send a{100}b
• A_CoordMode... variables to get current CoordMode, required for example for ToolTip.ahk if it goes to standard library