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)