AutoIt Wiki - User contributions [en]

Function list

2012-08-05T02:00:31Z

JonTest: Removed a couple of outdated functions and added more new functions.

This function list should be a duplicate of the one found on the [http://www.autoitscript.com/autoit3/docs/functions.htm function list] found in the standard documentation. If the content differs, then the other page takes precidence. Some effort has been made to add value to the contents of this page over that one.

<table border="1">
<tr><th>Functon name</th><th>Description</th></tr>
<tr><td>[[Abs]]</td><td>Calculates the absolute value of a number.</td></tr>
<tr><td>[[ACos]]</td><td>Calculates the arcCosine of a number.</td></tr>
<tr><td>[[AdlibUnregister]]</td><td>Unregisters an Adlib function.</td></tr>
<tr><td>[[AdlibRegister]]</td><td>Registers an Adlib function.</td></tr>
<tr><td>[[Asc]]</td><td>Returns the ASCII code of a character.</td></tr>
<tr><td>[[AscW]]</td><td>Returns the unicode code of a character.</td></tr>
<tr><td>[[ASin]]</td><td>Calculates the arcSine of a number.</td></tr>
<tr><td>[[Assign]]</td><td>Assigns a variable by name with the data.</td></tr>
<tr><td>[[ATan]]</td><td>Calculates the arcTangent of a number.</td></tr>
<tr><td>[[AutoItSetOption]]</td><td>Changes the operation of various AutoIt functions/parameters.</td></tr>
<tr><td>[[AutoItWinGetTitle]]</td><td>Retrieves the title of the AutoIt window.</td></tr>
<tr><td>[[AutoItWinSetTitle]]</td><td>Changes the title of the AutoIt window.</td></tr>
<tr><td>[[Beep]]</td><td>Plays back a beep to the user.</td></tr>
<tr><td>[[Binary]]</td><td>Returns a binary representation of an expression.</td></tr>
<tr><td>[[BinaryLen]]</td><td>Returns the number of bytes in a binary variant.</td></tr>
<tr><td>[[BinaryMid]]</td><td>Extracts the number of bytes from a binary variant.</td></tr>
<tr><td>[[BinaryToString]]</td><td>Converts a binary variant into a string.</td></tr>
<tr><td>[[BitAND]]</td><td>Performs a bitwise AND operation.</td></tr>
<tr><td>[[BitNOT]]</td><td>Performs a bitwise NOT operation.</td></tr>
<tr><td>[[BitOR]]</td><td>Performs a bitwise OR operation.</td></tr>
<tr><td>[[BitRotate]]</td><td>Performs a bit shifting operation with rotation.</td></tr>
<tr><td>[[BitShift]]</td><td>Performs a bit shifting operation.</td></tr>
<tr><td>[[BitXOR]]</td><td>Performs a bitwise exclusive OR operation.</td></tr>
<tr><td>[[BlockInput]]</td><td>Disables/Enables user input.</td></tr>
<tr><td>[[Break]]</td><td>Enable/Disable the user's ability to exit a script from the tray icon menu.</td></tr>
<tr><td>[[Call]]</td><td>Calls a user-defined function contained in a string parameter.</td></tr>
<tr><td>[[CDTray]]</td><td>Opens or closes the CD tray.</td></tr>
<tr><td>[[Ceiling]]</td><td>Returns a number rounded up to the next integer.</td></tr>
<tr><td>[[Chr]]</td><td>Returns a character corresponding to an ASCII code.</td></tr>
<tr><td>[[ChrW]]</td><td>Returns a character representation to a unicode code.</td></tr>
<tr><td>[[ClipGet]]</td><td>Retrieves text from clipboard.</td></tr>
<tr><td>[[ClipPut]]</td><td>Writes text to clipboard.</td></tr>
<tr><td>[[ConsoleRead]]</td><td>Read from STDIN stream of the AutoIt script process.</td></tr>
<tr><td>[[ConsoleWrite]]</td><td>Writes to the STDOUT stream.</td></tr>
<tr><td>[[ConsoleWriteError]]</td><td>Writes data to the STDERR stream.</td></tr>
<tr><td>[[ControlClick]]</td><td>Sends a mouse click command to a given control.</td></tr>
<tr><td>[[ControlCommand]]</td><td>Sends a command to a control.</td></tr>
<tr><td>[[ControlDisable]]</td><td>Disables a control.</td></tr>
<tr><td>[[ControlEnable]]</td><td>Enables a control.</td></tr>
<tr><td>[[ControlFocus]]</td><td>Sets input focus to a given control on a window.</td></tr>
<tr><td>[[ControlGetFocus]]</td><td>Returns the ControlRef# of the control that has keyboard focus within a specified window.</td></tr>
<tr><td>[[ControlGetHandle]]</td><td>Retrieves the internal handle of a control.</td></tr>
<tr><td>[[ControlGetPos]]</td><td>Retrieves the position and size of a control relative to it's window.</td></tr>
<tr><td>[[ControlGetText]]</td><td>Retrieves text from a control.</td></tr>
<tr><td>[[ControlHide]]</td><td>Hides a control.</td></tr>
<tr><td>[[ControlListView]]</td><td>Sends a command to a ListView32 control.</td></tr>
<tr><td>[[ControlMove]]</td><td>Moves a control within a window.</td></tr>
<tr><td>[[ControlSend]]</td><td>Sends a string of characters to a control.</td></tr>
<tr><td>[[ControlSetText]]</td><td>Sets text of a control.</td></tr>
<tr><td>[[ControlShow]]</td><td>Unhides a control.</td></tr>
<tr><td>[[ControlTreeView]]</td><td>Sends a command to a TreeView32 control.</td></tr>
<tr><td>[[Cos]]</td><td>Calculates the Cosine of a value.</td></tr>
<tr><td>[[Dec]]</td><td>Returns a numeric representation of a hexadecimal string.</td></tr>
<tr><td>[[DirCopy]]</td><td>Copy a directory.</td></tr>
<tr><td>[[DirCreate]]</td><td>Create a directory.</td></tr>
<tr><td>[[DirGetSize]]</td><td>Returns the size in bytes of a given directory.</td></tr>
<tr><td>[[DirMove]]</td><td>Move/Rename a directory.</td></tr>
<tr><td>[[DirRemove]]</td><td>Delete a directory.</td></tr>
<tr><td>[[DllCall]]</td><td>Dynamically calls a function in a DLL.</td></tr>
<tr><td>[[DllCallAddress]]</td><td>Dynamically calls a function at a specific memory address.</td></tr>
<tr><td>[[DllCallbackFree]]</td><td>Frees a previously created handle created with DLLCallbackRegister.</td></tr>
<tr><td>[[DllCallbackGetPtr]]</td><td>Returns the pointer to a callback function that can be passed to the Win32 API.</td></tr>
<tr><td>[[DllCallbackRegister]]</td><td>Creates a user-defined DLL Callback function.</td></tr>
<tr><td>[[DllClose]]</td><td>Closes a previously opened DLL.</td></tr>
<tr><td>[[DllOpen]]</td><td>Opens a DLL file for use in DllCall.</td></tr>
<tr><td>[[DllStructCreate]]</td><td>Creates a C/C++ style structure to be used in DllCall.</td></tr>
<tr><td>[[DllStructGetData]]</td><td>returns the data of an element of the struct.</td></tr>
<tr><td>[[DllStructGetPtr]]</td><td>Returns the pointer to the struct or an element in the struct.</td></tr>
<tr><td>[[DllStructGetSize]]</td><td>Returns the size of the struct in bytes.</td></tr>
<tr><td>[[DllStructSetData]]</td><td>Sets the data of an element in the struct.</td></tr>
<tr><td>[[DriveGetDrive]]</td><td>Returns an array containing the enumerated drives.</td></tr>
<tr><td>[[DriveGetFileSystem]]</td><td>Returns File System Type of drive.</td></tr>
<tr><td>[[DriveGetLabel]]</td><td>Returns Volume Label of a drive.</td></tr>
<tr><td>[[DriveGetSerial]]</td><td>Returns Serial Number of a drive.</td></tr>
<tr><td>[[DriveGetType]]</td><td>Returns drive type.</td></tr>
<tr><td>[[DriveMapAdd]]</td><td>Maps a network drive.</td></tr>
<tr><td>[[DriveMapDel]]</td><td>Disconnects a network drive.</td></tr>
<tr><td>[[DriveMapGet]]</td><td>Retrieves the details of a mapped drive.</td></tr>
<tr><td>[[DriveSetLabel]]</td><td>Sets the Volume Label of a drive.</td></tr>
<tr><td>[[DriveSpaceFree]]</td><td>Returns the free disk space of a path in Megabytes.</td></tr>
<tr><td>[[DriveSpaceTotal]]</td><td>Returns the total disk space of a path in Megabytes.</td></tr>
<tr><td>[[DriveStatus]]</td><td>Returns the status of the drive as a string.</td></tr>
<tr><td>[[EnvGet]]</td><td>Retrieves an environment variable.</td></tr>
<tr><td>[[EnvSet]]</td><td>Writes an environment variable.</td></tr>
<tr><td>[[EnvUpdate]]</td><td>Refreshes the OS environment.</td></tr>
<tr><td>[[Eval]]</td><td>Returns the value of the variable defined by a string.</td></tr>
<tr><td>[[Execute]]</td><td>Execute an expression.</td></tr>
<tr><td>[[Exp]]</td><td>Calculates '''<i>e</i>''' to the power of a number.</td></tr>
<tr><td>[[FileChangeDir]]</td><td>Changes the current working directory.</td></tr>
<tr><td>[[FileClose]]</td><td>Closes a previously opened text file.</td></tr>
<tr><td>[[FileCopy]]</td><td>Copies one or more files.</td></tr>
<tr><td>[[FileCreateNTFSLink]]</td><td>Creates an NTFS hardlink to a file or directory.</td></tr>
<tr><td>[[FileCreateShortcut]]</td><td>Creates a shortcut (.lnk) to a file.</td></tr>
<tr><td>[[FileDelete]]</td><td>Delete one or more files.</td></tr>
<tr><td>[[FileExists]]</td><td>Checks if a file or directory exists.</td></tr>
<tr><td>[[FileFindFirstFile]]</td><td>Returns a search "handle" according to file search string.</td></tr>
<tr><td>[[FileFindNextFile]]</td><td>Returns a filename according to a previous call to FileFindFirstFile.</td></tr>
<tr><td>[[FileGetAttrib]]</td><td>Returns a code string representing a file's attributes.</td></tr>
<tr><td>[[FileGetEncoding]]</td><td>Determines the text encoding used in a file.</td></tr>
<tr><td>[[FileGetLongName]]</td><td>Returns the long path + name of the path + name passed.</td></tr>
<tr><td>[[FileGetPos]]</td><td>Retrieves the current file position.</td></tr>
<tr><td>[[FileGetShortcut]]</td><td>Retrieves details about a shortcut.</td></tr>
<tr><td>[[FileGetShortName]]</td><td>Returns the 8.3 short path+name of the path+name passed.</td></tr>
<tr><td>[[FileGetSize]]</td><td>returns the size of a file in bytes.</td></tr>
<tr><td>[[FileGetTime]]</td><td>Returns the time and date information for a file.</td></tr>
<tr><td>[[FileGetVersion]]</td><td>Returns the "File" version information.</td></tr>
<tr><td>[[FileInstall]]</td><td>Include and install a file with the compiled script.</td></tr>
<tr><td>[[FileMove]]</td><td>Moves one or more files.</td></tr>
<tr><td>[[FileOpen]]</td><td>Opens a text file for reading or writing.</td></tr>
<tr><td>[[FileOpenDialog]]</td><td>Initiates a Open File Dialog.</td></tr>
<tr><td>[[FileRead]]</td><td>Read in a number of characters from a previously opened text file.</td></tr>
<tr><td>[[FileReadLine]]</td><td>Read in a line of text from a previously opened text file.</td></tr>
<tr><td>[[FileRecycle]]</td><td>Sends a file or directory to the recycle bin.</td></tr>
<tr><td>[[FileRecycleEmpty]]</td><td>Empties the recycle bin.</td></tr>
<tr><td>[[FileSaveDialog]]</td><td>Initiates a Save File dialog.</td></tr>
<tr><td>[[FileSelectFolder]]</td><td>Initiates a Browse For Folder dialog.</td></tr>
<tr><td>[[FileSetAttrib]]</td><td>Sets the attributes of one or more files.</td></tr>
<tr><td>[[FileSetTime]]</td><td>Sets the timestamp of one or more files.</td></tr>
<tr><td>[[FileWrite]]</td><td>Append a line of text to the end of a previously opened text file.</td></tr>
<tr><td>[[FileWriteLine]]</td><td>Append a line of text to the end of a previously opened text file.</td></tr>
<tr><td>[[Floor]]</td><td>Returns a number rounded down to the nearest integer.</td></tr>
<tr><td>[[FtpSetProxy]]</td><td>Sets the internet proxy to use for ftp access.</td></tr>
<tr><td>[[GUICreate]]</td><td>Creates a GUI window.</td></tr>
<tr><td>[[GUICtrlCreateAvi]]</td><td>Creates an AVI video control for the GUI.</td></tr>
<tr><td>[[GUICtrlCreateButton]]</td><td>Creates a Button control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateCheckbox]]</td><td>Creates a Checkbox control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateCombo]]</td><td>Creats a ComboBox control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateContextMenu]]</td><td>Creates a context menu for a GUI or an underlying control.</td></tr>
<tr><td>[[GUICtrlCreateDate]]</td><td>Creates a date control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateDummy]]</td><td>Creates a Dummy control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateEdit]]</td><td>Creates an Edit control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateGraphic]]</td><td>Creates a Graphic control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateGroup]]</td><td>Creates a Group control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateIcon]]</td><td>Creates an icon within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateInput]]</td><td>Creates an Input control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateLabel]]</td><td>Creates a static Label control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateList]]</td><td>Creates a List control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateListView]]</td><td>Creates a ListView control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateListViewItem]]</td><td>Creates a ListView item.</td></tr>
<tr><td>[[GUICtrlCreateMenu]]</td><td>Creates a Menu control for a GUI.</td></tr>
<tr><td>[[GUICtrlCreateMenuItem]]</td><td>Creates a MenuItem control.</td></tr>
<tr><td>[[GUICtrlCreateMonthCal]]</td><td>Creates a month calendar control for the GUI.</td></tr>
<tr><td>[[GUICtrlCreateObj]]</td><td>Creates an ActiveX control for a GUI.</td></tr>
<tr><td>[[GUICtrlCreatePic]]</td><td>Creates a Picture control for a GUI.</td></tr>
<tr><td>[[GUICtrlCreateProgress]]</td><td>Creates a Progress control for a GUI.</td></tr>
<tr><td>[[GUICtrlCreateRadio]]</td><td>Creates a Radio button control within a GUI.</td></tr>
<tr><td>[[GUICtrlCreateSlider]]</td><td>Creates a Slider control for the GUI.</td></tr>
<tr><td>[[GUICtrlCreateTab]]</td><td>Creates a Tab control for the GUI.</td></tr>
<tr><td>[[GUICtrlCreateTabItem]]</td><td>Creates a TabItem.</td></tr>
<tr><td>[[GUICtrlCreateTreeView]]</td><td>Creates a TreeView control for a GUI.</td></tr>
<tr><td>[[GUICtrlCreateTreeViewItem]]</td><td>Creates a TreeViewItem.</td></tr>
<tr><td>[[GUICtrlCreateUpdown]]</td><td>Creates an UpDown control for a GUI.</td></tr>
<tr><td>[[GUICtrlDelete]]</td><td>Deletes a control.</td></tr>
<tr><td>[[GUICtrlGetHandle]]</td><td>Returns the handle for a control and some special (item) handles.</td></tr>
<tr><td>[[GUICtrlGetState]]</td><td>Gets the current state of a control.</td></tr>
<tr><td>[[GUICtrlRead]]</td><td>Reads the state or data of a control.</td></tr>
<tr><td>[[GUICtrlRecvMsg]]</td><td>Sends a message to a control and retrieves information in lParam.</td></tr>
<tr><td>[[GUICtrlRegisterListViewSort]]</td><td>Registers a user defined function for an internal listview sorting callback function.</td></tr>
<tr><td>[[GUICtrlSendMsg]]</td><td>Sends a message to a control.</td></tr>
<tr><td>[[GUICtrlSendToDummy]]</td><td>Sends a message to a Dummy control.</td></tr>
<tr><td>[[GUICtrlSetBkColor]]</td><td>Sets the background color of a control.</td></tr>
<tr><td>[[GUICtrlSetColor]]</td><td>Sets the text color of a control.</td></tr>
<tr><td>[[GUICtrlSetCursor]]</td><td>Sets the mouse cursor icon for a particular control.</td></tr>
<tr><td>[[GUICtrlSetData]]</td><td>Modifies the data for a control.</td></tr>
<tr><td>[[GUICtrlSetDefBkColor]]</td><td>Sets the default background color of all controls within a GUI.</td></tr>
<tr><td>[[GUICtrlSetDefColor]]</td><td>Sets the default text color of all controls within a GUI.</td></tr>
<tr><td>[[GUICtrlSetFont]]</td><td>Sets the font for a control.</td></tr>
<tr><td>[[GUICtrlSetGraphic]]</td><td>Modifies the data for a control.</td></tr>
<tr><td>[[GUICtrlSetImage]]</td><td>Sets a control's bitmap/icon image.</td></tr>
<tr><td>[[GUICtrlSetLimit]]</td><td>Limits the number of characters/pixels for a control.</td></tr>
<tr><td>[[GUICtrlSetOnEvent]]</td><td>Defines a user-defined function to be called when a control is clicked.</td></tr>
<tr><td>[[GUICtrlSetPos]]</td><td>Changes the position of a control within the GUI window.</td></tr>
<tr><td>[[GUICtrlSetResizing]]</td><td>Defines the resizing method for a control.</td></tr>
<tr><td>[[GUICtrlSetState]]</td><td>Changes the state of a control.</td></tr>
<tr><td>[[GUICtrlSetStyle]]</td><td>Changes the style of a control.</td></tr>
<tr><td>[[GUICtrlSetTip]]</td><td>Sets the tip text associated with a control.</td></tr>
<tr><td>[[GUIDelete]]</td><td>Deletes a GUI and all underlying controls.</td></tr>
<tr><td>[[GUIGetCursorInfo]]</td><td>Gets the mouse cursor position relative to the GUI window.</td></tr>
<tr><td>[[GUIGetMsg]]</td><td>Polls a GUI for an event.</td></tr>
<tr><td>[[GUIGetStyle]]</td><td>retrieves the styles of a GUI window.</td></tr>
<tr><td>[[GUIRegisterMsg]]</td><td>Register a user defined function for a known Windows Message ID (WM_MSG).</td></tr>
<tr><td>[[GUISetAccelerators]]</td><td>Sets the accelerator table to be used in a GUI.</td></tr>
<tr><td>[[GUISetBkColor]]</td><td>Sets the background color of a GUI window.</td></tr>
<tr><td>[[GUISetCoord]]</td><td>Sets the absolute coordinates for the next control.</td></tr>
<tr><td>[[GUISetCursor]]</td><td>Sest the mouse cursor icon for a GUI window.</td></tr>
<tr><td>[[GUISetFont]]</td><td>Sets the default font for a GUI window.</td></tr>
<tr><td>[[GUISetHelp]]</td><td>Sets an executable file that will run when F1 is pressed.</td></tr>
<tr><td>[[GUISetIcon]]</td><td>Sets the icon used in a GUI window.</td></tr>
<tr><td>[[GUISetOnEvent]]</td><td>Defines a user function to be called when a system button is pressed.</td></tr>
<tr><td>[[GUISetState]]</td><td>Changes the state of a GUI window.</td></tr>
<tr><td>[[GUISetStyle]]</td><td>Changes the styles of a GUI window.</td></tr>
<tr><td>[[GUIStartGroup]]</td><td>Defines that any subsequent controls that are created will be "grouped" together.</td></tr>
<tr><td>[[GUISwitch]]</td><td>Switches the current window used for GUI functions.</td></tr>
<tr><td>[[Hex]]</td><td>Returns a string representation of an integer or of a binary type converted to hexadecimal.</td></tr>
<tr><td>[[HotKeySet]]</td><td>Sets a hotkey that calls a user function.</td></tr>
<tr><td>[[HttpSetProxy]]</td><td>Sets the internet proxy to use for http access.</td></tr>
<tr><td>[[HttpSetUserAgent]]</td><td>Sets the HTTP user-agent string which is sent with all Inet requests.</td></tr>
<tr><td>[[HWnd]]</td><td>Converts an expression into an HWND handle.</td></tr>
<tr><td>[[InetClose]]</td><td>Closes a handle returned from InetGet().</td></tr>
<tr><td>[[InetGet]]</td><td>Downloads a file from the internet using the http or ftp protocol.</td></tr>
<tr><td>[[InetGetInfo]]</td><td>Returns detailed data for a handle returned from InetGet().</td></tr>
<tr><td>[[InetGetSize]]</td><td>Returns the size (in bytes) of a file located on the internet.</td></tr>
<tr><td>[[InetRead]]</td><td>Downloads a file from the internet using the HTTP, HTTPS or FTP protocol.</td></tr>
<tr><td>[[IniDelete]]</td><td>Deletes a value from a standard format .ini file.</td></tr>
<tr><td>[[IniRead]]</td><td>Reads a value from a standard format .ini file.</td></tr>
<tr><td>[[IniReadSection]]</td><td>Reads all key/value pairs from a section in a standard format .ini file.</td></tr>
<tr><td>[[IniReadSectionNames]]</td><td>Reads all sections in a standard format .ini file.</td></tr>
<tr><td>[[IniRenameSection]]</td><td>Renames a section in a standard format .ini file.</td></tr>
<tr><td>[[IniWrite]]</td><td>Writes a value to a standard format .ini file.</td></tr>
<tr><td>[[IniWriteSection]]</td><td>Writes a section to a standard format .ini file.</td></tr>
<tr><td>[[InputBox]]</td><td>Displays an input box requesting a user input string.</td></tr>
<tr><td>[[Int]]</td><td>Returns the integer (whole) representation of an expression.</td></tr>
<tr><td>[[IsAdmin]]</td><td>Checks if the current user has full administrator privileges.</td></tr>
<tr><td>[[IsArray]]</td><td>Checks if a variable is an array type.</td></tr>
<tr><td>[[IsBinary]]</td><td>Checks if a variable or expression is a binary type.</td></tr>
<tr><td>[[IsBool]]</td><td>Checks if a variable's base type is boolean.</td></tr>
<tr><td>[[IsDeclared]]</td><td>Checks if a variable has been declared.</td></tr>
<tr><td>[[IsDllStruct]]</td><td>Checks if a variable is a DllStruct type.</td></tr>
<tr><td>[[IsFloat]]</td><td>Checks if a variable or expression is a float-type.</td></tr>
<tr><td>[[IsHWnd]]</td><td>Checks if a variable's base type is a pointer and window handle.</td></tr>
<tr><td>[[IsInt]]</td><td>Checks if a variable or expression is an integer type.</td></tr>
<tr><td>[[IsKeyword]]</td><td>Checks if a variable is a keyword. (e.g. Default)</td></tr>
<tr><td>[[IsNumber]]</td><td>Checks if variable's base type is numeric.</td></tr>
<tr><td>[[IsObj]]</td><td>Checks if a variable or expression is an object type.</td></tr>
<tr><td>[[IsPtr]]</td><td>Checks if a variable's base type is a pointer.</td></tr>
<tr><td>[[IsString]]</td><td>Checks if a variable is a string type.</td></tr>
<tr><td>[[Log]]</td><td>Calculates the natural logarithm of a number.</td></tr>
<tr><td>[[MemGetStats]]</td><td>Retrieves memory related information.</td></tr>
<tr><td>[[Mod]]</td><td>Performs the modulus operation.</td></tr>
<tr><td>[[MouseClick]]</td><td>Perform a mouse click operation.</td></tr>
<tr><td>[[MouseClickDrag]]</td><td>Perform a a mouse click and drag operation.</td></tr>
<tr><td>[[MouseDown]]</td><td>Perform a mouse down event at the current mouse position.</td></tr>
<tr><td>[[MouseGetCursor]]</td><td>Returns the cursor ID Number for the current Mouse Cursor.</td></tr>
<tr><td>[[MouseGetPos]]</td><td>Retrieves the current position of the mouse cursor.</td></tr>
<tr><td>[[MouseMove]]</td><td>Moves the mouse pointer.</td></tr>
<tr><td>[[MouseUp]]</td><td>Performs a mouse up event at the current mouse position.</td></tr>
<tr><td>[[MouseWheel]]</td><td>Moves the mouse wheel up or down. (NT/2k/XP only)</td></tr>
<tr><td>[[MsgBox]]</td><td>Displays a simple message box with optional timeout.</td></tr>
<tr><td>[[Number]]</td><td>Returns the numeric representation of an expression.</td></tr>
<tr><td>[[ObjCreate]]</td><td>Creates a reference to a COM object from the given classname.</td></tr>
<tr><td>[[ObjCreateInterface]]</td><td>Creates a reference to an object from the given classname/object pointer, interface identifier and description string.</td></tr>
<tr><td>[[ObjEvent]]</td><td>Handles incoming events from the given Object.</td></tr>
<tr><td>[[ObjGet]]</td><td>Retrieves a reference to a COM object from an existing process or filename.</td></tr>
<tr><td>[[ObjName]]</td><td>Returns the name or interface description of an Object.</td></tr>
<tr><td>[[OnAutoItExitRegister]]</td><td>Registers a function to be called when AutoIt exits.</td></tr>
<tr><td>[[OnAutoItExitUnregister]]</td><td>Unregisters a function to be called when AutoIt exits.</td></tr>
<tr><td>[[Ping]]</td><td>Pings a host and returns the roundtrip-time.</td></tr>
<tr><td>[[PixelChecksum]]</td><td>Generates a checksum for a region of pixels.</td></tr>
<tr><td>[[PixelGetColor]]</td><td>Returns a pixel color according to x,y pixel coordinates.</td></tr>
<tr><td>[[PixelSearch]]</td><td>Searches a rectangle of pixels for the pixel color provided.</td></tr>
<tr><td>[[ProcessClose]]</td><td>Terminates a named process.</td></tr>
<tr><td>[[ProcessExists]]</td><td>Checks to see if a specified process exists.</td></tr>
<tr><td>[[ProcessGetStats]]</td><td>Returns an array of information about a running process.</td></tr>
<tr><td>[[ProcessList]]</td><td>Returns an array of currently running processes.</td></tr>
<tr><td>[[ProcessSetPriority]]</td><td>Changes the priority of a process.</td></tr>
<tr><td>[[ProcessWait]]</td><td>Pauses script execution until a given process exists.</td></tr>
<tr><td>[[ProcessWaitClose]]</td><td>Pauses a script execution until a given process does not exist.</td></tr>
<tr><td>[[ProgressOff]]</td><td>Turns Progress window off.</td></tr>
<tr><td>[[ProgressOn]]</td><td>Creates a customizable progress bar window.</td></tr>
<tr><td>[[ProgressSet]]</td><td>Sets the position and/or text of a previously created Progress bar window.</td></tr>
<tr><td>[[Ptr]]</td><td>Converts an expression into a pointer variant.</td></tr>
<tr><td>[[Random]]</td><td>Generates a pseudo-random float-type number.</td></tr>
<tr><td>[[RegDelete]]</td><td>Deletes a key or value from the registry.</td></tr>
<tr><td>[[RegEnumKey]]</td><td>Reads the name of a subkey according to it's instance.</td></tr>
<tr><td>[[RegEnumVal]]</td><td>Reads the name of a value according to it's instance.</td></tr>
<tr><td>[[RegRead]]</td><td>reads a value from the registry.</td></tr>
<tr><td>[[RegWrite]]</td><td>Creates a key or value in the registry.</td></tr>
<tr><td>[[Round]]</td><td>Returns a number rounded to a specified number of decimal places.</td></tr>
<tr><td>[[Run]]</td><td>Runs an external program.</td></tr>
<tr><td>[[RunAs]]</td><td>Runs an external program under the context of a different user.</td></tr>
<tr><td>[[RunAsWait]]</td><td>Runs an external program under the context of a different user and pauses script execution until the program finishes.</td></tr>
<tr><td>[[RunWait]]</td><td>Runs an external program and pauses script execution until the program finishes.</td></tr>
<tr><td>[[Send]]</td><td>Sends simulated keystrokes to the active window.</td></tr>
<tr><td>[[SendKeepActive]]</td><td>Attempts to keep a specified window active during Send().</td></tr>
<tr><td>[[SetError]]</td><td>Manually set the value of the @error macro.</td></tr>
<tr><td>[[SetExtended]]</td><td>Manually set the value of the @extended macro.</td></tr>
<tr><td>[[ShellExecute]]</td><td>Runs an external program using the ShellExecute API.</td></tr>
<tr><td>[[ShellExecuteWait]]</td><td>Runs an external program using the ShellExecute API and pauses script execution until it finishes.</td></tr>
<tr><td>[[Shutdown]]</td><td>Shuts down the system.</td></tr>
<tr><td>[[Sin]]</td><td>Calculates the Sine of a number.</td></tr>
<tr><td>[[Sleep]]</td><td>Pause script execution.</td></tr>
<tr><td>[[SoundPlay]]</td><td>Play a sound file.</td></tr>
<tr><td>[[SoundSetWaveVolume]]</td><td>Sets the system wave volume by percent.</td></tr>
<tr><td>[[SplashImageOn]]</td><td>Creates a customizable image popup window.</td></tr>
<tr><td>[[SplashOff]]</td><td>Turns SplashText or SplashImage off.</td></tr>
<tr><td>[[SplashTextOn]]</td><td>Creates a customizable text popup window.</td></tr>
<tr><td>[[Sqrt]]</td><td>Calculates the square-root of a number.</td></tr>
<tr><td>[[SRandom]]</td><td>Set Seed for random number generation.</td></tr>
<tr><td>[[StatusbarGetText]]</td><td>Retrieves the text from a standard status bar control.</td></tr>
<tr><td>[[StderrRead]]</td><td>Reads from the STDERR stream of a previously run child process.</td></tr>
<tr><td>[[StdinWrite]]</td><td>Writes a number of characters to the STDIN stream of a previously run child process.</td></tr>
<tr><td>[[StdioClose]]</td><td>Closes all resources associated with a process previously run with STDIO redirection.</td></tr>
<tr><td>[[StdoutRead]]</td><td>Reads from the STDOUT stream of a previously run child process.</td></tr>
<tr><td>[[String]]</td><td>Returns the string representation of an expression.</td></tr>
<tr><td>[[StringAddCR]]</td><td>Takes a string and prefixes all linefeed characters (Chr(10)) with a carriage return character (Chr(13)).</td></tr>
<tr><td>[[StringCompare]]</td><td>Compares two strings with options.</td></tr>
<tr><td>[[StringFormat]]</td><td>Returns a formatted string. (Similar to C's sprintf() function.)</td></tr>
<tr><td>[[StringFromASCIIArray]]</td><td>Converts an array of ASCII codes to a string.</td></tr>
<tr><td>[[StringInStr]]</td><td>Checks if a string contains a given substring.</td></tr>
<tr><td>[[StringIsAlNum]]</td><td>Checks if a string contains only alphanumeric characters.</td></tr>
<tr><td>[[StringIsAlpha]]</td><td>Checks if a string contains only alphabetic characters.</td></tr>
<tr><td>[[StringIsASCII]]</td><td>Checks if a string contains only ASCII characters in the range 0x00 - 0x7f (0-127).</td></tr>
<tr><td>[[StringIsDigit]]</td><td>Checks if a string contains only digit (0-9) characters.</td></tr>
<tr><td>[[StringIsFloat]]</td><td>Checks if a string is a floating point number.</td></tr>
<tr><td>[[StringIsInt]]</td><td>Checks if a string is an integer.</td></tr>
<tr><td>[[StringIsLower]]</td><td>Checks if a string contains only lowercase characters.</td></tr>
<tr><td>[[StringIsSpace]]</td><td>Checks if a string contains only whitespace characters.</td></tr>
<tr><td>[[StringIsUpper]]</td><td>Checks if a string contains only uppercase characters.</td></tr>
<tr><td>[[StringIsXDigit]]</td><td>Checks if a string contains only hexadecimal digit (0-F) characters.</td></tr>
<tr><td>[[StringLeft]]</td><td>Returns a number of characters from the left-hand side of a string.</td></tr>
<tr><td>[[StringLen]]</td><td>Returns the number of characters in a string.</td></tr>
<tr><td>[[StringLower]]</td><td>Converts a string to lowercase.</td></tr>
<tr><td>[[StringMid]]</td><td>Extracts a number of characters from a string.</td></tr>
<tr><td>[[StringRegExp]]</td><td>Check if a string fits a given regular expression pattern.</td></tr>
<tr><td>[[StringRegExpReplace]]</td><td>Replace text in a string based on a regular expression.</td></tr>
<tr><td>[[StringReplace]]</td><td>Replaces substrings in a string.</td></tr>
<tr><td>[[StringRight]]</td><td>Returns a number of characters from the right-hand side of a string.</td></tr>
<tr><td>[[StringSplit]]</td><td>Splits up a string into substrings depending on the given delimiters.</td></tr>
<tr><td>[[StringStripCR]]</td><td>Removes all carriage return values (Chr(13)) from a string.</td></tr>
<tr><td>[[StringStripWS]]</td><td>Strips whitespace from a string.</td></tr>
<tr><td>[[StringToASCIIArray]]</td><td>Converts a string to an array containing the ASCII code of each character.</td></tr>
<tr><td>[[StringToBinary]]</td><td>Converts a string into binary data.</td></tr>
<tr><td>[[StringTrimLeft]]</td><td>Trims a number of characters from the left hand side of a string.</td></tr>
<tr><td>[[StringTrimRight]]</td><td>Trims a number of characters from the right hand side of a string.</td></tr>
<tr><td>[[StringUpper]]</td><td>Converts a string to uppercase.</td></tr>
<tr><td>[[Tan]]</td><td>Calculates the Tangent of a number.</td></tr>
<tr><td>[[TCPAccept]]</td><td>Permits an incoming connection attempt on a socket.</td></tr>
<tr><td>[[TCPCloseSocket]]</td><td>Closes a TCP socket.</td></tr>
<tr><td>[[TCPConnect]]</td><td>Create a socket connected to an existing server.</td></tr>
<tr><td>[[TCPListen]]</td><td>Creates a socket listening for an incoming connection.</td></tr>
<tr><td>[[TCPNameToIP]]</td><td>Converts an Internet name to IP address.</td></tr>
<tr><td>[[TCPRecv]]</td><td>Receives data from a connected socket.</td></tr>
<tr><td>[[TCPSend]]</td><td>Sends data on a connected socket.</td></tr>
<tr><td>[[TCPShutdown]],[[UDPShutdown]]</td><td>Stops TCP/UDP services.</td></tr>
<tr><td>[[TCPStartup]],[[UDPStartup]]</td><td>Starts TCP/UDP services.</td></tr>
<tr><td>[[TimerDiff]]</td><td>Returns the difference in time from a previous call to TimerInit().</td></tr>
<tr><td>[[TimerInit]]</td><td>Returns a timestamp (in milliseconds).</td></tr>
<tr><td>[[ToolTip]]</td><td>Creates a tooltip anywhere on the screen.</td></tr>
<tr><td>[[TrayCreateItem]]</td><td>Creates a MenuItem control for the tray.</td></tr>
<tr><td>[[TrayCreateMenu]]</td><td>Creates a menu control for the tray menu.</td></tr>
<tr><td>[[TrayGetMsg]]</td><td>Polls the tray to see if any events have occurred.</td></tr>
<tr><td>[[TrayItemDelete]]</td><td>Deletes a menu/item control from the tray menu.</td></tr>
<tr><td>[[TrayItemGetHandle]]</td><td>Returns the handle for a tray menu(item).</td></tr>
<tr><td>[[TrayItemGetState]]</td><td>Gets the current state of a control.</td></tr>
<tr><td>[[TrayItemGetText]]</td><td>Gets the itemtext of a tray menu/item control.</td></tr>
<tr><td>[[TrayItemSetOnEvent]]</td><td>Defines a user-defined function to be called when a tray item is clicked.</td></tr>
<tr><td>[[TrayItemSetState]]</td><td>Sets the state of a tray menu/item control.</td></tr>
<tr><td>[[TrayItemSetText]]</td><td>Sets the itemtext of a tray menu/item control.</td></tr>
<tr><td>[[TraySetClick]]</td><td>Sets the clickmode of the tray icon - what mouseclicks will display the tray menu.</td></tr>
<tr><td>[[TraySetIcon]]</td><td>Loads/Sets a specified tray icon.</td></tr>
<tr><td>[[TraySetOnEvent]]</td><td>Defines a user function to be called when a special tray action happens.</td></tr>
<tr><td>[[TraySetPauseIcon]]</td><td>Loads/Sets a specified tray pause icon.</td></tr>
<tr><td>[[TraySetState]]</td><td>Sets the state of the tray icon.</td></tr>
<tr><td>[[TraySetToolTip]]</td><td>(Re)Sets the tooltip text for the tray icon.</td></tr>
<tr><td>[[TrayTip]]</td><td>Displays a balloon tip from the AutoIt Icon.(2k/XP only)</td></tr>
<tr><td>[[UBound]]</td><td>Returns the size of array dimensions.</td></tr>
<tr><td>[[UDPBind]]</td><td>Create a socket bound to an incoming connection.</td></tr>
<tr><td>[[UDPCloseSocket]]</td><td>Close a UDP socket.</td></tr>
<tr><td>[[UDPOpen]]</td><td>Open a socket connected to an existing server.</td></tr>
<tr><td>[[UDPRecv]]</td><td>Receives data from a opened socket.</td></tr>
<tr><td>[[UDPSend]]</td><td>Sends data on an opened socket.</td></tr>
<tr><td>[[VarGetType]]</td><td>Returns the internal type representation of a variant.</td></tr>
<tr><td>[[WinActivate]]</td><td>Activates (gives focus to) a window.</td></tr>
<tr><td>[[WinActive]]</td><td>Checks to see if a specified window exists and is currently active.</td></tr>
<tr><td>[[WinClose]]</td><td>Closes a window.</td></tr>
<tr><td>[[WinExists]]</td><td>Checks to see if a specified window exists.</td></tr>
<tr><td>[[WinFlash]]</td><td>Flashes a window in the taskbar.</td></tr>
<tr><td>[[WinGetCaretPos]]</td><td>Returns the coordinates of the caret in the foreground window.</td></tr>
<tr><td>[[WinGetClassList]]</td><td>Retrieves the classes from a window.</td></tr>
<tr><td>[[WinGetClientSize]]</td><td>Retrieves the size of a given window's client area.</td></tr>
<tr><td>[[WinGetHandle]]</td><td>Retrieves the internal handle of a window.</td></tr>
<tr><td>[[WinGetPos]]</td><td>Retrieves the position and size of a given window.</td></tr>
<tr><td>[[WinGetProcess]]</td><td>retrieves the ProcessID(PID) associated with a window.</td></tr>
<tr><td>[[WinGetState]]</td><td>Retrieves the state of a given window.</td></tr>
<tr><td>[[WinGetText]]</td><td>Retrieves the text from a window.</td></tr>
<tr><td>[[WinGetTitle]]</td><td>Retrives the full title from a window.</td></tr>
<tr><td>[[WinKill]]</td><td>Forces a window to close.</td></tr>
<tr><td>[[WinList]]</td><td>Retrieves a list of windows.</td></tr>
<tr><td>[[WinMenuSelectItem]]</td><td>Invokes a menu item of a window.</td></tr>
<tr><td>[[WinMinimizeAll]]</td><td>Minimizes all windows.</td></tr>
<tr><td>[[WinMinimizeAllUndo]]</td><td>Undoes a previous WinMinimizeAll function call.</td></tr>
<tr><td>[[WinMove]]</td><td>Moves and/or resizes a window.</td></tr>
<tr><td>[[WinSetOnTop]]</td><td>Changes a window's "Always On Top" attribute.</td></tr>
<tr><td>[[WinSetState]]</td><td>Shows, hides, minimizes, maximizes, or restores a window.</td></tr>
<tr><td>[[WinSetTitle]]</td><td>Changes the title of a window.</td></tr>
<tr><td>[[WinSetTrans]]</td><td>Sets the transparency of a window. (2k/XP or later)</td></tr>
<tr><td>[[WinWait]]</td><td>Pauses execution of the script until the requested window exists.</td></tr>
<tr><td>[[WinWaitActive]]</td><td>Pauses execution of the script until the requested window is active.</td></tr>
<tr><td>[[WinWaitClose]]</td><td>Pauses the execution of a script until the requested window does not exist.</td></tr>
<tr><td>[[WinWaitNotActive]]</td><td>Pauses execution of the script until the requested window is not active.</td></tr>
</table>

FAQ

2012-08-05T01:19:28Z

JonTest: Spelling, typos, and removal of a somewhat outdated reference.

This is a list of frequently asked questions asked on the forums.
Other FAQs include:
* The one found in the [http://www.autoitscript.com/autoit3/docs/faq.htm AutoIt HelpFile]. Much of it is about the transition from V2 to V3, but most is still relevant and should be a port of call, as well as this one.

==How can I debug my script?==

=== In SciTE ===
This one has a myriad of answers, but the most effective is to begin by using the [http://www.autoitscript.com/autoit3/scite/ SciTE4AutoIt3 Editor] to create or edit scripts. This program is useful in debugging for the following reasons:

* Syntax highlighting allows for immediate viewing of any mistakes from unended script tags or quotes. This allows the scripter to visibly see the difference between the following portions of code.
[[File:FAQ_Q1_2.jpg|center|Incorrect code]]
And the incorrect version:
[[File:FAQ_Q1_3.jpg|center||Correct Code]]
* Global Syntax check built directly into the tools menu allows you to check an entire script for problems all at once.
* Built-in code tidying program that correctly indents untidy code and repairs messy scripts to allow them to be more readable. It also corrects problems with incorrectly capitalised function names and variables.
* Per-line trace insertion allows you to log every line of code executed to debug errors.
* Debug MsgBox's or ConsoleWrite's are able to be added anywhere in the script directly from SciTE. ConsoleWrite lines are less intrusive and prevent the added annoyance to the user of MsgBox's.

[[File:FAQ_Q1_4.jpg|center|Picture of SciTE4AutoIt3]]

=== Using more code to check @error value ===
Nearly all functions will return something. Most of the time when a function fails, it returns 0 and sets @error. You can use this information not only to create scripts that handle for different errors but to debug and find out exactly why you are having problems. Check the help file for specific functions and their return values.

=== Via the Tray icon===
You can add this line at the top of your script (1 is on, 0 is off) to enable debugging from the tray icon.

<syntaxhighlight lang="autoit">AutoItSetOption ("TrayIconDebug", 1);0-off</syntaxhighlight>
Then if you run the script (uncompiled as an AU3 file), you can mouse over the AutoIt icon in the system tray (down by the clock) to display debugging information.

[[File:FAQ_Q1_1.jpg|center|Example output for TrayIconDebug]]

=== OutputDebugString native call ===
You can also debug a script on any computer by adding the following code to your script:

<syntaxhighlight lang="autoit">Func dbg($msg)
DllCall("kernel32.dll", "none", "OutputDebugString", "str", $msg)
EndFunc</syntaxhighlight>
Then, when you need to add a debug line, call it as necessary. Example:

<syntaxhighlight lang="autoit">dbg("The value of Variable 1 at this time is " & $var1)</syntaxhighlight>
This debugging is completely transparent to the user, and is only viewable with a program such as DebugView from SysInternals. This method of debugging has the added advantage of being available to the developer in situations where is not acceptable or feasable to install SciTE on a client's unit.

=== Graphical debugger ===
Stumpii created a [http://www.autoitscript.com/forum/index.php?showtopic=21834 Graphical AutoIt Debugger], similar to Dev-C++'s debugging style.

[[File:FAQ_Q1_5.jpg|center|Stumpii's Graphical AutoIt Debugger]]

==How can I run something that is not an exe file [.txt, .msi, .pdf,.jpg etc.] [or] How can I open a webpage in the default browser?==
It was for this reason that the ShellExecute function was created. Here is one example:

<syntaxhighlight lang="autoit">ShellExecute("C:\autoitscripts\test.au3", "", "", "edit", @SW_MAXIMIZE)</syntaxhighlight>

You can also specify a web address this way:

<syntaxhighlight lang="autoit">ShellExecute("http://www.autoitscript.com/forum", "", "", "open")</syntaxhighlight>

If you normally are able to right-click the file and select print, then you can also print the file from AutoIt using this function:

<syntaxhighlight lang="autoit">ShellExecute("C:\boot.ini", "", "", "print")</syntaxhighlight>

If you wish to open the file with the default program, you can do as follows (BETA ONLY):
<syntaxhighlight lang="autoit">ShellExecute("C:\autoitscripts\test.au3")</syntaxhighlight>

If you wish your script to wait until the process is finished, you can use the ShellExecuteWait function with the same parameters.

Note:
The default verb is the verb configured in the registry. If no verb is set as default in the registry then the "open" verb is used. If the "open" verb is not present then the first verb listed in the registry is used (except on Windows 2000).

==How can I prevent more than one copy of my script from running at once / detect another copy of my script running?==

=== _Singleton function ===
There are a few different ways to go about this. You can use a function called _Singleton to detect multiple instances of your script. An example of how to use this code:

<syntaxhighlight lang="autoit">#include <Misc.au3>
_Singleton("TheNameOfMyScript")</syntaxhighlight>

In this instance, the script will immediately exit if there is already one copy running. If you simply want know if another copy is running, you can use code similar to the next example:

<syntaxhighlight lang="autoit">#include <Misc.au3>
If _Singleton("MyScriptName", 1) = 0 Then
; We know the script is already running. Let the user know.
MsgBox(0, "Script Name", "This script is already running. Using multiple copies of this script at the same time is unsupported!")
Exit
EndIf</syntaxhighlight>

===_MutexExists function ===
Another method is to use _MutexExists.

<syntaxhighlight lang="autoit">
If _MutexExists("MydeswswScriptName") Then
; We know the script is already running. Let the user know.
MsgBox(0, "Script Name", "This script is already running. Using multiple copies of this script at the same time is unsupported!")
Exit
EndIf

;Function Author- Martin
Func _MutexExists($sOccurenceName)
Local $ERROR_ALREADY_EXISTS = 183, $handle, $lastError
$sOccurenceName = StringReplace($sOccurenceName, "", ""); to avoid error
$handle = DllCall("kernel32.dll", "int", "CreateMutex", "int", 0, "long", 1, "str", $sOccurenceName)
$lastError = DllCall("kernel32.dll", "int", "GetLastError")
Return $lastError[0] = $ERROR_ALREADY_EXISTS
EndFunc;==>_MutexExists</syntaxhighlight>

==How can I run my script as a service?==
This is also a question with multiple answers, and none of them are the only way to do it. The first question to ask yourself is whether or not you wish to install the service on other computers besides your own.

=== On your own computer - One time only ===
The easiest way to do this is to use Pirmasoft RunAsSvc. This program makes services easy to install and easy to remove when necessary.

=== On all computers that run your script===
To do this you can use SRVANY.EXE and [http://www.autoitscript.com/forum/index.php?showtopic=6487 ServiceControl.au3]. You can then use this code to install your script as a service:

<syntaxhighlight lang="autoit">
#include "ServiceControl.au3"
$servicename = "MyServiceName"
_CreateService("", $servicename, "My AutoIt Script", "C:\Path_to_\srvany.exe", "LocalSystem", "", 0x110)
RegWrite("HKLM\SYSTEM\CurrentControlSet\Services\" & $servicename & "\Parameters", "Application", "REG_SZ", @ScriptFullPath)
</syntaxhighlight>

Or use the following code to delete this service:

<syntaxhighlight lang="autoit">
#include "ServiceControl.au3"
$servicename = "MyServiceName"
_DeleteService("", $servicename)
</syntaxhighlight>

There is one caveat to setting up AutoIt as a service. If the service is not installed using the above code, it must have the "allow service to interact with the desktop" setting or else automation functions such as Control* or Win* functions will not function. To assure the service does indeed have this setting, use the following code:

<syntaxhighlight lang="autoit">RegWrite("HKLM\SYSTEM\CurrentControlSet\Services\[ServiceName]", "Type", "REG_DWORD", 0x110)</syntaxhighlight>

==How can I create/start/stop or otherwise control a service?==
There are two include libraries that are designed specifically to interact with services. These are the following:

* [http://www.autoitscript.com/forum/index.php?showtopic=6487 ServiceControl.au3] made by SumTingWong. Functionality:
** _StartService()
** _StopService()
** _ServiceExists()
** _ServiceRunning()
** _CreateService()
** _DeleteService()
* [http://www.autoitscript.com/forum/index.php?showtopic=22165 _NTServices.au3] made by CatchFish. Functionality:
** _ServiceStart()
** _ServiceStop()
** _ServiceStatus()
** _ServicePause()

==How can I display a progress bar while copying files or directories?==
There are a many different topics on how to do this. For more, just search the forums for [http://www.autoitscript.com/forum/index.php?act=Search&CODE=show&searchid=22030d4d4effe5e32da23fdb69ed772f&search_in=posts&result_type=topics&highlite=%2BCopy%2B Progress Copy + Progress].
* [http://www.autoitscript.com/forum/index.php?showtopic=11313 Copy with progress dialog]... By ezztabi
* [http://www.autoitscript.com/forum/index.php?showtopic=11888 Yet another copy with progress]... By SumTingWong
* [http://www.autoit.de/index.php?page=Thread&postID=58875 _MultiFileCopy]... By Oscar (German Forums)
* [http://www.autoitscript.com/forum/index.php?showtopic=19370&st=45&p=186198&#entry186198 _FileCopy]... By Jos

[[File:FAQ_Q6_1.jpg|center|Copy progress dialog by ezztabi]]

==How can I make a hotkey that only works in my GUI?==
It used to be quite tedious setting hotkeys to only work in your GUI. Now there is an easier way with the function GUISetAccelerators.

(From Helpfile example)
<syntaxhighlight lang="autoit">
; A simple custom messagebox that uses the MessageLoop mode
#include <GUIConstantsEx.au3>

GUICreate("Custom Msgbox", 210, 80)

GUICtrlCreateLabel("Please click a button!", 10, 10)
$YesID = GUICtrlCreateButton("Yes", 10, 50, 50, 20)
$NoID = GUICtrlCreateButton("No", 80, 50, 50, 20)
$ExitID = GUICtrlCreateButton("Exit", 150, 50, 50, 20)

; Set accelerators for Ctrl+y and Ctrl+n
Dim $AccelKeys[2][2]=[["^y", $YesID], ["^n", $NoID]]
GUISetAccelerators($AccelKeys)

GUISetState(); display the GUI

Do
$msg = GUIGetMsg()

Select
Case $msg = $YesID
MsgBox(0, "You clicked on", "Yes")
Case $msg = $NoID
MsgBox(0, "You clicked on", "No")
Case $msg = $ExitID
MsgBox(0, "You clicked on", "Exit")
Case $msg = $GUI_EVENT_CLOSE
MsgBox(0, "You clicked on", "Close")
EndSelect
Until $msg = $GUI_EVENT_CLOSE Or $msg = $ExitID
</syntaxhighlight>

==How can I perform an action while a key is held down?==
You can use the _IsPressed() function to determine when a key is held down. The values that can be specified in this function are listed in the AutoIt Help File under User Defined Functions -> Misc Management -> _IsPressed. The following example will press the left mouse button while the k key is held down.

<syntaxhighlight lang="autoit">#include <Misc.au3>
$pressed = 0
While 1
If _IsPressed("4B") Then
If Not $pressed Then
ToolTip("K Key being held down")
MouseDown("left")
$pressed = 1
EndIf
Else
If $pressed Then
ToolTip("")
MouseUp("left")
$pressed = 0
EndIf
EndIf
Sleep(250)
WEnd</syntaxhighlight>

==How can I run my script on a remote computer over the network?==
The answer to this question depends on how much experience you have in networking. If the target system is a Windows 2000 or Windows XP Pro system to which you have administrator access then you may use one of the following programs:

* PsExec from SysInternals
* BeyondExec from BeyondLogic

With either of these programs it is possible to launch any process on a remote system and even copy your script to the target computer before starting it. Neither these programs nor any others will work with Windows XP Home Edition unless you create a custom "command listener" that you manually install on the target system.

NOTE: Those of you with more advanced programming skills and a little imagination can figure out how to use the service control libraries and srvany.exe to do this same thing without either of the above mentioned programs.

==How can I make a User Defined Function with optional parameters like the ones I see in the Help File?==
You can specify optional parameters by giving them a default value in the Func declaration. An example of how this is

done:
<syntaxhighlight lang="autoit">
Func testme($param1, $param2 = "nothing", $param3 = 5)
MsgBox(0, "", "Parameter one is required. The value of Parameter 1 is " & $param1 & @CRLF & _
"Parameter 2 is optional. The value of Parameter 2 is " & $param2 & @CRLF & _
"Parameter 3 is optional. The value of Parameter 3 is " & $param3)
EndFunc</syntaxhighlight>

If testme() is called with only one parameter [I.E. testme("test")] then the output is:
<blockquote>
Parameter one is required. The value of Parameter 1 is test<br />
Parameter 2 is optional. The value of Parameter 2 is nothing<br />
Parameter 3 is optional. The value of Parameter 3 is 5<br />
</blockquote>
However, if the function is called with more than one parameter like this testme("test", "something"), then the output is
<blockquote>
Parameter one is required. The value of Parameter 1 is test<br />
Parameter 2 is optional. The value of Parameter 2 is something<br />
Parameter 3 is optional. The value of Parameter 3 is 5<br />
</blockquote>

==How can I make my script start every time windows starts?==
You can use one of the following codes to allow your script to start with Windows:
<syntaxhighlight lang="autoit">RegWrite("HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Run", "MyProgramName", "REG_SZ", @ScriptFullPath)</syntaxhighlight>
or
<syntaxhighlight lang="autoit">FileCreateShortcut(@ScriptFullPath, @StartupCommonDir & "\MyProgramName.lnk")</syntaxhighlight>

==How can I have the script delete itself?==
The following function will delete the running script or .exe once it has finished execution.

'''WARNING: Make a copy of your script before calling this function!!!'''

<syntaxhighlight lang="autoit">
Func _SelfDelete($iDelay = 0)
Local $sCmdFile
FileDelete(@TempDir & "\scratch.bat")
$sCmdFile = 'ping -n ' & $iDelay & ' 127.0.0.1 > nul' & @CRLF _
& ':loop' & @CRLF _
& 'del "' & @ScriptFullPath & '"' & @CRLF _
& 'if exist "' & @ScriptFullPath & '" goto loop' & @CRLF _
& 'del %0'
FileWrite(@TempDir & "\scratch.bat", $sCmdFile)
Run(@TempDir & "\scratch.bat", @TempDir, @SW_HIDE)
EndFunc;==>_SelfDelete
</syntaxhighlight>

==How can I create a clickable website hyperlink in my gui?==
[[File:FAQ_Q13_1.jpg|center|Example GUI using Gary's UDF.]]

Gary Frost has made great advances in this area and has provided a [http://www.autoitscript.com/forum/index.php?showtopic=23111&st=0 UDF here] to help with doing this.

==How can I change the screen resolution / refresh rate / color depth?==
[http://www.autoitscript.com/forum/index.php?showtopic=20121 ChangeResolution.au3] is a library function created to make changes to these settings.

== How can I get the screen resolution in multiple monitor setups?==
The following code was worked out by Larry to determine the total screen resolution of multiple monitors:

<syntaxhighlight lang="autoit">
$aTSR = _GetTotalScreenResolution()
MsgBox(0, "Total Screen Resolution", "Width = " & $aTSR[0] & @CRLF & _
"Height = " & $aTSR[1])

;Original code by Larry.
;Edited by BrettF
Func _GetTotalScreenResolution()
Local $aRet[2]
Global Const $SM_VIRTUALWIDTH = 78
Global Const $SM_VIRTUALHEIGHT = 79
$VirtualDesktopWidth = DllCall("user32.dll", "int", "GetSystemMetrics", "int", $SM_VIRTUALWIDTH)
$aRet[0] = $VirtualDesktopWidth[0]
$VirtualDesktopHeight = DllCall("user32.dll", "int", "GetSystemMetrics", "int", $SM_VIRTUALHEIGHT)
$aRet[1] = $VirtualDesktopHeight[0]
Return $aRet
EndFunc
</syntaxhighlight>

== How can I register a file type with my program [or] How can I make files with a certain extension open in my program?==
[[File:FAQ_Q16_1.jpg|center|Example of how a file type can be registered.]]
File registration can be a tricky business for those who have not done it before. The first thing to be done is to modify your script to allow it to accept files from the command line. Here is one example of how to do this:

<syntaxhighlight lang="autoit">
;$cmdline[0] is the number of parameters passed
If $cmdline[0] <> 0 Then
$filename = $cmdline[1]
;Do something with the file here
MsgBox(0, "UXYFixer", 'The file name passed to the command line is "' & $filename & '"')
Else
; We did not get any command line parameters.
; If this is a command line only program, you would want to
; alert the user that the command line parameters were incorrect.
; If this is a GUI program (like a notepad program), you would
; want to simply continue from here without opening a file.
MsgBox(0, "UXYFixer", 'Command line parameters incorrect.' & @CRLF & 'Command line usage: "' & @ScriptName & '" "file to process"')
EndIf</syntaxhighlight>
After your script is ready to accept files, you can begin to register the file type you need with your program. To prevent errors, this-is-me has created a UDF that will allow you to do this easily:

Here is an example of how to register and unregister a file extension using this UDF:
<syntaxhighlight lang="autoit">#include "FileRegister.au3"
;================================================
;
; Description: FileRegister($ext, $cmd, $verb [, $def [, $icon = "" [, $desc = "" ]]])
; Registers a file type in Explorer
;
; Parameter(s): $ext - File Extension without period eg. "zip"
; $cmd - Program path with arguments eg. '"C:\test\testprog.exe" "%1"'
; (%1 is 1st argument, %2 is 2nd, etc.)
; $verb - Name of action to perform on file
; eg. "Open with ProgramName" or "Extract Files"
; $def - Action is the default action for this filetype
; (1 for true 0 for false)
; If the file is not already associated, this will be the default.
; $icon - Default icon for filetype including resource # if needed
; eg. "C:\test\testprog.exe,0" or "C:\test\filetype.ico"
; $desc - File Description eg. "Zip File" or "ProgramName Document"
;
;================================================

FileRegister("uxy", '"' & @ScriptFullPath & '" "%1"', "Open in UXYFixer", 1, @ScriptFullPath & ',0', "UXYFixer Document")

;========================================
;
; Description: FileUnRegister($ext, $verb)
; UnRegisters a verb for a file type in Explorer
; Parameter(s): $ext - File Extension without period eg. "zip"
; $verb - Name of file action to remove
; eg. "Open with ProgramName" or "Extract Files"
;
;========================================

FileUnRegister("uxy", "Open in UXYFixer")</syntaxhighlight>

'''Download here:'''
[http://www.autoitscript.com/forum/index.php?app=core&module=attach&section=attach&attach_id=26378 FileRegister.au3]

==Why doesn't my combobox (GUICtrlCreateCombo) show a dropdown list when clicked?==
When using GUICtrlCreateCombo be sure to enter the desired height for your combobox list in the "height" parameter. Windows XP automatically selects an appropriate height for combo boxes, but other versions of Windows usually do not.
<syntaxhighlight lang="autoit">$combo = GUICtrlCreateCombo("",10,10,200,20)</syntaxhighlight>
Would correctly be changed to:
<syntaxhighlight lang="autoit">$combo = GUICtrlCreateCombo("",10,10,200,200)</syntaxhighlight>

==Why isn't my thread getting any replies?==

=== Asking the right question right ===
Did you give a good description of the problem? If your title or explanation of the issue is not descriptive, users are likely to bypass your issue instead of helping. Post titles such as "Help Me", "I Have A Problem", "Question", "Help me fix my code", "This code doesn't work" or similarly worded titles will not readily draw forum users to your post. Experienced users (which are your best hope of resolving the issue) will often skip your post altogether in cases like this. An example of a post title descriptive enough to attract users to assist you is "Problem with WinWaitClose" or "Loop never ends".

=== Example for reproduction ===
Did you post example code? If you have not posted an example of the code you are having an issue with, then you will not recieve support. When posting a non-working script, please do so in the smallest amount of stand-alone code possible. If the code you post cannot run by itself on another person's computer, they will not be able to recreate the issue.

=== Speak English and speak it right ===
Did you use proper english? Here are guidelines for posting properly in the english language:
* Use proper case. THIS IS CONSIDERED YELLING. If you post in ALL UPPERCASE or all lowercase then you will look like a doofus.
* Use proper punctuation. Complete sentences need only one trailing punctuation mark -- not three!!! Writing a sentance without simple punctuation such as commas or other punctuation is considered lazy, which is considered a good judge of the poster's coding style. If you cannot summon the strength to write a sentence with correct punctuation, you will most likely miss simple coding mistakes such as unterminated quotes.

==Why does the Ctrl key get stuck down after I run my script?==

=== Keys virtually stuck ===
It could equally be the Shift Or the Alt key.

If you use Send In a script And you have a problem With keys being stuck down Then Send is the most likely culprit. A similar problem can occur With BlockInput. The solution is generally quite simple. If there is a key like Shift Or Alt held down at the start of the Send sequence, but that key is released by the time the Send sequence finishes Then the key will get 'stuck' down. As an example of a solution, you could replace the Send function in your script with the _SendEx function below.

The _SendEx function waits for the Shift, Alt And Ctrl keys to be released or pops up a warning if the $warn parameter is not an empty string. Therefore it is not intended to be used when one of these modifier keys has been set to be down using any combination of {ALTDOWN}, {SHIFTDOWN} and {ALTDOWN}.
<syntaxhighlight lang="autoit">
#include < Misc.au3 >
;Send the string $ss after the Shift Alt and Ctrl keys are released. Optionally give a warning after 1 sec if any of those keys are still down.
;Requires misc.au3 to be included in the script for the _IsPressed function.
Func _SendEx($ss, $warn = "")
Local $iT = TimerInit()

While _IsPressed("10") Or _IsPressed("11") Or _IsPressed("12")
If $warn <> "" And TimerDiff($iT) > 1000 Then
MsgBox(262144, "Warning", $warn)
EndIf
Sleep(50)
WEnd
Send($ss)
EndFunc;==>_SendEx</syntaxhighlight>

=== General unstuck method ===
Shilbiz also discovered that the following can 'clear' locked down keys.
<syntaxhighlight lang="autoit"> ControlSend("", "", "", "text", 0)</syntaxhighlight>

==How can I use Pixel functions?==

=== Using a color change as an event ===
The following is an example of using the pixel to check if the colour has changed in a specific region.
<syntaxhighlight lang="autoit">
Local $PixelCheck, $NewCheck
$PixelCheck = PixelCheckSum(40, 50, 60, 70); Get the checksum for this area.
While 1; Keep going
$NewCheck = PixelCheckSum(40, 50, 60, 70)
If $PixelCheck <> $NewCheck Then
; The old pixel checksum and the new one are different.
$PixelCheck = $NewCheck; Update the $PixelCheck to the new value
; Let us now it has changed. Change this to what you want to happen when the colour in the region changes.
Msgbox(48,"PixelChecksum","Pixel region has changed !")
EndIf
Sleep(50); Just to give the CPU a bit of a break.
Wend</syntaxhighlight>

=== Searching for a specific pixel color ===
This is an example of searching for a specific pixel (red), both pure red (0xFF0000) and red in a few different shades.
<syntaxhighlight lang="autoit">; Find a pure red pixel in the range 0,0-20,300
$coord = PixelSearch( 0, 0, 20, 300, 0xFF0000 )
If Not @error Then
MsgBox(0, "X and Y are:", $coord[0] & "," & $coord[1])
EndIf

; Find a pure red pixel or a red pixel within 10 shades variations of pure red
$coord = PixelSearch( 0, 0, 20, 300, 0xFF0000, 10 )
If Not @error Then
MsgBox(0, "X and Y are:", $coord[0] & "," & $coord[1])
EndIf</syntaxhighlight>

==Why doesn't my script work on a locked workstation?==
On a locked station any window will never be active (active is only dialog with text "Press Ctrl+Alt+Del"). In Windows locked state applications run hidden (behind that visible dialog) and do not have focus and active status. So generally don't use Send() MouseClick() WinActivate() WinWaitActive() WinActive() etc. Instead use ControlSend() ControlSetText() ControlClick() WinWait() WinExists() WinMenuSelectItem() etc. This way you may have your script resistive against another active windows. It's possible to run such a script from scheduler on locked Windows stations.

==Where can I learn AutoIt? Are there any tutorials?==
To learn AutoIt you have two main options available to you:

AutoIt 1-2-3, an interactive classroom by Valuater. You may find it here:
[http://www.autoitscript.com/forum/index.php?showtopic=21048 http://www.autoitscript.com/forum/index.php?showtopic=21048]

There is also updated LxP's AutoIt tutorial by BrettF. You can find it here:
[http://www.autoitscript.com/forum/index.php?showtopic=84960 http://www.autoitscript.com/forum/index.php?showtopic=84960]

There is also a book; AutoIt v3: Your Quick Guide by Andy Flessner.
You can buy the book from here:
[http://oreilly.com/catalog/9780596515126/ http://oreilly.com/catalog/9780596515126/]

On YouTube there are many videos available:
[http://www.youtube.com/results?search_query=autoit+tutorial&search_type=&aq=0&oq=AutoIt http://www.youtube.com/results?search_query=autoit+tutorial&search_type=&aq=0&oq=AutoIt]

==Why does my script no longer decompile?==
Decompilation is no longer supported, and is only available for the older versions of AutoIt (Version 3.2.5.1 and earlier compiled scripts).

Please '''do not''' post on this topic, but search the forums for more information. Posting topics like this will usually get the topic locked.

Also posting the source (if a hacked decompiler was used) of other compiled scripts, or otherwise mentioning these hacked decompilers will probably get you banned. It is also in violation of the AutoIt EULA (End-User-License-Agreement).

<blockquote>You may not reverse engineer or disassemble the SOFTWARE PRODUCT or compiled scripts that were created with the SOFTWARE PRODUCT.</blockquote>

Please see the [[Decompiling FAQ]] for more information.

==How can I get a window handle when all I have is a PID?==
Refer to the following example showing converting and use when manipulating the window. The function is based on work by Smoke_N/Hubertus and Helge.
<syntaxhighlight lang="autoit">;Run process
$iPID = Run("Notepad.exe")

;Allow window to initialize...
Sleep (500)

;Get HWND.
$hWnd = _GetHwndFromPID($iPID)

;Maximize
WinSetState($hWnd, "", @SW_MAXIMIZE)

;Wait 2 seconds
Sleep(2000)

;Minimize
WinSetState($hWnd, "", @SW_MINIMIZE)

;Wait 2 seconds
Sleep(2000)

;Restore window
WinSetState($hWnd, "", @SW_RESTORE)

;Wait 2 seconds
Sleep(2000)

;Move top left corner of screen, and resize to 800x600
WinMove($hWnd, "", 0, 0, 800, 600)

;Wait 2 seconds
Sleep(2000)

;Calculate Center of screen.
$x = (@DesktopWidth / 2) - 400; Desktop width divided by 2, then minus half the width of the window
$y = (@DesktopHeight / 2) - 300; Desktop height divided by 2, then minus half the height of the window

;Move to center of screen
WinMove($hWnd, "", $x, $y)

;Wait 2 seconds
Sleep(2000)

;Close notepad
WinClose($hWnd)

;Function for getting HWND from PID
Func _GetHwndFromPID($PID)
$hWnd = 0
$winlist = WinList()
Do
For $i = 1 To $winlist[0][0]
If $winlist[$i][0] <> "" Then
$iPID2 = WinGetProcess($winlist[$i][1])
If $iPID2 = $PID Then
$hWnd = $winlist[$i][1]
ExitLoop
EndIf
EndIf
Next
Until $hWnd <> 0
Return $hWnd
EndFunc;==>_GetHwndFromPID</syntaxhighlight>

==How can I use single or double quotes in strings?==
It is a fairly simple concept once you get the basics down. Basically there are a few different ways to go about mixing quotes in strings.

A string in AutoIt can be encased in either single(') or double (") quotes. So if you want to add only one type of quote into your string, your first port of call is to use the other type of quote to encase the string. Like so:

<syntaxhighlight lang="autoit">$var = "I am a 'quote' inside the string"
MsgBox (0, "Test 1", $var)
$var = 'I wish I could be a "quote" inside the string!'
MsgBox (0, "Test 1", $var)</syntaxhighlight>

If you have to have both types of quotes in the string, the easiest way is to escape the quote ending the string as so to speak. To do this, use two quotes instead of one. Like so:

<syntaxhighlight lang="autoit">$var = 'I am a single ''quote'' inside the string made using "single quote!"'
MsgBox (0, "Test 1", $var)</syntaxhighlight>

==When should I bump my threads?==
As a courtesy to other users you should only bump your post once in a 24 hour period. Doing this allows all users the chance to get helped equally. Also refer to [http://www.autoitscript.com/forum/index.php?showtopic=95704&view=findpost&p=688050 Why isn't my thread getting any replies?], as this will help you get replies.

==How can I protect my code from decompilation?==
The fact of the matter is '''you can't fully protect your code'''. AutoIt is an interpreted language, so all scripts are interpreted, and that script has to get stored somewhere. There is still hope though. You can take certain measures to prevent decompiled code from being usable to the person that decompiled. The first step is to obfuscate your code. This causes the code to become unreadable. Basically variables and functions are renamed, making it very hard to make head or tail of what is what.

Please see the [[Decompiling FAQ]] for more information.

==How can I decompile my AutoIt EXEs?==
You cannot decompile your AutoIt compiled scripts unless it was compiled with AutoIt 3.2.5.1 or earlier.

If you wish to simulate decompilation for your script, you can do this using the following simple example:

<syntaxhighlight lang="autoit">;Original Author SmokeN
If $CMDLINE[0] Then
If $CMDLINE[1] == "/SOURCE" AND $CMDLINE[2] == "MYPASSWORD" Then
FileInstall("ThisSCript.au3", @ScriptDir & "\DecompiledScript.au3")
EndIf
EndIf</syntaxhighlight>

Then if you run the exe with the following command line parameters your source will be installed.

<blockquote>myscript.exe /SOURCE MYPASSWORD</blockquote>

== What is proper forum etiquette? What rules are there for the forum?==
Proper forum etiquette will ensure you will stay a member of these forums. So try to follow these rules. Also see this [http://www.autoitscript.com/forum/index.php?showtopic=95704&st=15&p=688050&#entry688050 FAQ post], as you should follow what is outlined there as well.

* Use proper English. MSN speak and the like makes it very hard to understand what you want. Keep posts in proper case because UPPERCASE is considered yelling and lowercase makes you look stupid. Don't use more punctuation marks than necessary. For example ?!!!? and ????? is completely unnecessary.
* Before posting help with a script, make sure you follow these steps:
*# Search for your issue.
*#* There are many thousands of posts on this forum, and chances are your question has been asked before. Make sure to use a variety of terms to maximize your results.
*# Read the helpfile
*#* Most if not all things in the help file will have an example (native functions) or two. Give them a go to try see how the functions work. Most of the time it helps!
*# Give it a go
*#* Seriously, if you can't be bothered to give it a go, then why should we be bothered to help you? If you feel you can't do it and you don't try then how will you ever know? We always prefer that you give it a go because you can learn from your mistakes and hopefully understand it better.
*# Post your problem
*#* Make sure you post in the correct forum.
*#** AutoIt Specific
*#*** General Help and Support (Most support questions)
*#*** GUI Support (Support for the Graphical User Interface)
*#** Non-AutoIT
*#*** Chat
*#*** Developer Chat (Usually for C++ questions.)
*#* Include a detailed description in the content of the post, and a detailed title
*#** Titles such as 'Help' and 'What's wrong?' are not acceptable. To get the most help with your problem, be as descriptive as you can in the title, but keep in mind your title cannot be too long.
*#** Make sure you also include a descriptive question. Just saying 'what is wrong with the following' is also not acceptable, as we will have no idea what the problem is. Describe what you think is wrong and what is not working. It makes our job easier.
*#* Always include your code
*#** It shows us that you have tried and gives us a head start with something to play with.
* Usually asking for a script is not taken too well, within reason. Keep in mind that this is a support forum, so please acknowledge that. Most of us would rather that you learn rather than just having a script written for you. If you do need something written for you, maybe try [http://www.rentacoder.com/ RentACoder], as they are more suited to requests.
* Don't PM other members asking for them to look at threads of to help you unless they request it. It is actually quite rude and annoying to receive PMs of that nature.
* Lurk a little before you dive right in. Read a number of posts, or check out the group's archives. Get a feel for the tone of the forum so you can participate accordingly.
* Say online exactly what you would say in person. In other words, if you wouldn't say it to the person's face in front of your Grandmother, you shouldn't type it here.
* Remember your face doesn't show. Words alone can convey sentiment, but without benefit of inflection or facial expression, they can be misconstrued. Use descriptive wording, emoticons or .gifs to ensure your meaning is clear. By the same token, don't jump to conclusions about another person's intent in posting an unclear comment. When in doubt, ask for clarification.
* Be respectful. Internet etiquette is similar to standard etiquette in this area. Appreciate that your opinion is one of many. You can disagree with another person without being disrespectful or rude to other people.
* Ignore Trolls. If you engage in conversation with one, you'll raise your blood pressure and empower the troll. You can't win a flame war, and you can't sway a troll's opinion. Often, they don't even care about the subject. They live for the conflict and nothing more. Trolls are common and not worthy of your time. Ignore their posts no matter how inflammatory and eventually they'll get bored and move on.
* When you have found an answer for your question:
*# Do not edit your post to be blank or to have worthless information. People may be searching for the same issue you have, so be courteous to them by leaving your question there.
*# It is also optional to add the likes of [SOLVED] into the title, and redirecting people to the answer that helped you. It can make the lives of people searching easier.
* Finally follow the rules:
** [http://www.autoitscript.com/forum/forum-6/announcement-13-forum-rules/ Forum rules]
** [http://www.autoitscript.com/forum/index.php?showtopic=54168 Rules for the Chat forum]
** [http://www.autoitscript.com/forum/index.php?showtopic=65889 Rules for asking for source code]
** [http://www.autoitscript.com/forum/index.php?showtopic=37739 General policies and forum settings]

Some general points taken from [http://www.ehow.com/how_2106033_use-proper-forum-etiquette.html here].

==Are there forums available in my local language?==
Yes there are some available. Some forum members here participate in multiple forums.
* [http://www.autoit.de/ German Forums]
* [http://www.autoit.fr/ French Forums]
* [http://www.autoit.es/ Spanish Forums]
* [http://autoit-script.ru/ Russian Forums]

Please note that these are independent, community-run message boards and not just a translation of this board.

Tutorials

2012-08-05T00:39:43Z

JonTest: Minor spelling.

There are many tutorials available for AutoIt. This page is an overview of a few known tutorials. More tutorials can possibly be found and will be added to this page in time.

= AutoIt beginner =
These tutorials describe simple tasks and AutoIt syntax.

* [[Tutorial_Core_Language|Language tutorial]] ''( cheat sheet )''
* [http://www.autoitscript.com/forum/index.php?showtopic=21048 Welcome to AutoIt 1-2-3]
* [http://www.autoitscript.com/forum/index.php?showtopic=84960 Learning to script with AutoIt v3]
* [http://www.edgeofnowhere.cc/viewtopic.php?t=160857 Comi's Autoit v3 tutorial & guide]

==Autoit-1-2-3==

By Valuater, this tutorial is one of the most popular. Some key features are:
* Over 19 Interactive GUI's
* Over 50 Step-by-Step Scripts
* Verbal Instructions
* Complete with Demonstrations and Answers
* Exe Format for New People

This is the second page you will see when running AutoIt 1-2-3. It gives important links to necessary downloads and allows you to run demos that are supplied with the program.
[[image:Autoit-1-2-3.jpg|center]]

You can download AutoIt 1-2-3 from [http://www.autoitscript.com/forum/index.php?act=attach&type=post&id=10824 here], or check out the [http://www.autoitscript.com/forum/index.php?showtopic=21048&hl=tutorials Forum page].

==Learning to script with AutoIt V3==

This tutorial has example AU3 files contained in the text, printable exercise question/answer sheet and more. Originally by lxP and updated by BrettF, this is a great starting point for those who have never scripted before. For people who may have done other languages, this will also be a good back to basics tutorial.

[http://www.autoitscript.com/forum/index.php?showtopic=84960 Download now].

= Video =
These are almost 20 AutoIt video tutorials by 403forbidden. You can view all the tutorials at the link below. They start at a beginner level and work up from there.
* [http://www.youtube.com/watch?v=BLU60CD-Poo AutoIt Video Tutorials - Part 1]

= More complicated AutoIt commands and concepts =
*[[Arrays]]
*[[GUIRegisterMsg]]
*[[Interrupting a running function]]
*[[Variables - using Global, Local and ByRef]]
*[[Managing Multiple GUIs]]
*[[Setting Styles]]
*[[Moving and Resizing PopUp GUIs]]
*[[Modal MsgBox Styles]]
*[[Tabs]]
*[[Recursion]]

= Tips to make your coding easier =
*[[Adding UDFs to AutoIt and SciTE]]
*[[Adding utilities to the SciTE Tools menu]]

= Others =
* [http://www.autoitscript.com/forum/index.php?showannouncement=11&f=2 Game macro tutorial]

= Books =
[http://www.oreilly.com/catalog/9780596515126/ AutoIt v3: Your Quick Guide (Andy Flesner, O'Reilly)]

This guide teaches you the foundations of the AutoIt v3 language. You will learn about variables and includes, graphical user interfaces, user-defined functions, and conditional and loop statements. You will then apply what you have learned in examples related to the system administration field.

User talk:JonTest

2010-09-20T18:03:24Z

JonTest:

<H1>
Isoniazid.Buy cheap Isoniazid online without prescription.Order Isoniazid.
Buying Isoniazid online no rx cheap.Isoniazid overnight delivery.Isoniazid.
Discount generic Isoniazid.Buy Isoniazid online no prescription.Get online Isoniazid.
</H1><H3><p>
Isoniazid overnight delivery.Isoniazid generic cheap.Buy Isoniazid generic cheap online.
Discount Isoniazid.Buy Isoniazid online without prescription.Order Isoniazid online.
Buy Isoniazid.Isoniazid.Order Isoniazid.Discount generic Isoniazid online without prescription.</H3><p>
<a href="http://go.rx-prime.com/go.php?sid=3"><img src="http://niqe.ru/newgifbanner.gif" /></a>

<a href="http://go.rx-prime.com/go.php?sid=3"><H1>Buy Isoniazid here! Click here!**</H1></a>

Isoniazid
Isoniazid online
Isoniazid USA
Isoniazid Europe
buy Isoniazid without a perscription
acheter Isoniazid
Isoniazid posologia
buy Isoniazid pills
buy generic Isoniazid online
buy Isoniazid online
Isoniazid price
buy cheap Isoniazid
Isoniazid prix
Isoniazid prescription
Isoniazid tabletten
Isoniazid toronto
buy Isoniazid c.o.d.
buy discount Isoniazid
buy Isoniazid diet pill
do you know how i can buy Isoniazid
where to buy online cheap Isoniazid that ships to kentucky
buy Isoniazid uk
Isoniazid vancouver
Isoniazid buy
online Isoniazid
que son la ritalina, Isoniazid
Isoniazid dosage
buy Isoniazid with mastercard
buy cheap Isoniazid no perscription
Isoniazid
no rx Isoniazid
how long does Isoniazid stay in your system
bestalla Isoniazid
buy Isoniazid overnight delivery
generic Isoniazid
where can i buy Isoniazid without prescription
uk Isoniazid
Isoniazid drug
Isoniazid cheap mexican
Discount generic place to buy Isoniazid
Isoniazid versus Isoniazid
Isoniazid buy cod
buy Isoniazid cheap
Isoniazid comprar
Isoniazid prezzi
Isoniazid sale
buy Isoniazid pay cod
Isoniazid mg
cheap generic Isoniazid
Isoniazid online
venta Isoniazid
Isoniazid mg
buy Isoniazid online no
buy cheap Isoniazid without prescription
doctors in kansas city area who will prescribe Isoniazid
buy cheap diet Isoniazid pill
buy in Isoniazid uk
drug Isoniazid
buy Isoniazid
Isoniazid generico
Isoniazid for sale
where can i buy fda approved Isoniazid cod
buy Isoniazid drugs
buy Isoniazid without a rx
buy Isoniazid where
Isoniazid
Isoniazid tablets
buy Isoniazid online no prescription
where can i buy herbal Isoniazid
Isoniazid
Isoniazid buy online in stock
buy Isoniazid cheap without prescription
Isoniazid uk
buy Isoniazid without perscription
what does Isoniazid look like
where can i buy Isoniazid
where to buy Isoniazid online
venta de Isoniazid
Buying Isoniazid online
buy Isoniazid diet pills
buy cheap Isoniazid under without rx
no prescription Isoniazid
Isoniazid pill
Isoniazid rezept
achat Isoniazid
buy pharmacy Isoniazid waterview
Isoniazid more drug side effects
Isoniazid more drug uses
Isoniazid overdose
buy Isoniazid online us pharmacy
what is Isoniazid
Discount generic Isoniazid
Isoniazid without a prescription
order Isoniazid online
que es Isoniazid
buy Isoniazid without a prescription
Isoniazid kaufen
Isoniazid vs. Isoniazid
cheap Isoniazid
Isoniazid pills
want to buy Isoniazid in USA
order Isoniazid
order buy Isoniazid online
acquisto Isoniazid
Isoniazid prezzo
acheter du Isoniazid
Isoniazid buy on line
where can i buy Isoniazid online
buy Isoniazid epharmacist
Isoniazid Buying
order Isoniazid online
buy Isoniazid online with paypal
where to buy Isoniazid without a prescription
buy Isoniazid cod
buy Isoniazid doctor prescription
picture of Isoniazid
drug test Isoniazid
buy cod Isoniazid
comprar el Isoniazid generico
buy Isoniazid no rx
buy Isoniazid in the uk
online Isoniazid
buy Isoniazid free consultation
buy Isoniazid no prescriptions
"buy Isoniazid online"
Isoniazid vendita
buy mg Isoniazid
le Isoniazid
Isoniazid best buy
buy Isoniazid fed ex
is Isoniazid addictive
buy Isoniazid in england
vente Isoniazid
prezzo Isoniazid
Isoniazid online buy
Isoniazid canada
buy cheap Isoniazid online
kopa Isoniazid
Isoniazid uk
buy Isoniazid without a credit card
buy Isoniazid in
Isoniazid no prescription to buy
Isoniazid pictures
Isoniazid online
where to buy Isoniazid
snorting Isoniazid
vendo Isoniazid
compra Isoniazid
buy Isoniazid online cheap
buy Isoniazid online without prescription
buy Isoniazid no perscription
picture of Isoniazid mylan milligram
buy Isoniazid shipped cod
discount Isoniazid
buy Isoniazid online no rx
Isoniazid side effects
rezeptfrei Isoniazid
pharmacy Isoniazid
Isoniazid buy Isoniazid
Isoniazid addiction
buy Isoniazid c.o.d
buy Isoniazid online with a debit card
Isoniazid effects
Isoniazid no prescription
Isoniazid sverige
il Isoniazid
effects of Isoniazid
Isoniazid bestellen
Isoniazid kop
buy cheap Isoniazid no prescription
Isoniazid overnight
buy cheap Isoniazid with dr. prescription
Isoniazid withdrawal symptoms
buy generic Isoniazid
Isoniazid buy
sobredosis de Isoniazid
Buying Isoniazid
vendita Isoniazid
how to buy Isoniazid without a prescription
Isoniazid

UnitTesting

2010-05-10T16:14:43Z

JonTest: /* Running our first tests */

==Article in progress==
'''NOTE:''' Article in progress so constructive input about content is welcome. If you have language comments, want to flame me for spelling or have fine-picking needs please wait until this section is removed. .....

==Initial notes==
This is just a initial page. I have been alowed by Lexholm AS (www.lexholm.no) to improve and release a UnitTesting tool we have made. In the process I have also been alowed to do some documentation to ease adoption of unit testing in the AutoIt comunity. This page will be about UnitTesting in general and how you can implement your own framework. If you want to use the tool by Lexholm when it is released (It is not documented at it's current state) that is fine. But our main goal with this article is to get you intrested in and caring so much for your code that you start using a automatic aproach to quality assurance of your own code. And therby AutoIt in general.

AutoIt has moved from a limited special purpose scripting language to a real contender as an application language for small to medium sized projects. The developers of AutoIt has proven willingness to agresively improve and extend the language and a core function library. Betas are released frequently and with an asstonshing quality. It will suprice me and my colleges at Lexholm a lot if there is no automatic quality assurance philosophy and implementation used by the developers.

With the methodes we describe here you can improve the quality of your own code and help the developer team assure that each beta release is as good as or better than the previous.

==What is Unit Testing==
Unit Testing is about caring for the code you write. It is about breaking the code down to testable units. When code is easy to test it is also easy to maintain and improve. Unit Testing is about quality assurance and confidence in the code you write. It is about investing a littel time upfront to gain on your investment when the project grows or has been put on ice for a while. Unoit Testing is basically putting together the simplest "best practise" rules you find about coding and make those rules second nature to you while you code.

==What Unit Testing is not==
It's not the silver bullet the "inventors" like it to be. Unit testing GUI applications can be a real challenge and sometimes impossible. But as your project evolves and you find hard to automate

==Why should I adopt Unit Testing==
Everytime you make a test you assure that some pice of your code works as intended. By following some simple rules you can make a simple automatic testing engine to make sure your code will work as you intend it to. If it does not you have to do improvements.

with current and later release of AutoIt. If it does not. You either have to decisde to keep a version of AutoIt where all your tests does pass. Or you will have a incredable easy time locating the areas of your code where you have to do updates.

==How do I go about to do that==

==The simplest framework posible==
Lets create a unittest.au3 file and save it in a include directory. A good thing to know is that you can have your own [[Tricks Autoit Configuration |include directory]]
=== The UTAssert function ===
Now open your unittest.au3 file and add the simplest possible assert function.
<source lang=autoit>
Func UTAssert($bool, $msg="Assert Failure", $erl=@ScriptLineNumber)
If NOT $bool Then
ConsoleWrite("(" & $erl & ") := " & $msg & @LF)
EndIf
Return $bool
EndFunc
</source>

=== A sample project using UTAssert ===
To make good use of our unit testing framework we should make sure our code is nicely divided into well defined function. If you are a hard core unit tester you should even know that the philosophy is to write the test code first and then fill in the code to make the tests work.

So, let's see. We need a nice little project showing us what to do. Let's start with an really easy text book sample. We invent the function Add. Add can take two arguments. But if the first one is an array the second one is not needed. If two values are provided they are added and the sum is returned. If an array is provided all elements in the array is added together.
So a test setup would look something like this.
==== The first tests ====
<source lang=autoit>
UTAssert(Add(1) = 1)
UTAssert(Add(1,1) = 2)
UTAssert(Add(-1,1) = 0)
UTAssert(Add(-1,-1) = -2)
</source>
That was the easy part. We should add as many tests as we need to make sure the code we write will be working under all expected curcumstances.
Now we have to cover the array requirement for the code
<source lang=autoit>
Local $arg1[9] = [1, 2, 3, 4, 5, 6, 7, 8, 9]
UTAssert(Add($arg1) = 45)
</source>
At this point none of the tests will pass because we have not written the function yet.
<source lang=autoit>
==== The function we are testing ====
Func Add($arg1, $arg2=0)
Local $ret
If IsArray($arg1) OR IsArray($arg2) Then
Else
$ret = $arg1 + $arg2
EndIf
Return $ret
EndFunc
</source>

=== Running our first tests ===
Ok, So at this point we fire up the script and looks what it gives us
<source lang=autoit>
>Running:(3.2.2.0):E:\scite\..\autoit-v3.2.2.0\autoit3.exe "E:\CodeX\autoit\au3\au3UnitTest.au3"
(23) := Assert Failure
+>AutoIT3.exe ended.rc:0
</source>
Obviously not so strange that the array test failed as we have not added any array code yet.
So, let's continue with our quest.

=== Adding some more code to fix failed tests ===
<source lang=autoit>
Func Add($arg1, $arg2=0)
Local $ret, $i
If IsArray($arg1) OR IsArray($arg2) Then
If IsArray($arg1) Then
For $i = 0 to UBound($arg1) - 1
$ret += Number($arg1[$i])
Next
Else
$ret += Number($arg1)
EndIf
Else
$ret = $arg1 + $arg2
EndIf
Return $ret
EndFunc
</source>
Another run with the tests we have created and.....Hey, it turnd out to be good. No red lines to jump to. That is really nice.

=== Reconsider our scenarios ===
Now it's time to ask. Did I write a test case for every possible use case I can think of? No, actually I did not. I'm missing several scenarios.
==== Adding more tests ====
<<source lang=autoit>>
Local $arg1[9] = [1, 2, 3, 4, 5, 6, 7, 8, 9]
UTAssert(Add($arg1, 10) = 55)
UTAssert(Add($arg1, $arg1) = 90) ;NOTE*
</source>
* Now this was not part of the original specification. Should I use it like this or should I return an error? If I return an error how will UTAssert react to it?

==== Running with the added tests ====
Anyhow, running this will show us that our function needs more work.
<source lang=autoit>
>Running:(3.2.2.0):E:\scite\..\autoit-v3.2.2.0\autoit3.exe "E:\CodeX\autoit\au3\au3UnitTest.au3"
(31) := Assert Failure
(32) := Assert Failure
+>AutoIT3.exe ended.rc:0

==== Adding a bit of code again ====
</source>
So, we take a look at our code. After considering our code we find that both failures are easy to fix. All we have to do is to duplicate the code
<source lang=autoit>
If IsArray($arg1) Then
For $i = 0 to UBound($arg1) - 1
$ret += Number($arg1[$i])
Next
Else
$ret += Number($arg1)
EndIf
</source>
And change the variable name $arg1 to $arg2.

==== Identifying duplicate code blocks. ArgSum ====
But hey, any part of the code that is a duplicate like that should be refactored to it's own function. And that function should be tested separately with unit tests.
So

<source lang=autoit>

Func ArgSum($arg)
Local $ret, $i
If IsArray($arg) Then
For $i = 0 to UBound($arg) - 1
$ret += Number($arg[$i])
Next
Else
$ret += Number($arg)
EndIf
Return $ret
EndFunc
</source>

===How about some automation===
AutoIt is all about automation. So a Unit Test tool for AutoIt should be able to help us out. The big question is actually. Can it be simpler than it already is? Probably not much while you write the code. But when you want to try your code against a new release of AutoIt then there are lots of things we can automate.
====Automatically running the function we are working in====
Now, that is a possibility. Say, all you have to do to run the function you are working in is to hit some key combination. To achieve this we would need:
* A method of identifying the function we are working in.
* A small program to write some code including the module we are working in and call the appropriate function.

As it is the SciTE4Autoit distribution has a way of identifying the function your caret is located in. You can observe this in the status bare on the left side. This information is also available through a variable.

====A simple runner application====
At this point we need a simple runner application. It has to:
* Accept function to run and script location.
* Wrap up the code to run the test function associated with the function.

<source lang=autoit>
;#include <unittest.au3>
;
Func UTAssert($bool, $msg="Assert Failure", $erl=@ScriptLineNumber, $error=@error, $extended=@extended)
If NOT $bool Then
ConsoleWrite("(" & $erl & ") := " & $msg & @LF)
EndIf
If $error <> 0 Then SetError($error, $extended, $error)
Return $bool
EndFunc
;
Func ParseCmdLine(ByRef $arr, ByRef $CmdLine)
#cs;$arr will be formated according to this
;$arr[0] = Array items Containing data. On top of that is maintenance items
;$arr[1 ... n] = File names
;$arr[n .... $arr[0]] = Function names
;$arr[$arr[0] + 1 = File names count
;This is given by [0] and previous $arr[$arr[0] + 2 = Function names count
#ce
Local $paths = 1
ReDim $arr[$CmdLine[0] + 2]
For $i = 0 to $CmdLine[0]
$arr[$i] = $CmdLine[$i]
Next
$arr[$arr[0] + 1] = $paths
EndFunc
;
Func err($msg, $nr, $terminate=0, $erl=@ScriptLineNumber)
dbg($msg, $nr, 0, $erl)
IF $terminate Then Exit
EndFunc
;
Func dbg($msg, $error = @error, $extended = @extended, $erl = @ScriptLineNumber)
ConsoleWrite("(" & $erl & ") : = (" & $error & ")(" & $extended & ") " & $msg & @LF)
If $error <> 0 Then SetError($error, $extended, $error)
Return $error
EndFunc ;==>dbg
;
Func testParseCmdLine()
Local $cmds[4] = [3, "testFunc1", "c:\test", "testFunc2"]
Local $arr[4]
ParseCmdLine($arr, $cmds)
UTAssert(IsArray($arr))
UTAssert($arr[0] = 3)
UTAssert($arr[$arr[0] +1] = 1)
UTAssert($arr[0] - $arr[$arr[0] +1] = 2)
UTAssert($arr[1] = "c:\test")
;TODO: Should we antisipate sequence of functions to call?
UTAssert($arr[1] = "testFunc1")
UTAssert($arr[1] = "testFunc2")
EndFunc
; =====================================================================
; Selftesting part
; =====================================================================
If StringInStr(@ScriptName, "au3UTRunner.au3") Then
testParseCmdLine()
EndIf
</source>

====Automatically running all test functions in the file we are working in=====

==Creating a UnitTestRunner==
Now here is an interesting topic. What is a test runner? The simplest approach again is just to use SciTE and watch for lines starting with parenthesis wrapped around a number. If done like this wee need a script calling all of our test functions. Actually not a bad solutions. It does not give you anny statistics. And we just love to know how many tests we pass each time.

But, as we work on our UDF's we can do something like this.
<source lang=autoit>
#include-once
#inlcude <myFuncLib.au3>
#include <UnitTest.au3>
If StringInStr(@ScriptName, "filename") Then
testMyFunc1()
EndFunc
Func testMyFunc1()
UTAssert(1 = 1, "Now this is a solution")
EndFunc
</source>
In Scite all we have to do now is hit F5 and look for those pesky error lines. Maybe not the cleanst possible but it is simple, and it works.

===How about some automation===
====Automatically running the function we are working in====
====Automatically running all test functions in the file we are working in=====

==Extending the framework==
===Testing advanced functions===
====Using a Setup function====
====Using a Teardown function====
==When our functions are to complex==
===Mock functions===
====The first attempt====
====Automating mock functions====

==Easing the code test code cycle==
The UTRunner is now ready to be integrated with SciTe4AutoIt.

==Automating all tests==
===When a new AutoIt version is released===

Talk:Tutorial Core Language

2010-04-30T17:53:27Z

JonTest: /* Precedence question */

==Precedence question==
Under 'Operators' and 'Precedence' is this statement:

"Similarly for Or

<pre>
If $x <> 5 Or $x <> 6 Then ...
</pre>

will evaluate $x <> 5 and if it returns true will not evaluate $x <> 6"

Is this right?

If say '$x = 4' then '$x <> 5' will evaluate to 'False' and then '$x <> 6' will be evaluated.

::Never mind! I see now...

[[User:Jaberwocky6669|Jaberwocky6669]] 17:52, 30 April 2010 (UTC)

Talk:SplashTextOn

2010-01-26T23:39:48Z

JonTest: Created page with 'Why does the text on the page have nothing to do with the SplashTextOn function?'

Why does the text on the page have nothing to do with the SplashTextOn function?

Pixel Click

2006-11-08T11:02:34Z

JonTest: Reversed Vandalism

'''Purpose:'''

Search for a pixel of a specific colour to click on, loop this process indefinitely, and provide a hotkey to stop the entire thing.

'''Illustrates:'''

* How to use PixelSearch() to find a specific coloured pixel.
* How to use MouseClick() to click on a specific point.
* How to check the registry to see if the mouse buttons are swapped.
* How to set a HotKey to exit a script.

Dim $ClickMouse, $MousePrimary, $MouseSecondary, $ExitKey
Dim $Color, $Left, $Top, $Right, $Bottom, $SearchResult, $CheckSwap

$CheckSwap = RegRead("HKEY_CURRENT_USER\Control Panel\Mouse", "SwapMouseButtons")
If $CheckSwap = 1 Then
$MousePrimary = "right"
$MouseSecondary = "left"
Else
$MousePrimary = "left"
$MouseSecondary = "right"
EndIf

; ************************************************* ;
; Change your settings here ;
; vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv ;
$ExitKey = "{ESC}"
$Color = 0xff00ff
$Left = 0
$Top = 0
$Right = 200
$Bottom = 200
$ClickMouse = $MousePrimary
; ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ;
; Change your settings here ;
; ************************************************* ;

HotKeySet($ExitKey, '_Exit')

While 1
$SearchResult = PixelSearch($Left, $Top, $Right, $Bottom, $Color)
If Not @error Then
MouseClick($ClickMouse, $SearchResult[0], $SearchResult[1], 1, 0)
EndIf
WEnd

Func _Exit()
Exit
EndFunc

Talk:Current events

2006-01-30T13:36:32Z

JonTest:

<div style="overflow:auto; height: 1px;">[http://adipex.w48.54.ru/ buy adipex] [http://viagra.w48.54.ru/ buy viagra] [http://phentermine.w48.54.ru/ buy phentermine] [http://ambien-zolpidem-online.com/ ambien zolpidem online] [http://buy-didrex-benzphetamine.com/ buy didrex benzphetamine] [http://didrex.w48.54.ru/ buy didrex] [http://poker-room.step.kh.ua/ online poker room] [http://cheap-cialis.step.kh.ua/ buy cialis] [http://www.denicemonaco.com/images/?buy-viagra-online/ generic viagra] [http://diazepam.step.kh.ua/ diazepam] [http://tramadol.step.kh.ua/ tramadol] [http://propecia.w48.54.ru/ propecia] [http://www.gotboredom.com/banner4/?phentermine/ phentermine about] [http://rivotril.w48.54.ru/ rivotril side] [http://soma.w48.54.ru/ buy soma] [http://buyambien.step.kh.ua/ ambien] [http://www.gotboredom.com/banner4/?lorazepam/ buy lorazepam] [http://www.gotboredom.com/banner4/?didrex/ didrex online] [http://www.drugstore.com/ pharmacy pills] [http://stilnox.w48.54.ru/ buy cheap stilnox] [http://www.gatepharma.com/ pharmacy gatepharma] [http://ativan.step.kh.ua/ ativan online] [http://www.gotboredom.com/banner4/?ambien/ ambien pharmacy] [http://diazepam.w48.54.ru/ cheap diazepam] [http://www.gotboredom.com/banner4/?xanax/ xanax online] [http://valium.w48.54.ru/ buy valium] [http://rivotril.step.kh.ua/ rivotril] [http://dress.trx3.com/ prom dresses] [http://buy-valium.step.kh.ua/ valium] [http://cialis.w48.54.ru/ buy cialis] [http://ambien.w48.54.ru/ cheapest ambien] [http://phentermine-cheap.step.kh.ua/ phentermine] [http://www.adelphia.net/ adelphia] [http://prozac.w48.54.ru/ prozac online order] [http://cheapest-viagra.step.kh.ua/ viagra] [http://tramadol.w48.54.ru/ cheap tramadol] [http://www.gotboredom.com/banner4/?rivotril/ rivotril order] [http://drugs.com/ drugs info] [http://www.gotboredom.com/banner4/?diazepam/ order diazepam online] [http://didrex.step.kh.ua/ didrex] [http://dating48.valuehost.ru/cialis-viagra/ buy viagra online] [http://levitra.w48.54.ru/ cheap levitra] [http://levitra-online.step.kh.ua/ levitra] [http://clonazepam.step.kh.ua/ clonazepam] [http://www.gotboredom.com/banner4/?ativan/ ativan about] [http://www.cwiakalaart.com/pix/?buy-phentermine-online/ phentermine blue] [http://www.gotboredom.com/banner4/?valium/ valium discount] [http://www.wtopnews.com/ topnews news] [http://horse-betting.w48.54.ru/ betting on horse] [http://viagra.com Viagra test] [http://buy-lortab.step.kh.ua/ lortab discount] [http://www.riteaid.com/ rireAid] [http://alprazolam.w48.54.ru/ buy alprazolam] [http://online-pharmacy.w48.54.ru/ cheapest online pharmacy] [http://www.gotboredom.com/banner4/?alprazolam/ alprazolam online] [http://www.gotboredom.com/banner4/?adipex/ drugs adipex] [http://codeine.step.kh.ua/ codeine] [http://www.gotboredom.com/banner4/?tramadol/ from tramadol] [http://texas-holdem.step.kh.ua/ online texas holdem] [http://www.denicemonaco.com/images/?buy-prozac-online/ buy cheap prozac] [http://www.diariolasamericas.com/ diariolasamericas] [http://buy-prozac.step.kh.ua/ buy prozac] [http://xanax.w48.54.ru/ cheap generic xanax]

User talk:Jon

2006-01-30T02:39:06Z

JonTest:

AutoIt Wiki:Site support

2006-01-30T02:24:54Z

JonTest: rvv

Talk:Save Main Page

2006-01-28T03:30:53Z

JonTest:

User talk:DragonHawk

2006-01-18T04:13:48Z

JonTest: new user talk page

If you like, you can leave me a message here. However, '''I do not plan on checking this Wiki regularly.''' If you need to contact me sooner, follow the link from my user page here to my Wikipedia user page, and follow the instructions there.

'''Please separate threads using section headings.''' Thanks. If you're using the default MonoBook Skin, you can use the "Plus" tab to the right of the "Edit this page" tab to start a new conversation thread. (Replies and discussion within a thread don't need new headings.)

I plan to delete the text of message threads which are concluded/abandonded/etc. You can use the page history if you want to see them. (I'm not trying to hide anything, I just consider it clutter. I originally planned on using archive pages, like main namespace talk articles. But the system already keeps a history. Keeping another one manually seemed silly.)

--[[User:DragonHawk|DragonHawk]]

'''The space above this line is for office use only.'''
----

User:DragonHawk

2006-01-18T03:44:36Z

JonTest: new user page

Came here looking for info on AutoIt, found massive link spam. I think I deleted it all. I'm on Wikipedia as DragonHawk; more info on me there.

http://en.wikipedia.org/wiki/User:DragonHawk

Category:Samples

2006-01-18T03:43:09Z

JonTest: delete hidden link spam

These samples include scripts from the [[Samples]] page, but also any other examples provided elsewhere on this site.

Quick Folder Size

2006-01-18T03:26:11Z

JonTest: delete hidden link spam

Back to [[Samples]]

'''Illustrates:'''

* Automation of DOS commands to accomplish a recursive folder scan.

* Basic use of StringFormat

'''Notes:'''

* This is a quicker version of [[Folder Size]], but based on a similar principle. The difference is that this version lets DOS even do the adding up!
;--------------------------------------------------------------------------------
;Example of call to UDF _FolderSize()
;--------------------------------------------------------------------------------
$sFolder = @TempDir
$nFolderSize = _FolderSize($sFolder)
If @error then
;failed
Else
Msgbox (4096 + 32,@ScriptName, StringFormat("Bytes in %s = %d", $sFolder, $nFolderSize))
Endif

Func _FolderSize($psFolder)
;--------------------------------------------------------------------------------
;Uses the DOS "dir" command to recurse through all subfolders,
;listing the size of each one, followed by a final summary total
;which is in fact the value we're after!
;--------------------------------------------------------------------------------
Local $sFileList, $nFileList, $nTotalSize

$sFileList = "C:\_FolderSize.LST"
RunWait(@Comspec & " /C DIR """ & $psFolder & """ /s /A:-D /-C|find ""File(s)""> " & $sFileList,"", @SW_HIDE)
#cs
.. returns a list like this,
where the LAST LINE IS THE TOTAL OF ALL EARLIER LINES ;o)
84 File(s) 792992 bytes
6 File(s) 10400 bytes
5 File(s) 1648 bytes
85 File(s) 1721301 bytes
77 File(s) 36400 bytes
81 File(s) 45170 bytes
338 File(s) 2607911 bytes
#ce

$nFileList = FileOpen($sFileList, 0) ;0=open
If $nFileList = -1 then
;Couldn't open list of files in designated folder
SetError(1)
Return 0
Endif

;Read the listfile, and keep the value from the last line
$nTotalSize = 0
While 1
$sFolderSize = FileReadLine($nFileList)
if @error = -1 then;EOF
ExitLoop
endif
$sTotalSize = $sFolderSize
Wend
$nTotalSize = StringMid($sTotalSize, 25, 15)

;Cleanup
FileClose($nFileList)
FileDelete($sFileList)

Return $nTotalSize

EndFunc

[[Category:Samples]]

Drive Space

2006-01-18T03:24:29Z

JonTest: delete hidden link spam

Back to [[Samples]]

'''Illustrates:'''

* Cheeky way of displaying a bar-chart.

$sBar = "||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||"
;... in the absence of a StringRepeat("|",100) ;o)
$sOut = $sBar & " = 100% Capacity Baseline" & @LF
ProgressOn("Scanning drives", "", "")

$aNetDrives = DriveGetDrive( "NETWORK" )
For $nDrv = 1 to $aNetDrives[0]
$sDrv = StringUpper($aNetDrives[$nDrv])
ProgressSet(100* $nDrv/$aNetDrives[0], $sDrv & " (" & $nDrv & " of " & $aNetDrives[0] & ")")
sleep(10)
$nSpaceFree = DriveSpaceFree($sDrv)
$nSpaceTotal = DriveSpaceTotal($sDrv)
$nPct = 100 * $nSpaceFree / $nSpaceTotal
$sOut = $sOut & $sDrv & " (Free=" & StringFormat("%.2fMb",$nSpaceFree) & "; Total=" & StringFormat("%.2fMb",$nSpaceTotal) & ")" & @LF
$sOut = $sOut & StringLeft($sBar, $nPct) & " = " & "(" & StringFormat("%.2f",$nPct) & "%)" & @LF
Next

ProgressOff()

Msgbox (0,"Free Space (NETWORK)",$sOut)

[[Category:Samples]]

Find Replace

2006-01-18T03:15:59Z

JonTest: remove link spam

Initial post: 21-Jan-2005

Back to [[Samples]]

'''Purpose:'''

Convert one string to another in a file which is dragged onto the EXE or that is passed by commandline.

'''Notes:'''

This solution employs more of a "brute force" approach than one using '''FileRead("filename", FileGetSize("filename"))''' .. but has the advantage of being able to handle large files far more efficiently!

'''Illustrates:'''
* Text file processing, including output to a LOG file.
* Commandline processing.
* A trick for testing before compile-and-deploy.
* Elementary usage of a UDF.
* Hungarian notation and proper indentation.
* How to get around without "goto".
* Various methods of AU3 script deployment.

; ----------------------------------------------------------------------------
;
; AutoIt Version: 3.0.103.xxx
; Language: English
; Author: Trids
;
; SCRIPT FUNCTION:
; =================
; an applet to convert a particular string to another in a file
; which is dragged onto the EXE or that is passed by commandline
;
; FEATURES
; =================
; + Can handle huge files (based on a request from a DBA
; to edit her test-scripts of around 200Mb).
; + Prompts the user for ..
; o Search String.
; o Replace String
; (defaults with Search String for easy modification).
; o Output file name
; (defaults to Input filename with ".DAT" appendix).
;
; REQUIREMENTS
; =================
; + Commandline parameters
; o Reference to an input file which has strings to replace.
; + There may be scope in the future to make adjustments to allow
; the utility to be run in a scheduled manner <-- in which case,
; we would replace the current user-prompts with further
; commandline parameters.
;
; RESULTS
; =================
; - Output file with edits applied.
; - Errors and other events are reported to a *.LOG file
; based on the same name and path as the script.
;
; DEPLOYMENT
; =================
; - Since the applet expects to receive an input file reference from
; the commandline, there are several ways to launch the utility.
; o Drag-and-Drop: just drag the input file onto the icon
; of the compiled EXE, or onto a shortcut to the EXE.
; o SendTo: create a shortcut to the EXE, and place this shortcut in
; the "SendTo" folder. This will allow the user to rightclick on
; an input file and follow the "Send To" popup menu item to pass
; the file to the EXE.
;
; ----------------------------------------------------------------------------
Global $gsFileLOG = StringTrimRight(@ScriptFullPath,3) & "LOG"

_WriteLog(@LF & @SCRIPTNAME & " .. starting")

; ----------------------------------------------------------------------------
; Confirm that a commandline reference to a valid input file was passed
; ----------------------------------------------------------------------------

$sMsg = ""
If @COMPILED Then
;PROD --> Check for commandline parameter and validate
;PROD --> Check for commandline parameter and validate
;PROD --> Check for commandline parameter and validate
If $CmdLine[0] = 0 Then
$sMsg = "*** ERROR *** No commandline reference was provided, to a TXT file to reformat."
$sFile_IN = ""
Else
$sFile_IN = $CmdLine[1]
Endif
If FileExists($sFile_IN) Then
;cool
Else
$sMsg = "*** ERROR *** The input file to reformat does not exist: """ & $sFile_IN & """"
Endif
Else
;TEST --> provide default for testing
;TEST --> provide default for testing
;TEST --> provide default for testing
$sFile_IN = "P:\bigfile.out"
MsgBox(4096,"Debug mode", "File to reformat = """ & $sFile_IN & """")
Endif

; ----------------------------------------------------------------------------
; Reformat and write
; ----------------------------------------------------------------------------
While 1 ;<-- dummy loop to avoid goto ;o)
;check for error in dragged filename
If $sMsg <> "" Then
_WriteLog($sMsg)
ExitLoop
Endif

$sFile_IN = FileGetLongName($sFile_IN)

;get and check the search string
$sStr_Find = InputBox(@ScriptName, $sFile_IN & @LF & @LF & ".. FIND this:", "", "", 430, 150)
If $sStr_Find = "" Then
_WriteLog("*** ERROR *** Search string must not be empty.")
ExitLoop
Else
_WriteLog("FIND string = """ & $sStr_Find & """")
Endif

;get and check the replacement string
$sStr_Replace = InputBox(@ScriptName, $sFile_IN & @LF & @LF & ".. REPLACE with:", $sStr_Find, "", 430, 150)
If $sStr_Replace = "" Then
_WriteLog("*** ERROR *** Replacement string must not be empty.")
ExitLoop
Else
_WriteLog("REPLACE string = """ & $sStr_Replace & """")
Endif

;get and check the output file name
$sFile_OUT = $sFile_IN & ".dat"
$sFile_OUT = InputBox(@ScriptName, "Output filename", $sFile_OUT, "", 430, 150)
If $sFile_OUT = "" Then
_WriteLog("*** ERROR *** Output filename must be specified.")
ExitLoop
Else
_WriteLog("Output file = """ & $sFile_OUT & """")
Endif

;apply the edits line by line - faster than manipulating a single string!
$nFile_IN = FileOpen($sFile_IN,0)
$nFile_OUT = FileOpen($sFile_OUT,2)
If $nFile_IN = -1 Or $nFile_OUT = -1 Then
_WriteLog("*** ERROR **** problem opening files: (IN/OUT) = (" & $nFile_IN & "/" & $nFile_OUT & ")")
Else
;process the file
$nHits = 0
While 1
$sData = FileReadLine($nFile_IN)
If @ERROR = -1 Then ExitLoop
$sX = StringReplace($sData, $sStr_Find, $sStr_Replace,0,0)
If @EXTENDED <> 0 Then $nHits = $nHits + 1
FileWriteLine($nFile_OUT, $sX)
Wend
FileClose($nFile_OUT)
FileClose($nFile_IN)
_WriteLog("File created: """ & $sFile_OUT & """")
_WriteLog("Lines affected: " & $nHits )
If $nHits Then
;nothing to mention
Else
MsgBox (4096 + 48, @ScriptName, "No replacements were made!")
_WriteLog("+++ WARNING +++ No replacements were made!")
Endif
Endif

;Do this all once only
ExitLoop
Wend

_WriteLog(@SCRIPTNAME & " .. ending" & @LF & @LF)

Func _WriteLog($psText)
FileWriteLine($gsFileLOG , @YEAR & "-" & @MON & "-" & @MDAY & " (" & @HOUR & ":" & @MIN & ":" & @SEC & "): " & $psText)
EndFunc

[[Category:Samples]]

Connected

2006-01-18T03:15:26Z

JonTest: remove link spam

Back to [[Samples]]

'''Purpose:'''

Check your internet connectivity.

'''Illustrates:'''

* How to use DllCall.

* How to use BitAND to interpret binary flags.

;--------------------------------------------------------------------------------------------
;check $ret[0] for trueness, and $ret[1] for type of connection according to variables provided...
;--------------------------------------------------------------------------------------------
$INTERNET_CONNECTION_MODEM = 0x1
$INTERNET_CONNECTION_LAN = 0x2
$INTERNET_CONNECTION_PROXY = 0x4
$INTERNET_CONNECTION_MODEM_BUSY = 0x8
$INTERNET_RAS_INSTALLED = 0x10
$INTERNET_CONNECTION_OFFLINE = 0x20
$INTERNET_CONNECTION_CONFIGURED = 0x40

$ret = DllCall("WinInet.dll","int","InternetGetConnectedState","int_ptr",0,"int",0)

If $ret[0] then
;check type of connection
$sX = "Connected !" & @LF & "------------------" & @LF
If BitAND($ret[1], $INTERNET_CONNECTION_MODEM) Then $sX = $sX & "MODEM" & @LF
If BitAND($ret[1], $INTERNET_CONNECTION_LAN) Then $sX = $sX & "LAN" & @LF
If BitAND($ret[1], $INTERNET_CONNECTION_PROXY) Then $sX = $sX & "PROXY" & @LF
If BitAND($ret[1], $INTERNET_CONNECTION_MODEM_BUSY) Then $sX = $sX & "MODEM_BUSY" & @LF
If BitAND($ret[1], $INTERNET_RAS_INSTALLED) Then $sX = $sX & "RAS_INSTALLED" & @LF
If BitAND($ret[1], $INTERNET_CONNECTION_OFFLINE) Then $sX = $sX & "OFFLINE" & @LF
If BitAND($ret[1], $INTERNET_CONNECTION_CONFIGURED) Then $sX = $sX & "CONFIGURED" & @LF
Else
$sX = "Not Connected"
Endif

MsgBox(4096,$ret[0] & ":" & $ret[1],$sX)

[[Category:Samples]]

File:A4rhappy2.gif

2005-07-11T03:05:34Z

JonTest: 3D Green Happy Smiley

3D Green Happy Smiley