UDF > IE >

_IEFormElementRadioSelect

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

#include <IE.au3>
_IEFormElementRadioSelect ( ByRef $oObject, $sString, $sName [, $iSelect = 1 [, $sMode = "byValue" [, $iFireEvent = 1]]] )

Paramètres

$oObject Variable objet InternetExplorer.Application, objet Form
$sString Valeur utilisée pour déterminer l'élément - traitement selon $sMode
$sName Nom ou ID du Radio Group
$iSelect [optionnel] Spécifie si l'élément doit être sélectionné ou pas:
    -1 = Retourne l'état de​ssélection
    0 = Désélectionne l'élément
    1 = (par défaut) Sélectionne l'élément
$sMode [optionnel] Spécifie le mode de recherche:
    "byValue" = (par défaut) valeur du radio que vous souhaitez sélectionner
    "byIndex" = index, à partir de 0, du radio que vous souhaitez sélectionner
$iFireEvent [optionnel] Indique s'il faut déclencher les événements OnChange et OnClick après avoir changé la valeur:
    0 = ne pas déclencher les événements OnChange ou OnClick après avoir changé la valeur
    1 = (par défaut) Déclenche les événements OnChange et OnClick après avoir changé la valeur

Valeur de retour

Succès: Retourne l'état actuel de la sélection si $iSelect = -1, sinon retourne 1.
Échec: Retourne 0 et définit @error <> 0.
@error: 3 ($_IEStatus_InvalidDataType) - Type de donnée inlide
4 ($_IEStatus_InvalidObjectType) - Type d'objet invalide
5 ($_IEStatus_InvalidValue) - Valeur invalide
7 ($_IEStatus_NoMatch) - Pas de correspondance trouvée
@extended: Contient le nombre de paramètres invalides

Remarques

Le paramètre $iFireEvent est significatif seulement si l'élément de formulaire a un événement onChange associé.

$sName est un paramètre obligatoire pour cette fonction.
Les boutons radio sont définis dans des groupes qui partagent le même nom.
Pas plus d'un élément au sein d'un groupe peut être sélectionné à un moment donné - quand un élément est sélectionné, tous les autres sont désactivées.

En relation

_IEFormElementCheckBoxSelect, _IEFormElementGetValue, _IEFormElementOptionSelect, _IEFormElementSetValue

Exemple

Exemple 1

; Ouvre un navigateur avec l'exemple de formulaire, obtient une référence sur le formulaire, sélectionne
; chaque bouton radio byValue, puis désélectionne le dernier élément, n'en laissant aucun sélectionné.

#include <IE.au3>

Local $oIE = _IE_Example("form")
Local $oForm = _IEFormGetObjByName($oIE, "ExampleForm")
_IEAction($oForm, "focus")
For $i = 1 To 3
    _IEFormElementRadioSelect($oForm, "vehicleAirplane", "radioExample", 1, "byValue")
    Sleep(1000)
    _IEFormElementRadioSelect($oForm, "vehicleTrain", "radioExample", 1, "byValue")
    Sleep(1000)
    _IEFormElementRadioSelect($oForm, "vehicleBoat", "radioExample", 1, "byValue")
    Sleep(1000)
    _IEFormElementRadioSelect($oForm, "vehicleCar", "radioExample", 1, "byValue")
    Sleep(1000)
    _IEFormElementRadioSelect($oForm, "vehicleCar", "radioExample", 0, "byValue")
    Sleep(1000)
Next

_IEQuit($oIE)

Exemple 2

; Ouvre un navigateur avec l'exemple de formulaire, obtient une référence sur le formulaire, sélectionne
; chaque bouton radio byIndex, puis désélectionne le dernier élément, n'en laissant aucun sélectionné.
; Remarque: Vous aurez probablement besoin de faire défiler la page pour voir les changements

#include <IE.au3>

Local $oIE = _IE_Example("form")
Local $oForm = _IEFormGetObjByName($oIE, "ExampleForm")
For $i = 1 To 3
    _IEFormElementRadioSelect($oForm, 3, "radioExample", 1, "byIndex")
    Sleep(1000)
    _IEFormElementRadioSelect($oForm, 2, "radioExample", 1, "byIndex")
    Sleep(1000)
    _IEFormElementRadioSelect($oForm, 1, "radioExample", 1, "byIndex")
    Sleep(1000)
    _IEFormElementRadioSelect($oForm, 0, "radioExample", 1, "byIndex")
    Sleep(1000)
    _IEFormElementRadioSelect($oForm, 0, "radioExample", 0, "byIndex")
    Sleep(1000)
Next

_IEQuit($oIE)