UDF > IE >


_IEGetObjByName

Retourne une variable objet donné par son nom

#include <IE.au3>
_IEGetObjByName ( ByRef $oObject, $sName [, $iIndex = 0] )

Paramètres

$oObject Variable objet InternetExplorer.Application, Window ou Frame
$sName Indique le nom de l'objet que vous souhaitez chercher
$iIndex [optionnel] Si le nom apparaît plusieurs fois, précise l'index, à partir de 0 de l'occurrence
    0 (par défaut) ou entier positif pour retourner l'occurrence indexée
    -1 pour retourner une collection des objets spécifiés

Valeur de retour

Succès: Retourne une variable objet pointant sur l'Object spécifié, @extended = nombre d'objets.
Échec: Définit @error <> 0.
@error: 3 ($_IEStatus_InvalidDataType) - Type de donnée invalide
7 ($_IEStatus_NoMatch) - Pas de correspondance trouvée
@extended: Contient le nombre de paramètres invalides

Remarque

Cette fonction retourne une référence d'objet sur n'importe quel objet du document qui a le nom ou l'ID spécifié.
Les éléments DOM peuvent avoir les attributs Name ou ID ou les deux.
Un ID spécifique ne peut être affecté qu'à un seul élément alors qu'un nom spécifique peut être attribué à plusieurs éléments.
Dans Internet Explorer, les espaces de noms Name et ID sont partagés.

En relation

_IEGetObjById

Exemple

; Ouvre une instance du navigateur avec le formulaire exemple, obtient une référence d'object sur
; l'élément de nom "ExampleForm".  Dans ce cas
; le résultat est identique à l'utilisation de $oForm = _IEFormGetObjByName($oIE, "ExampleForm")

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

Local $oIE = _IE_Example("form")
Local $oForm = _IEGetObjByName($oIE, "ExampleForm")
MsgBox($MB_SYSTEMMODAL, "ExampleForm", _IEPropertyGet($oForm, "innertext") & @CRLF)