UDF > IE >


_IEFormElementGetObjByName

Retourne une référence d'objet sur un élément de formulaire donné par son nom

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

Paramètres

$oObject Variable objet InternetExplorer.Application, objet Form
$sName Représente le nom de l'élément de formulaire qui vous intéresse
$iIndex [optionnel] Si le nom de l'élément du formulaire apparait plus d'une fois, spécifie l'occurrence par un index à partir de 0
    0 (par défaut) ou un entier positif retourne une occurrence indexée
    -1 retourne une collection des éléments du formulaire spécifié

Valeur de retour

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

Remarque

Si l'élément désiré de formulaire n'a pas de nom ou d'ID, _IEFormElementGetCollection() permet d'obtenir une référence par index.

En relation

_IEFormElementGetCollection, _IEFormElementGetValue, _IEFormElementSetValue, _IEFormSubmit

Exemple

; Obtient une référence sur un élément de formulaire par nom.
; Dans ce cas, soumet une requête au moteur de recherche  Google

#include <IE.au3>

Local $oIE = _IECreate("http://www.google.com")
Local $oForm = _IEFormGetObjByName($oIE, "gbqf")
Local $oQuery = _IEFormElementGetObjByName($oForm, "q")
_IEFormElementSetValue($oQuery, "AutoIt IE.au3")
_IEFormSubmit($oForm)