Report Help File Issues Here

[czardas]

SRE - problem with description.

With SRE, the description for x is not entirely accurate. It is not reliable with extended ascii values - and this should be mentioned. Perhaps it is correct for some antiquated code page, or maybe it maps on to something else - I don't know. See below.

Edited March 30, 2013 by czardas

[AZJIO]

czardas

Range of Russian characters (192-255, charset=Windows-1251) defined Unicode, because judging by the sequence capture is not consistency in ascii. That is when you use [a-z] also uses Unicode

Edited March 30, 2013 by AZJIO

[czardas]

Indeed. The help file description does not say x is unicode. This needs to be clarified. You agree the results x80-FF are not necessarily AscII - as defined by your code page. The help file description is therefore not accurate. (Ignore this) It is in fact unicode:

Local $sTest = ""
For $i = 0 To 255
    $sTest &= ChrW($i) ; Unicode Characters
Next
MsgBox(0, "Before StringRegExpReplace", StringLen($sTest))

$sTest = StringRegExpReplace($sTest, "[\x00-\xFF]", "")
MsgBox(0, "After StringRegExpReplace", StringLen($sTest))

Edited March 30, 2013 by czardas

[jchd]

See my answer in this post.

In short, since the engine is dealing with UTF-8 strings, only x00 to x7F works as expected.

PCRE support inside AutoIt has to be completely reconsidered:

• PCRE now supports UTF-16 directly, making the implementation much much easier
• PCRE should definitely be compiled with UCP support (Unicode character properties)
• PCRE now enjoys optional JIT support (matching can be up to 6 times faster)
• PCRE callbacks need to be implemented
• One should be able to store compiled patterns and not have them recompiled every time when they are used in loops

[AZJIO]

FileOpen

in this case count is in bytes rather than characters. A count value that is too large can lead to AutoIt stopping with a memory allocation failure.

FileRead ( "filehandle/filename" [, count] )

FileOpen ( "filename" [, mode] ) - where the count of

_GDIPlus_BrushSetSolidColor

_GDIPlus_BrushSetSolidColor($hBrush, [$iARGB = 0xFF000000])

_GDIPlus_BrushSetSolidColor($hBrush [, $iARGB = 0xFF000000])

_RunDOS

_RunDos

_SQLite_Display2DResult($aResult [, $iCellWidth = 0 [, $bReturn = 0]])

_GDIPlus_StringFormatSetAlign

Declaring a variable in a loop. Is this normal?

Do
    Local $msg = GUIGetMsg()
Until $msg = $GUI_EVENT_CLOSE

_StringRepeat

MsgBox(4096, '', _StringRepeat("+-", 40))
Exit

Exit

_WinAPI_FlashWindowEx

#endregion

_GUICtrlListView_DeleteItem, _GUICtrlListView_DeleteItemsSelected

; 3 column load
    For $iI = 0 To 9
        GUICtrlCreateListViewItem("Item " & $iI & "|Item " & $iI & "-1|Item " & $iI & "-2", $hListView)
    Next

    MsgBox(4160, "Information", "Delete Item")
    ; Items created using UDF function(s), pass the handle to the control
    MsgBox(4160, "Deleted?", _GUICtrlListView_DeleteItem(GUICtrlGetHandle($hListView), 1))

Items created using UDF

_GUICtrlListView_EditLabel, _GUICtrlListView_GetEditControl

1188

_GUICtrlListView_Create + $WS_EX_CLIENTEDGE

_GUICtrlListView_GetEditControl

; Edit item 0 label with time out
    GUIRegisterMsg($WM_NOTIFY, "WM_NOTIFY")

???

It's

Return True
                    EndIf
                    ; If Text is empty the return value is ignored
                Case $NM_CLICK

Replace with this

Return True ; If Text is empty the return value is ignored
                    EndIf
                Case $NM_CLICK

_GUICtrlStatusBar_Resize

$WS_SIZEBOX -> WS_OVERLAPPEDWINDOW

Edited April 2, 2013 by AZJIO

[ChristophX086]

The example for the function Dec() is wrong.

Local $bDec = Dec("FFF")
MsgBox(4096, "", $bDec) ; Displays the number 65535.

(FFF)₁₆ = (4095)₁₀

(FFFF)₁₆ = (65535)₁₀

Also, doesn't the prefix b mean the variable contains binary data? If it does, it should be changed to $iDec.

[AZJIO]

I converted the Russian help-file from 3.3.6.1 on 3.3.8.1 and made some useful scripts.

#include <File.au3>

