Function Reference


Simulate a mouse click on an image. Match by sub-string match of alt text, name, or src

#include <IE.au3>
_IEImgClick ( ByRef $oObject, $sLinkText [, $sMode = "src" [, $iIndex = 0 [, $iWait = 1]]] )


$oObject Object variable of an InternetExplorer.Application, Window or Frame object
$sLinkText Text to match the content of the attribute specified in $sMode
$sMode [optional] specifies search mode
    "src" = (Default) match the url of the image
    "id" = match the id of the image (see remarks)
    "alt" = match the alternate text of the image
$iIndex [optional] If the img text occurs more than once, specify which instance you want by 0-based index
$iWait [optional] specifies whether to wait for page to load before returning
    0 = Return immediately, not waiting for page to load
    1 = (Default) Wait for page load to complete before returning

Return Value

Success: None.
Failure: 0 or -1 and sets the @error flag to non-zero.
@error: 1 ($_IEStatus_GeneralError) - General Error
2 ($_IEStatus_COMError) - COM Error in Object reference
3 ($_IEStatus_InvalidDataType) - Invalid Data Type
4 ($_IEStatus_InvalidObjectType) - Invalid Object Type
5 ($_IEStatus_InvalidValue) - Invalid Value
6 ($_IEStatus_LoadWaitTimeout) - Load Wait Timeout
7 ($_IEStatus_NoMatch) - No Match
8 ($_IEStatus_AccessIsDenied) - Access Is Denied
9 ($_IEStatus_ClientDisconnected) - Client Disconnected
@extended: Contains invalid parameter number


"name" is no more supported when using HTLM5 but still accepted and equivalent to "id" for HTML5 pages.


_IEFormImageClick, _IEImgGetCollection, _IELoadWait


Example 1

; Click on IMG by Alt text

#include <IE.au3>

Local $oIE = _IE_Example("basic")
_IEImgClick($oIE, "AutoIt Homepage Image", "alt")

Example 2

; Click on IMG by id

#include <IE.au3>

Local $oIE = _IE_Example("basic")
_IEImgClick($oIE, "AutoItImage", "id") ; "name" is still equivalent for HTML5 pages

Example 3

; Click on IMG by src sub-string

#include <IE.au3>

Local $oIE = _IE_Example("basic")
_IEImgClick($oIE, "autoit_6_240x100.jpg", "src")

Example 4

; Click on IMG by full src string

#include <IE.au3>

Local $oIE = _IE_Example("basic")
_IEImgClick($oIE, "")