As Lexicos pointed out in the following thread:
https://autohotkey.com/boards/viewtopic.php?f=5&t=49224
I was mistaken in posting that you can remove the Hidden attribute from the C:\ProgramData folder by using the Folder Options from Windows Explorer or the Control Panel. It enables one to see that folder when using Windows Explorer but it does not change the Hidden Status.
I had spent several hours trying to update my Startup folder and was only able to do it when I discovered that freeware Startup utility. I guess I was very tired and got confused.
I want to thank Lexicos for correcting my errors.
[Archived, Locked] Suggestions on documentation improvements
Re: Suggestions on documentation improvements
This isn't valid in AHKv2: https://lexikos.github.io/v2/docs/Tutorial.htm#s5.
WORD WRAP in GUI TEXT control
I would like to see the documentation for GUI, ADD, TEXT include the following:
When automatic word-wrapping is enable in a TEXT control, any words which by necessity would need to be split (at the end of a row) are, instead, truncated.
(or, of course, some similar language)
Thank you
Joe Petree
When automatic word-wrapping is enable in a TEXT control, any words which by necessity would need to be split (at the end of a row) are, instead, truncated.
(or, of course, some similar language)
Thank you
Joe Petree
what does "=" do?
At the documentation for OPERATORS In EXPRESSIONS (part of VARIABLES AND EXPRESSIONS), =, while it is shown, IS NOT DEFINED. There the doc states:
This does not say what = does. I find this especially confusing since = can also be used for assignment.Equal (=), case-sensitive-equal (==), and not-equal (<> or !=). The operators != and <> are identical in function. The == operator behaves identically to = except when either of the inputs is not a number, in which case == is always case sensitive and = is always case insensitive (the method of insensitivity depends on StringCaseSense). By contrast, <> and != obey StringCaseSense.
What is a PARENT window?
The documentation for +PARENT (found in the GUI topic) says the following:
That is all it says. This does not tell me what a PARENT gui is or does.Parent [v1.1.03+]: Use +Parent immediately followed by the name or number of an existing Gui or the HWND of any window or control to use it as the parent of this window. To convert the Gui back into a top-level window, use -Parent. This option works even after the window is created.
Re: What is a PARENT window?
using the option implies prior awareness of the window creation hierarchy. i dont think it should be explained here, really. i dont think it even could be, without introducing bloat that is. maybe link to https://msdn.microsoft.com/en-us/librar ... S.85).aspx for those wanting to dig deeper, but a downside to that is that u never know when MS will 404 itjoefiesta wrote:The documentation for +PARENT (found in the GUI topic) says the following:That is all it says. This does not tell me what a PARENT gui is or does.Parent [v1.1.03+]: Use +Parent immediately followed by the name or number of an existing Gui or the HWND of any window or control to use it as the parent of this window. To convert the Gui back into a top-level window, use -Parent. This option works even after the window is created.
Re: Suggestions on documentation improvements
SORT
- This quote from the Sort command page has caused me a lot of confusion.
- I've collected a list of rules of useful info for custom sort functions, here (including comments on stable v. unstable sort):
Numerically AND Alphabetically sorting data - AutoHotkey Community
https://autohotkey.com/boards/viewtopic ... 83#p222183
FORMAT
- The Format function page could do with some more examples. I've collected some here:
jeeswg's characters tutorial - AutoHotkey Community
https://autohotkey.com/boards/viewtopic.php?f=7&t=26486
- One tricky thing to do is to produce a number of the form '6.6' e.g. 000123.456000 or -000123.456000.
REGEX QUICK REFERENCE
The AHK v2 version of this AHK v1 page:
Regular Expressions (RegEx) - Quick Reference
https://autohotkey.com/docs/misc/RegEx-QuickRef.htm
mentions these: LS/line separator/chr(0x2028) and PS/paragraph separator/chr(0x2029), which I believe are applicable to AHK v1 also, but not mentioned. Also, the AHK v1 page does not mention the O (object) mode.
INPUTBOX
InputBox
https://autohotkey.com/docs/commands/InputBox.htm
Default values of W375 H189 are mentioned.
On Windows 7 I get: W384 H204 (window), and W368 H166 (client).
What do the numbers refer to?
GUI (AHK V2)
This page lacks a Related Pages section at the bottom:
GuiControl Object
https://lexikos.github.io/v2/docs/objec ... ontrol.htm
E.g. this page does have a Related Pages section:
GUI Control Types
https://lexikos.github.io/v2/docs/comma ... ntrols.htm
Perhaps all pages could consistently use 'Related' or 'Related Pages'. 'Related Pages' would be better because you could skip to it directly by doing Ctrl+F, 'Related P', whereas 'Related' could appear in the document in other places.
- This quote from the Sort command page has caused me a lot of confusion.
- I might suggest something like:When the function deems the first parameter to be greater than the second, it should return a positive integer
- Also, the page does not warn about stable v. unstable sort, which again caused much confusion for me.When the function deems that the first parameter should be placed later in the final/sorted list than the second, it should return a positive integer
- I've collected a list of rules of useful info for custom sort functions, here (including comments on stable v. unstable sort):
Numerically AND Alphabetically sorting data - AutoHotkey Community
https://autohotkey.com/boards/viewtopic ... 83#p222183
FORMAT
- The Format function page could do with some more examples. I've collected some here:
jeeswg's characters tutorial - AutoHotkey Community
https://autohotkey.com/boards/viewtopic.php?f=7&t=26486
- One tricky thing to do is to produce a number of the form '6.6' e.g. 000123.456000 or -000123.456000.
REGEX QUICK REFERENCE
The AHK v2 version of this AHK v1 page:
Regular Expressions (RegEx) - Quick Reference
https://autohotkey.com/docs/misc/RegEx-QuickRef.htm
mentions these: LS/line separator/chr(0x2028) and PS/paragraph separator/chr(0x2029), which I believe are applicable to AHK v1 also, but not mentioned. Also, the AHK v1 page does not mention the O (object) mode.
INPUTBOX
InputBox
https://autohotkey.com/docs/commands/InputBox.htm
Default values of W375 H189 are mentioned.
On Windows 7 I get: W384 H204 (window), and W368 H166 (client).
What do the numbers refer to?
GUI (AHK V2)
This page lacks a Related Pages section at the bottom:
GuiControl Object
https://lexikos.github.io/v2/docs/objec ... ontrol.htm
E.g. this page does have a Related Pages section:
GUI Control Types
https://lexikos.github.io/v2/docs/comma ... ntrols.htm
Perhaps all pages could consistently use 'Related' or 'Related Pages'. 'Related Pages' would be better because you could skip to it directly by doing Ctrl+F, 'Related P', whereas 'Related' could appear in the document in other places.
homepage | tutorials | wish list | fun threads | donate
WARNING: copy your posts/messages before hitting Submit as you may lose them due to CAPTCHA
WARNING: copy your posts/messages before hitting Submit as you may lose them due to CAPTCHA
GUI shortcut keys
At the doc for GUI, ADD for controltype TEXT the use of a shortcut key (letter preceded by ampersand to indicate keyboard shortcut) in the TEXT parameter is mentioned and a pointer (link) to "shortcut key" at "Keyboard navigation" exists.
However, none of the other GUI ADD control types' documentation includes this (except GUI ADD BUTTON).
This is inconsistent. Each control type that allows a shortcut key should include the reference to a shortcut key.
One should not have to read about GUI ADD TEXT to learn about GUI ADD CHECKBOX etc. If information of a general or all-inclusive nature is to be included for individual control types, I believe it should PRECEDE all the specific information.
( the shortcut key is also valid for CHECKBOX and BUTTON. There may be others.)
However, none of the other GUI ADD control types' documentation includes this (except GUI ADD BUTTON).
This is inconsistent. Each control type that allows a shortcut key should include the reference to a shortcut key.
One should not have to read about GUI ADD TEXT to learn about GUI ADD CHECKBOX etc. If information of a general or all-inclusive nature is to be included for individual control types, I believe it should PRECEDE all the specific information.
( the shortcut key is also valid for CHECKBOX and BUTTON. There may be others.)
- hoppfrosch
- Posts: 443
- Joined: 07 Oct 2013, 04:05
- Location: Rhine-Maine-Area, Hesse, Germany
- Contact:
V2-Docu: FileCreateDir is missing
Within V2-Documentation, the command "FileCreateDir" is undocumented. The command is still referenced on page "Script Compatibility".
The command "FileCreateDir" seems to be replaced with "DirCreate" - nevertheless the command is still available in V2
The command "FileCreateDir" seems to be replaced with "DirCreate" - nevertheless the command is still available in V2
Re: Suggestions on documentation improvements
I get call to non-existent function,nevertheless the command is still available in V2
Code: Select all
filecreatedir "a"
Re: Suggestions on documentation improvements
@hoppfrosch: Which version of AHK v2 are you using? I tried FileCreateDir as a command and function in AHK v2.0-a096 and got the same error as Helgef.
homepage | tutorials | wish list | fun threads | donate
WARNING: copy your posts/messages before hitting Submit as you may lose them due to CAPTCHA
WARNING: copy your posts/messages before hitting Submit as you may lose them due to CAPTCHA
- hoppfrosch
- Posts: 443
- Joined: 07 Oct 2013, 04:05
- Location: Rhine-Maine-Area, Hesse, Germany
- Contact:
Re: Suggestions on documentation improvements
My fault - just ignore my request
SEND and special characters
The following sends an "Alt" character:
What does the following send?
The documentation for SEND does not make the answer to this question at all obvious.
Code: Select all
send, !
Code: Select all
a := "!"
send, %a%
Re: Suggestions on documentation improvements
Why should a:= "!" and Send %a% do anything else than Send ! ? a gets de-referenced like it is customary in Autohotkey. Does it have to be mentioned when it works as expected?
Although, without a following key it doesn't do anything, anyway... in any case. But this is consistent, imho.
Edited
Although, without a following key it doesn't do anything, anyway... in any case. But this is consistent, imho.
Hence, the modifier ! only makes sense, if there is something to modify. And to send a literal !, brackets, raw and text mode are available. Putting a string into a variable is obviously different.The modifiers !+^# affect only the very next key. To send the corresponding modifier key on its own, enclose the key name in braces.
Edited
Overlapping GUI controls and G-labels
Code: Select all
Specifically, it appears that when two controls with g-labels are created and they overlap (partially or fully), when clicking a location where they overlap, the G-label of the first created control is triggered.
The only way I have found to make the second created control's G-label to be triggered in this case is by HIDING the first created control (which, of course, is not really what one might want).
Here is a short macro which you can use to test this. This sample is not very practical. In reality, my first control is a PICTURE and the second control is TEXT (which only covers a small portion of the picture and is, therefore, much more logical). I haven't used a picture in the sample for lack of a universal picture file.
Pressing BUTTON 2 has no effect until after Clicking TEXT1 control area (which then HIDES TEXT1).
I also find this interesting in that one has every reason to think that the LAST control created over a certain location has the highest priority.
Code: Select all
#SingleInstance, force
Gui, 1: Add, text, x001 y000 w300 h400 vText1 gText1, This is TEXT ONE.
Gui, 1: Add, button, x101 y105 vMsgTxt gButton2 -background, button two.......
Gui, 1: Show, x0 y0 , TestGuisOverlapping
return
Text1:
msgbox text1 routine
GuiControl, 1: hide, Text1
return
Button2:
msgbox button2 routine
return
Re: Overlapping GUI controls and G-labels
Hi Joe,joefiesta wrote:Apparently, the sequence in which GUI controls are created is relevant. I can not find this documented anywhere.Code: Select all
Specifically, it appears that when two controls with g-labels are created and they overlap (partially or fully), when clicking a location where they overlap, the G-label of the first created control is triggered.
The only way I have found to make the second created control's G-label to be triggered in this case is by HIDING the first created control (which, of course, is not really what one might want).
Here is a short macro which you can use to test this. This sample is not very practical. In reality, my first control is a PICTURE and the second control is TEXT (which only covers a small portion of the picture and is, therefore, much more logical). I haven't used a picture in the sample for lack of a universal picture file.
Pressing BUTTON 2 has no effect until after Clicking TEXT1 control area (which then HIDES TEXT1).
I also find this interesting in that one has every reason to think that the LAST control created over a certain location has the highest priority.Code: Select all
#SingleInstance, force Gui, 1: Add, text, x001 y000 w300 h400 vText1 gText1, This is TEXT ONE. Gui, 1: Add, button, x101 y105 vMsgTxt gButton2 -background, button two....... Gui, 1: Show, x0 y0 , TestGuisOverlapping return Text1: msgbox text1 routine GuiControl, 1: hide, Text1 return Button2: msgbox button2 routine return
I would consider what you described a bug. You might consider posting the issue in that forum.
- iPhilip
Windows 10 Pro (64 bit) - AutoHotkey v2.0+ (Unicode 64-bit)
Re: Suggestions on documentation improvements
Why? As you said,I also find this interesting in that one has every reason to think that the LAST control created over a certain location has the highest priority.
I can not find this documented anywhere.
- CerpinTaxt
- Posts: 13
- Joined: 23 Dec 2017, 12:16
Re: Suggestions on documentation improvements
Ambiguous phrasing in Library list on Functions page
Reference: https://autohotkey.com/docs/Functions.htm#lib
The list of libraries has:
but shouldn't that third line be something like:
or even:
Also, maybe consider adding a sentence to the Objects page or the For-Loop page mentioning that a For-Loop enumerates an object alphabetically? I'm sure it's intuitive/obvious for most folks, especially those with prior programming experience, but I didn't realize that until just now and I've been learning AutoHotkey for a decent amount of time.
Reference: https://autohotkey.com/docs/Functions.htm#lib
The list of libraries has:
Code: Select all
%A_ScriptDir%\Lib\ ; Local library - requires [v1.0.90+].
%A_MyDocuments%\AutoHotkey\Lib\ ; User library.
path-to-the-currently-running-AutoHotkey.exe\Lib\ ; Standard library.
Code: Select all
directory-of-the-currently-running-AutoHotkey.exe\Lib\` ; Standard library.
Code: Select all
% StrReplace(A_AhkPath, "AutoHotkey.exe", "Lib\") ; Standard library
and with just one faint glance back into the sea
the mollusk lingers with its wandering eye
Re: Suggestions on documentation improvements
The spaces and hyphens are inconsistent here. Thanks.
FormatTime - Syntax & Usage | AutoHotkey
https://autohotkey.com/docs/commands/Fo ... _sensitive
FormatTime - Syntax & Usage | AutoHotkey
https://autohotkey.com/docs/commands/Fo ... _sensitive
homepage | tutorials | wish list | fun threads | donate
WARNING: copy your posts/messages before hitting Submit as you may lose them due to CAPTCHA
WARNING: copy your posts/messages before hitting Submit as you may lose them due to CAPTCHA
Re: Suggestions on documentation improvements
@jeeswg
I wonder why you (and most other people interested in programming) don't change such simple and obvious issues by yourself? It'll only take five minutes. No more. Just press the pen button on the page of your choice, do your changes and follow the instructions on the screen. Much knowledge of Git or HTML is not required. The only "disadvantage" is of course that you have to register first. There are many instructions on the Internet how you do this such as https://help.github.com/articles/editin ... epository/.
I wonder why you (and most other people interested in programming) don't change such simple and obvious issues by yourself? It'll only take five minutes. No more. Just press the pen button on the page of your choice, do your changes and follow the instructions on the screen. Much knowledge of Git or HTML is not required. The only "disadvantage" is of course that you have to register first. There are many instructions on the Internet how you do this such as https://help.github.com/articles/editin ... epository/.
Return to “Suggestions on Documentation Improvements”
Who is online
Users browsing this forum: No registered users and 2 guests