# Function Reference

# _IETagNameGetCollection

Returns a collection object of all elements in the object with the specified TagName or a single element by index

#include <IE.au3>
_IETagNameGetCollection ( ByRef $oObject, $sTagName [, $iIndex = -1] )

## Parameters

$oObject | Object variable of an InternetExplorer.Application, Window, Frame, iFrame or any object in the DOM
$sTagName | TagName of collection to return (e.g. IMG, TR etc.)
$iIndex | [optional] specifies whether to return a collection or indexed instance 0 or positive integer returns an indexed instance -1 = (Default) returns a collection

## Return Value

Success: | an object variable containing the specified Tag collection, @extended = specified Tag count.
Failure: | sets the @error flag to non-zero.
@error: | 3 ($_IEStatus_InvalidDataType) - Invalid Data Type 4 ($_IEStatus_InvalidObjectType) - Invalid Object Type 5 ($_IEStatus_InvalidValue) - Invalid Value 7 ($_IEStatus_NoMatch) - No Match
@extended: | Contains invalid parameter number

## Remarks

The DOM is hierarchical, so if the object passed is the document object, the specified elements in the document are returned.
If the object passed is an object inside the document (e.g. a TABLE object), then only the specified elements inside that object are returned.

## Related

_IETagNameAllGetCollection

## Example

    ; Open a browser with the form example, get the collection
    ; of all INPUT tags and display the formname and type of each

    #include <IE.au3>
    #include <MsgBoxConstants.au3>

    Local $oIE = _IE_Example("form")
    Local $oInputs = _IETagNameGetCollection($oIE, "input")
    Local $sTxt = ""
    For $oInput In $oInputs
        $sTxt &= $oInput.type & @CRLF
    Next
    MsgBox($MB_SYSTEMMODAL, "Form Input Type", "Form: " & $oInput.form.name & @CRLF & @CRLF & "         Types :" & @CRLF & $sTxt)

    _IEQuit($oIE)