UDF > IE >


_IEFormElementSetValue

D�finit la valeur d'un �l�ment donn� de formulaire

#include <IE.au3>
_IEFormElementSetValue ( ByRef $oObject, $sNewValue [, $iFireEvent = 1] )

Param�tres

$oObject Variable objet InternetExplorer.Application, objet Form Element
$sNewValue La nouvelle valeur � installer dans l'�l�ment de formulaire
$iFireEvent [optionnel] Indique s'il faut d�clencher un �v�nement OnChange apr�s avoir chang� la valeur
    0 = Ne d�clenche pas l'�v�nement OnChange ou OnClick apr�s avoir chang� la valeur
    1 = (par d�faut) D�clenche l'�v�nement OnChange et OnClick apr�s avoir chang� la valeur

Valeur de retour

Succ�s: Retourne 1.
�chec: Retourne 0 et d�finit @error <> 0.
@error: 2 ($_IEStatus_COMError) - Erreur COM dans la r�f�rence d'objet
3 ($_IEStatus_InvalidDataType) - Type de donn�e invalide
4 ($_IEStatus_InvalidObjectType) - Type d'objet invalide
@extended: Contient le nombre de param�tres invalides

Remarques

Alors que tous les �l�ments de formulaire ont une valeur, seuls les �l�ments orient�s texte utilisent leur attribut valeur de fa�on �vidente (type texte, textarea, hidden, password et file).
La valeur des autres �l�ments de formulaire n'affecte pas ce qui est affich� dans l'interface utilisateur, mais plut�t la valeur qui est retourn�e par l'�l�ment lorsqu'il est s�lectionn� ou activ�.

Voir _IEFormElementOptionSelect(), _IEFormElementCheckBoxSelect(), _IEFormElementRadioSelect() et _IEFormImageClick() pour plus d'informations.

Remarque: Vous ne pouvez pas utiliser _IEFormElementSetValue() pour d�finir la valeur d'un �l�ment INPUT TYPE=FILE. Les restrictions de s�curit� du navigateur emp�chent cet �l�ment d'�tre modifi� par script. Voir l'exemple ci-dessous pour une solution de contournement.

En relation

_IEFormElementCheckBoxSelect, _IEFormElementGetCollection, _IEFormElementGetObjByName, _IEFormElementGetValue, _IEFormElementOptionSelect, _IEFormElementRadioSelect

Exemple

Exemple 1

; Ouvre un navigateur avec l'exemple de formulaire, d�finit la valeur d'un �l�ment texte du formulaire

#include <IE.au3>

Local $oIE = _IE_Example("form")
Local $oForm = _IEFormGetObjByName($oIE, "ExampleForm")
Local $oText = _IEFormElementGetObjByName($oForm, "textExample")
_IEFormElementSetValue($oText, "Hey! This works!")

Exemple 2

; Obtient une r�f�rence sur un �l�ment sp�cifique du formulaire et d�finit sa valeur.
; Dans ce cas, soumet une requ�te au moteur de recherche  Google

#include <IE.au3>

Local $oIE = _IECreate("http://www.google.com")
Local $oForm = _IEFormGetCollection($oIE, 0)
Local $oQuery = _IEFormElementGetCollection($oForm, 4)
_IEFormElementSetValue($oQuery, "AutoIt IE.au3")
_IEFormSubmit($oForm)

Exemple 3

; D�finit la valeur d'un �l�ment INPUT TYPE=TEXT en utilisant Send()

#include <IE.au3>

Local $oIE = _IE_Example("form")
Local $oForm = _IEFormGetObjByName($oIE, "ExampleForm")
Local $oInputFile = _IEFormElementGetObjByName($oForm, "textExample")

; Assigne le focus d'entr�e au champ puis envoie la cha�ne texte
_IEAction($oInputFile,  "focus")

; S�lectionne le contenu existant de sorte qu'il sera ...
�cras�.
_IEAction($oInputFile, "selectall")

Send("This works")

Exemple 4

; D�finit la valeur d'un �l�ment INPUT TYPE=TEXT en une fen�tre invisible
; en utilisant ControlSend()

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

Local $oIE = _IE_Example("form")

; Cache la fen�tre du navigateur pour montrer l'envoi du texte dans la fen�tre invisible
_IEAction($oIE, "invisible")

Local $oForm = _IEFormGetObjByName($oIE, "ExampleForm")
Local $oInputFile = _IEFormElementGetObjByName($oForm, "textExample")

; Assigne le focus d'entr�e au champ puis envoie la cha�ne texte
_IEAction($oInputFile, "focus")

; S�lectionne le contenu existant de sorte qu'il sera ...
�cras�.
_IEAction($oInputFile, "selectall")

; Obtient un handle de la fen�tre IE.
Local $hIE = _IEPropertyGet($oIE, "hwnd")
ControlSend($hIE, "", "[CLASS:Internet Explorer_Server; INSTANCE:1]", "This works")

_IEAction($oIE, "visible")
MsgBox($MB_SYSTEMMODAL, "Success", "Value set to 'This works'")