Report Help File Issues Here

[guinness]

Maybe?! But ideally comments should be added as well as passing Au3Check.

Edited June 23, 2013 by guinness

[BrewManNH]

In regards to >this thread, I did some research as to why the OP was having the issue and discovered that the help file was lacking some information in regards to certain static control constants. Specifically these.

• $SS_BLACKFRAME
• $SS_WHITEFRAME
• $SS_GRAYFRAME
• $SS_BLACKRECT
• $SS_WHITERECT
• $SS_GRAYRECT

If you use any of these constants in a static control (labels, pic, or Icon controls), then you won't get anything inside the control to show up.

The xxFRAME constants will cause a blank frame to be displayed with no text or other information inside the control

Frame Styles
Static controls can be used to draw frames (boxes that are not filled). Frame-style static controls do not display text.

The xxRECT constants will cause a blank rectangle to display with the inside filled with the specified color.

Rectangle Styles
Static controls can be used to draw rectangles (boxes that are filled). Rectangle-style static controls do not display text.

More information can be found here. I believe this information could be added to the help file to clarify what might happen if you use these constants, as the information in there currently only tells you that it draws a frame or a rectangle, with out mentioning the limitations.

[Melba23]

Hi,

Seconded - it has caught me out more than once.

M23

[BrewManNH]

BTW, you can add the 3 ETCHED styles to the list. $SS_ETCHEDFRAME, $SS_ETCHEDHORZ and $SS_ETCHEDVERT will also cause this "issue".

EDIT: It should also be noted that the help file descriptions for $SS_ETCHEDHORZ and $SS_ETCHEDVERT are wrong, at least on my computer running Win7 x64. The descriptions say that $SS_ETCHEDHORZ "Draws the top and bottom edges of the static control using the EDGE_ETCHED edge style." and $SS_ETCHEDVERT says "Draws the left and right edges of the static control using the EDGE_ETCHED edge style." In fact the HORZ constant causes the control to be 2 pixels high and shows a single horizontal line where the top of the control would be. The VERT constant creates a control 2 pixels wide at the left edge of where the control would be. Combining the 2 together using BitOr causes the SS_ETCHEDHORZ to be ignored and only creates the VERT style control.

Edited June 24, 2013 by BrewManNH

[jdelaney]

Enhancement request: A new constant can be added, as well as a help file update for:

_WinAPI_GetWindow($parentHWND, 6)

http://msdn.microsoft.com/en-us/library/windows/desktop/ms633515(v=vs.85).aspx

 

GW_ENABLEDPOPUP 6

The retrieved handle identifies the enabled popup window owned by the specified window (the search uses the first such window found using GW_HWNDNEXT); otherwise, if there are no enabled popup windows, the retrieved handle is that of the specified window.

Edited June 24, 2013 by jdelaney

[guinness]

jdelaney,

Requests of that nature should be made to Trac, this isn't a help file issue.

Edited June 24, 2013 by guinness

[AZJIO]

There are lines which I can't understand. Maybe they are in English is not clear enough 

GUICtrlCreateCombo

On other Windows versions you can define this size with the "height" parameter if the default value is not BIG enough to contain at least one line

I know that using the style $CBS_NOINTEGRALHEIGHT can specify the height

GUICreate

extended styles are duplicated.

Add

Extended styles have the prefix $WS_<b>EX_</b> must be specified in the <i>exStyle</i> and styles without this prefix are placed in the <i>style</i>. It isn't necessary to confuse them as they will have properties not corresponding to their appointment.

 

AutoIt -> Using AutoIt -> Controls

Although the special format is more longwinded than these methods it is much less ambiguous.

??? Each method can be very exact or very ambiguous

This method of accessing controls is generally only designed for users who are familiar with working with handles.

 

??? If the beginner would not enjoy, he never learns.

Edited June 24, 2013 by AZJIO

[Mat]

From this question here: http://stackoverflow.com/questions/17307702/dircopy-not-working?noredirect=1

For DirCopy it says the following:

 

If the destination directory structure doesn't exist, it will be created (if possible).

 

But if the overwrite flag is not set, and the directory already exists, then the function fails.

[JonBMN]

