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)