; $sPath = @ScriptDir & '\examples'
$sPath = @ScriptDir & '\libExamples'
$sPathTidy = 'C:\Program Files\AutoIt3\SciTE\Tidy\Tidy.exe'
If Not (FileExists($sPath) And FileExists($sPathTidy)) Then Exit
$aFileList = _FileListToArray($sPath, '*.au3', 1)
If @error Then Exit

$sOut = ''
$iCount = 0
For $i = 1 To $aFileList[0]
    $sText = FileRead($sPath & '\' & $aFileList[$i])
    RunWait('"' & $sPathTidy & '" "' & $sPath & '\' & $aFileList[$i] & '"', '', @SW_HIDE)
    If Not (FileRead($sPath & '\' & $aFileList[$i]) == $sText) Then
        $iCount += 1
        $sOut &= $aFileList[$i] & @CRLF
    EndIf
Next

; Write the output file
$hFile = FileOpen(@ScriptDir & '\Tidy_Out.txt', 2)
FileWrite($hFile, $iCount & @CRLF & $sOut)
FileClose($hFile)

MsgBox(0, 'Done', 'Count = ' & $iCount, 2)

#include <File.au3>

; $sPath = @ScriptDir & '\examples'
$sPath = @ScriptDir & '\libExamples'
$aFileList = _FileListToArray($sPath, '*.au3', 1)
If @error Then Exit

$sOut = ''
$iCount = 0
For $i = 1 To $aFileList[0]
    $sText = FileRead($sPath & '\' & $aFileList[$i])
    $sText = StringRegExpReplace($sText, '\s+\z', '')
    $sText = StringReplace($sText, 'MsgBox(0, ', 'MsgBox(4096, ')

    $hFile = FileOpen($sPath & '\' & $aFileList[$i], 2)
    FileWrite($hFile, $sText)
    FileClose($hFile)
Next

MsgBox(0, 'Done', 'Done', 2)

expandcollapse popup

; _DebugReport($sData [,$bLastError = False [,$bExit = False]])
; _DebugReport($sData [, $bLastError = False [, $bExit = False]])
; leads a line to the general format

#Include <File.au3>

$sPath = @ScriptDir & '\txtlibfunctions'
$aFileList=_FileListToArray($sPath, '*.txt', 1)

$sOut1 = ''
$sOut2 = ''
$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') ; delete the spaces around the brackets
        $tmp[1] = StringRegExpReplace($tmp[1], '([\w''"])\[,\h*\$', '\1 [, $') ; Restore spaces between parameters
        If $tmp0 <> $tmp[1] Then
            $sOut1 &= $tmp0 & @CRLF
            $sOut2 &= $tmp[1] & @CRLF
            $iCount += 1

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

; Write the output file
$hFile = FileOpen(@ScriptDir & '\sOut1_Old.txt', 2)
FileWrite($hFile, $sOut1)
FileClose($hFile)
$hFile = FileOpen(@ScriptDir & '\sOut2_New.txt', 2)
FileWrite($hFile, $sOut2)
FileClose($hFile)
MsgBox(0, 'Done', 'Count = ' & $iCount, 1)

[guinness]

They might be useful, but don't display the fundamental basics of coding, which I've told you before. All examples includes to the help file must pass Au3Check with advanced parameters switched on.

[mLipok]

Help for "GUICtrlRead"

do not talk anything about

GUICtrlCreateMonthCal

edit:

do not talk anything in

Return Value

section

Edited April 5, 2013 by mlipok

[guinness]

These are the parameters:

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

[AZJIO]

(Example)

#include <Constants.au3>
#include <WinAPI.au3>

_MouseClick(11, 22)
; _MouseMove(11, 22)

Func _MouseClick($x, $y)
    $x = $x * 65535 / @DesktopWidth
    $y = $y * 65535 / @DesktopHeight
    _WinAPI_Mouse_Event(BitOR($MOUSEEVENTF_ABSOLUTE, $MOUSEEVENTF_MOVE), $x, $y)
    _WinAPI_Mouse_Event(BitOR($MOUSEEVENTF_ABSOLUTE, $MOUSEEVENTF_LEFTDOWN), $x, $y)
    _WinAPI_Mouse_Event(BitOR($MOUSEEVENTF_ABSOLUTE, $MOUSEEVENTF_LEFTUP), $x, $y)
EndFunc ;==>_MouseClick

Func _MouseMove($x, $y)
    $x = $x * 65535 / @DesktopWidth
    $y = $y * 65535 / @DesktopHeight
    _WinAPI_Mouse_Event(BitOR($MOUSEEVENTF_ABSOLUTE, $MOUSEEVENTF_MOVE), $x, $y)
EndFunc ;==>_MouseMove

_WinAPI_DrawFrameControl (Example)

expandcollapse popup

#include <FrameConstants.au3>
#include <GUIConstantsEx.au3>
#include <WinAPI.au3>

$hGUI = GUICreate("_WinAPI_DrawFrameControl", 400, 300)
GUISetState()

$hDC = _WinAPI_GetWindowDC($hGUI)
$tRect = DllStructCreate($tagRECT)
$ptrRect = DllStructGetPtr($tRect)

_SetPosSize($tRect, 20, 45, 22, 22)
_WinAPI_DrawFrameControl($hDC, $ptrRect, $DFC_BUTTON, $DFCS_BUTTONCHECK + $DFCS_CHECKED)

_SetPosSize($tRect, 50, 45, 22, 22)
_WinAPI_DrawFrameControl($hDC, $ptrRect, $DFC_BUTTON, $DFCS_BUTTONRADIO + $DFCS_CHECKED)

_SetPosSize($tRect, 80, 40, 32, 32)
_WinAPI_DrawFrameControl($hDC, $ptrRect, $DFC_CAPTION, $DFCS_CAPTIONCLOSE)

Local $aState[9] = [8, $DFCS_BUTTON3STATE, $DFCS_BUTTON3STATE + $DFCS_INACTIVE, $DFCS_BUTTONCHECK, $DFCS_BUTTONPUSH, $DFCS_BUTTONPUSH + $DFCS_FLAT, $DFCS_BUTTONRADIO, $DFCS_BUTTONRADIOIMAGE, $DFCS_BUTTONRADIOMASK]
For $i = 1 To $aState[0]
    _SetPosSize($tRect, $i * 25, 100, 15, 15)
    _WinAPI_DrawFrameControl($hDC, $ptrRect, $DFC_BUTTON, $aState[$i])
Next

Local $aState[6] = [5, $DFCS_CAPTIONCLOSE + $DFCS_HOT, $DFCS_CAPTIonhelp + $DFCS_PUSHED, $DFCS_CAPTIONMAX, $DFCS_CAPTIONMIN, $DFCS_CAPTIONRESTORE]
For $i = 1 To $aState[0]
    _SetPosSize($tRect, $i * 25, 130, 22, 22)
    _WinAPI_DrawFrameControl($hDC, $ptrRect, $DFC_CAPTION, $aState[$i])
Next

Local $aState[5] = [4, $DFCS_MENUARROW + $DFCS_TRANSPARENT, $DFCS_MENUARROWRIGHT, $DFCS_MENUBULLET, $DFCS_MENUCHECK]
For $i = 1 To $aState[0]
    _SetPosSize($tRect, $i * 25, 160, 22, 22)
    _WinAPI_DrawFrameControl($hDC, $ptrRect, $DFC_MENU, $aState[$i])
Next

Local $aState[5] = [4, $DFCS_MENUARROW + $DFCS_TRANSPARENT, $DFCS_MENUARROWRIGHT, $DFCS_MENUBULLET, $DFCS_MENUCHECK]
For $i = 1 To $aState[0]
    _SetPosSize($tRect, $i * 25 + 120, 160, 22, 22)
    _WinAPI_DrawFrameControl($hDC, $ptrRect, $DFC_POPUPMENU, $aState[$i])
Next

Local $aState[9] = [8, $DFCS_SCROLLCOMBOBOX, $DFCS_SCROLLDOWN, $DFCS_SCROLLLEFT, $DFCS_SCROLLRIGHT, $DFCS_SCROLLSIZEGRIP, $DFCS_SCROLLSIZEGRIPRIGHT, $DFCS_SCROLLUP, $DFCS_ADJUSTRECT]
For $i = 1 To $aState[0]
    _SetPosSize($tRect, $i * 25, 190, 22, 22)
    _WinAPI_DrawFrameControl($hDC, $ptrRect, $DFC_SCROLL, $aState[$i])
Next

_WinAPI_ReleaseDC($hGUI, $hDC)

Do
Until GUIGetMsg() = $GUI_EVENT_CLOSE

Func _SetPosSize($tRect, $x, $y, $w, $h)
    DllStructSetData($tRect, "Left", $x)
    DllStructSetData($tRect, "Top", $y)
    DllStructSetData($tRect, "Right", $x + $w)
    DllStructSetData($tRect, "Bottom", $y + $h)
EndFunc   ;==>_SetPosSize

[guinness]

Great, but please run those examples against post #270.

[AZJIO]

Mod

This function guarantes that dividend = Int(dividend / divisor) * divisor + Mod(dividend, divisor).

This function guarantes that Mod(dividend, divisor) = dividend - Int(dividend / divisor) * divisor.

This function does not guarantee that dividend or divisor can be represented accurately, specifically with floating point numbers.

double?

Edited April 9, 2013 by AZJIO

[BrewManNH]

_GUICtrlMenu_GetItemState, the return values list disabled twice, once for value = 4 and again for value = 8.

Returns the Menu item type. Can be one or more of the following:

1 - Item is checked

2 - Item is the default item

4 - Item is disabled

8 - Item is disabled

16 - Item is highlighted

The text for value = 8 should be "Item is grayed", and not disabled. Although functionally they're the same, the values checked for in the function are for 2 different states.

If BitAND($iState, $MFS_DISABLED) <> 0 Then $iRet = BitOR($iRet, 4)

If BitAND($iState, $MFS_GRAYED) <> 0 Then $iRet = BitOR($iRet, 8)

The header information in the UDF GUIMenu.au3, has the same flaw.

[AZJIO]

A few months ago I tried to understand. As a result I understood that there are no reasons that to change something.

_GUICtrlRichEdit_SetParaNumbering

@error: 101 - $hWnd is not a handle

103 - $iTextToNbrSpace is not a postive number

104 - $fForceRoman must be True or False

102 - $sStyle is invalid

__GCR_ParseParaNumberingStyle($sStyle, $fForceRoman, $iPFM, $iWNumbering, $iWnumStart, $iWnumStyle, $iQspaces)
If @error Then Return SetError(@error, 0, False)

__GCR_ParseParaNumberingStyle
...
Return SetError(102, 0, False)
...

DirRemove

0 = (default) do not remove files and sub-directories

0 = (default) deletes the folder, only if it is empty

$tagREBARBANDINFO

Contains information about an item in a ComboBoxEx control

This value can be a combination of the following:;

_IENavigate, _IECreate

and will propmt for credentials if necessary.

prompt

_IEErrorHandlerDeRegister, _IE_VersionInfo, _IELoadWaitTimeout

Failure: None

In many functions this line is missing, if undefined.

Edited April 22, 2013 by AZJIO

[teletep]

Hi,

_WinAPI_IsClassName($hWnd,$Classname) returns TRUE when $Classname is empty, wathever the classname of the window is. I think this behaviour should be documented.

Seppe

[AZJIO]

List as a column appear more readable

InetGetInfo

The index for the data to retrieve. If this value is -1 an array containing all of the below data will be returned.

0 - Bytes read so far (this is updated while the download progresses).

....

The index for the data to retrieve.

-1 an array containing all of the below data will be returned.

0 - Bytes read so far (this is updated while the download progresses).

.....

_PathSplit

Returns an array with 5 elements where 0 = original path, 1 = drive, 2 = directory, 3 = filename, 4 = extension

Returns an array with 5 elements:

[0] - original path

[1] - drive

[2] - directory

[3] - filename

[4] - extension

TrayTip (ToolTip)

[optional] See Remarks. 0=No icon (default),

1=Info icon, 2=Warning icon, 3=Error icon

[optional] See Remarks.

0=No icon (default)

1=Info icon

2=Warning icon

3=Error icon

IniReadSection (as ProcessList)

Remarks

$array[0][0] = Number

$array[1][0] = 1st key

$array[1][1] = 1st value

$array[2][0] = 2nd key

$array[2][1] = 2nd value

...

$array[n][0] = nth key

$array[n][1] = nth value

[BrewManNH]

The example script for RegEnumKey has an error in it.

For $i = 1 To 10
    Local $var = RegEnumKey("HKEY_LOCAL_MACHINE\SOFTWARE", $i)
    If @error <> 0 Then ExitLoop
    MsgBox(4096, "SubKey #" & $i & " under HKLM\Software: ", $var)
Next

The MsgBox has a comma before the variable $var, it should be an ampersand.

[guinness]

No issue, this is the message part of the MsgBox.

I do see a problem with a poorly written example though.

#include <Constants.au3>

Local $sSubKey = ""
For $i = 1 To 10
    $sSubKey = RegEnumKey("HKEY_LOCAL_MACHINE\SOFTWARE", $i)
    If @error Then ExitLoop
    MsgBox($MB_SYSTEMMODAL, "SubKey #" & $i & " under HKLM\SOFTWARE: ", $sSubKey)
Next

Edited May 7, 2013 by guinness

[guinness]

See post above, I just re-read it again and there is no issue with the example in stable or what you posted there.