UDF > IE >


_IEFormGetObjByName

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

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

Paramètres

$oObject Variable objet InternetExplorer.Application, Window ou Frame
$sName Indique le nom du formulaire dont vous souhaitez la référence
$iIndex [optionnel] Si le nom du formulaire apparait plus d'une fois, spécifie l'occurrence par son index, à partir de 0
    0 (par défaut) ou entier positif retourne une occurrence indexée
    -1 Retourne une collection des formulaires

Valeur de retour

Succès: Retourne une variable objet pointant vers l'objet Form, @extended = nombre de formulaires.
É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

Si le formulaire désiré n'a pas de nom ou d'ID, utilisez _IEFormGetCollection() pour obtenir une référence par index.

En relation

_IEFormGetCollection, _IEFormReset, _IEFormSubmit

Exemple

; Obtient une référence sur un formulaire donné par son nom.  Dans ce cas, soumet une requête
; au moteur de recherche Google.  Notez que les noms du formulaire et des éléments du formulaire
; peuvent être trouvés en visualisant la page HTML source

#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)