Fixed. I have a really small font for viewing the Forum (8pt) so this is why I couldn't see it.

Just checked it today, and you have not fixed it.

Remember: the grammatical error is the key DESCRIPTION.

http://www.autoitscript.com/autoit3/docs/functions/IniRead.htm

[Jos]

Just checked it today, and you have not fixed it.

Remember: the grammatical error is the key DESCRIPTION.

http://www.autoitscript.com/autoit3/docs/functions/IniRead.htm

 

It is updated in the SVN source repository as indicated by guinness.

Jos

[AZJIO]

StatusbarGetText
StatusbarGetText cannot read. For example, StatusbarText
StatusbarGetText <> StatusbarText

WinSetTrans
Sets the transparency of a window. (Windows 2000/XP or later)
the text in heading

String formatting

WinList ( ["title" [, "text"]] )   - old
WinList ( [ "title" [, "text" ]] )  - new

expandcollapse popup

#include <FileOperations.au3>

$sPath = @ScriptDir & '\txtFunctions'

$aFileList = _FO_FileSearch($sPath, '*.txt*', True, 123, 2)

$sOut1 = ''
$sOut2 = ''
$sOut3 = ''
$err = 0
$iCount = 0
For $i = 1 To $aFileList[0]
    $sText = FileRead($sPath & '\' & $aFileList[$i])
    $tmp = StringRegExp($sText, '(?s)(.+?###Syntax###.+?)([^\r\n]+)([\r\n]+###Parameters###.+)', 3)
    If Not @error Then
        $tmp0 = $tmp[1]
        $tmp[1] = StringRegExpReplace($tmp[1], '\h*([][()])\h*', '\1')
        $tmp[1] = StringRegExpReplace($tmp[1], '([\w''"])\[,\h*', '\1 [, ')
        $tmp[1] = StringRegExpReplace($tmp[1], '\(', ' ( ')
        $tmp[1] = StringRegExpReplace($tmp[1], '(?<![ ])\)', ' )')
        $tmp[1] = StringRegExpReplace($tmp[1], '(\]+ \))', ' \1')
        $tmp[1] = StringRegExpReplace($tmp[1], '\[(?!,)', '[ ')
        If $tmp0 <> $tmp[1] Then
            $sOut1 &= $tmp0 & @CRLF
            $sOut2 &= $tmp[1] & @CRLF
            $sOut3 &= $tmp0 & @CRLF & $tmp[1] & @CRLF
            $iCount += 1

            $hFile = FileOpen($sPath & '\' & $aFileList[$i], 2)
            FileWrite($hFile, $tmp[0] & $tmp[1] & $tmp[2])
            FileClose($hFile)
        EndIf
    EndIf
Next

$hFile = FileOpen(@ScriptDir & '\sOut1.txt', 2)
FileWrite($hFile, $sOut1)
FileClose($hFile)
$hFile = FileOpen(@ScriptDir & '\sOut2.txt', 2)
FileWrite($hFile, $sOut2)
FileClose($hFile)
$hFile = FileOpen(@ScriptDir & '\sOut3.txt', 2)
FileWrite($hFile, $sOut3)
FileClose($hFile)
MsgBox(0, 'Готово', 'Замен = ' & $iCount, 1)

IniRead, Ini...

< i>[sectionName]
Key=Value< /i>

< p class="codeheader" style="width: 30;padding:6px;white-space: nowrap">[sectionName]
Key=Value< /p>

 

Column easier to read than the string

Asc

Asc("0") == 48, Asc("9") == 57, Asc("A") == 65, Asc("Z") == 90, Asc("a") == 97, Asc("z") == 122, etc.

Asc("0") == 48

Asc("9") == 57

Asc("A") == 65

Asc("Z") == 90

Asc("a") == 97

Asc("z") == 122, etc.

Chr

Chr(48) == "0", Chr(57) == "9", Chr(65) == "A", Chr(90) == "Z", Chr(97) == "a", Chr(122) = "z", etc

Chr(48) == "0"

Chr(57) == "9"

Chr(65) == "A"

Chr(90) == "Z"

Chr(97) == "a"

Chr(122) = "z", etc

   ... added ...

GUICtrlRead
Tab | The number or the controlID of the tabitem selected depending of the advanced parameter value.
Tab | The number of the selected tabitem (0-based)

Type |Value

Type |Return (advanced=0)

Type |Return (advanced=1)

Why is the table in "Remarks"?

Lack of one item "ListViewItem" (advanced=0)

ListViewItem |The text of the selected item / lines in the ListView

GUICtrlSendMsg, GUICtrlRecvMsg

GUICtrlUpdate...() - isn't the link, as on other pages

 

GUICtrlSetBkColor
Progress controls cannot be painted if the "Windows XP style" is used.

Checkbox, Radio, Group Progress, Combo controls cannot be painted if the "Windows XP/Vista style" is used.

GUICtrlSetColor
Checkbox, Radio, Group or Progress controls cannot be painted if the "Windows XP/Vista style" is used.

Lack Combo

expandcollapse popup

#include <GUIConstantsEx.au3>

Example()

Func Example()
    Local $msg, $ProgressBar, $iChBox

    GUICreate("Color controls")

    GUICtrlCreateLabel("Red text", 10, 20)
    GUICtrlSetBkColor(-1, 0xCCFFCC)
    GUICtrlSetColor(-1, 0xff0000)

    GUICtrlCreateGroup("Green Group", 10, 60, 180, 70)
    DllCall("UxTheme.dll", "int", "SetWindowTheme", "hwnd", GUICtrlGetHandle(-1), "wstr", 0, "wstr", 0)
    GUICtrlSetColor(-1, 0x008800)

    GUISetFont(12, 400, 0, "Comic Sans MS") ; "Times New Roman"
    $iChBox = GUICtrlCreateCheckbox("Blue checkbox", 20, 90, -1, 20)
    DllCall("UxTheme.dll", "int", "SetWindowTheme", "hwnd", GUICtrlGetHandle($iChBox), "wstr", 0, "wstr", 0)
    GUICtrlSetColor(-1, 0x0000FF)
    GUICtrlSetBkColor(-1, 0xCCFFCC)

    $ProgressBar = GUICtrlCreateProgress(10, 140, 200, 20)
    DllCall("UxTheme.dll", "int", "SetWindowTheme", "hwnd", GUICtrlGetHandle($ProgressBar), "wstr", 0, "wstr", 0)
    GUICtrlSetColor(-1, 0x0080FF)
    GUICtrlSetBkColor(-1, 0xFDFFAE) 
    GUICtrlSetData(-1, 50)

    GUISetState()

    While 1
        $msg = GUIGetMsg()

        If $msg = $GUI_EVENT_CLOSE Then ExitLoop
    WEnd
EndFunc

-

_WinAPI_SystemParametersInfo

This function always call the Unicode version so $vParam must be inaccordance when using strings.

Edited July 4, 2013 by AZJIO

[AZJIO]

FileSetPos

#include <Constants.au3>

Local $sFile, $hFile, $iPos

$sFile = @ScriptDir & "test.txt"
$hFile = FileOpen($sFile, 2)

; Check if file opened for writing OK
If $hFile = -1 Then
    MsgBox(4096, "Error", "Unable to open file.")
    Exit
EndIf

; Write something to the file.
FileWrite($hFile, "The test line, which to record for the position")

; Sets the position of the 33 bytes/character from the beginning
FileSetPos($hFile, 30, $FILE_BEGIN)

FileWrite($hFile, "ED ON") ; Data recording from a position

; Sets the position of the 9 bytes/character from the beginning
FileSetPos($hFile, 9, $FILE_BEGIN)

$iPos = FileGetPos($hFile) ; Retrieves the current file position

MsgBox(0, "Reading a file from the current position " & $iPos, FileRead($hFile))

; Close the handle.
FileClose($hFile)

; Clean up the temporary file.
FileDelete($sFile)

FileGetPos

#include <Constants.au3>

Local $sFile, $hFile, $iPos

$sFile = @ScriptDir & "test.txt"
$hFile = FileOpen($sFile, 2)

; Check if file opened for writing OK
If $hFile = -1 Then
    MsgBox(4096, "Error", "Unable to open file.")
    Exit
EndIf

; Write something to the file. When writing to the file, position is set in the end
FileWrite($hFile, "Line1" & @CRLF & "Line2" & @CRLF & "Line3")

; Sets the position at the end of the file, and shift 4-byte/symbol to the left towards the beginning of the file.
FileSetPos($hFile, -4, $FILE_END)

$iPos = FileGetPos($hFile) ; Retrieves the current file position

MsgBox(0, "Reading a file from the current position " & $iPos, FileRead($hFile))

; Sets the position of the 33 bytes/character from the beginning
FileSetPos($hFile, 4, $FILE_BEGIN)

$iPos = FileGetPos($hFile) ; Retrieves the current file position

MsgBox(0, "Reading a file from the current position " & $iPos, FileRead($hFile))

; Close the handle.
FileClose($hFile)

; Clean up the temporary file.
FileDelete($sFile)

FileFlush
The example in the help file gives out the same text

Local $sFile, $hFile, $Before, $After

$sFile = @ScriptDir & "test.txt"
$hFile = FileOpen($sFile, 1)

; Check if file opened for writing OK
If $hFile = -1 Then
    MsgBox(4096, "Error", "Unable to open file.")
    Exit
EndIf

; Write something to the file.
FileWrite($hFile, "Line1")

$Before = FileGetSize($sFile)
FileFlush($hFile) ; Flush the file to disk.
$After = FileGetSize($sFile)

MsgBox(0, 'Message', _
        'File size before and after using FileFlush' & @LF & _
        @TAB & $Before & ' KB (before)' & @LF & _
        @TAB & $After & ' KB (after)')

; Close the handle.
FileClose($hFile)

; Clean up the temporary file.
FileDelete($sFile)

http://www.cplusplus.com/reference/cstdio/fopen/

For files open for update (those which include a "+" sign), on which both input and output operations are allowed, the stream should be flushed (fflush) or repositioned (fseek, fsetpos, rewind) between either a writing operation followed by a reading operation or a reading operation which did not reach the end-of-file followed by a writing operation.

[guinness]

AZJIO,

Those functions were updated by me ages ago, plus any examples you post for the help file should pass...

#AutoIt3Wrapper_Au3Check_Parameters=-d -w 1 -w 2 -w 3 -w- 4 -w 5 -w 6 -w- 7

especially if you're updating the Russian help file.

[AZJIO]

guinness
 

Those functions were updated by me ages ago

 

When I run the example he shows no change. Twice Notepad starts with the same string.

Local Const $sFile = "test.txt"
Local $hFile = FileOpen($sFile, 1)

; Check if file opened for writing OK
If $hFile = -1 Then
    MsgBox(4096, "Error", "Unable to open file.")
    Exit
EndIf

; Write something to the file.
FileWriteLine($hFile, "Line1")

; Run notepad to show that the file is empty because it hasn't been flushed yet.
RunWait("notepad.exe " & $sFile)

; Flush the file to disk.
FileFlush($hFile)

; Run notepad again to show that the contents of the file are now flushed to disk.
RunWait("notepad.exe " & $sFile)

; Close the handle.
FileClose($hFile)

; Clean up the temporary file.
FileDelete($sFile)

.

plus any examples you post for the help file should pass...

This time you have not checked out before making the claim.

Edited July 8, 2013 by AZJIO

[Mat]

I see 4096 in there 

[guinness]

This time you have not checked out before making the claim.

You're right, sorry this time. Though you should declare when the variable is used.

[AZJIO]

90% of errors, from written by me, aren't fixed

[James]

90% of errors, from written by me, aren't fixed

It's nothing personal AZIJO.

[Mat]

90% of errors, from written by me, aren't fixed

In the latest beta? I'm surprised, Guinness has done most of them I'd thought.

[AZJIO]

In the latest beta? I'm surprised, Guinness has done most of them I'd thought.

Yes

Some critical.

 

_GUICtrlToolbar_SetButtonInfoEx

$tButton | $tagBUTTONINFO structure

$tagTBBUTTONINFO

 

 

_GUICtrlMonthCal_GetMinReqRectArray

Success: True, Handle is set to 0

Failure: False