Retourne l'objet collection de tous les éléments de l'objet défini par son TagName ou un élément unique défini par son index
#include <IE.au3>
_IETagNameGetCollection ( ByRef $oObject, $sTagName [, $iIndex = -1] )
| $oObject | Variable objet InternetExplorer.Application, Window, Frame, iFrame ou tout autre objet DOM |
| $sTagName | TagName de la collection à retourner (par exemple, IMG, TR etc..) |
| $iIndex | strong>[optionnel] Spécifie s'il faut retourner une collection ou une instance définie par son index 0 ou un entier positif = index de l'instance à retourner -1 = (Par défaut) retourne une collection |
| Succès: | Retourne une variable objet contenant la collection Tag spécifié, @extended = nombre de Tags. |
| Échec: | Définit @error <> 0. |
| @error: | 3 ($_IEStatus_InvalidDataType) - Type de donnée unvalide 4 ($_IEStatus_InvalidObjectType) - Type d'objet invalide 5 ($_IEStatus_InvalidValue) - Valeur invalide 7 ($_IEStatus_NoMatch) - Pas de correspondance trouvée |
| @extended: | Contient le nombre de paramètres invalides |
Le DOM est hiérarchique, aussi si l'objet passé est l'objet document, les éléments spécifiés dans le document sont retournés.
Si l'objet passé est un objet à l'intérieur du document (par exemple un objet Table), alors uniquement les éléments spécifiés à l'intérieur de cet objet sont retournés.
; Ouvre une instance du navigateur avec l'exemple formulaire, obtient la collection ; de toutes les balises INPUT et affiche le nom du formulaire et le type chaque #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)