UDF > IE >


_IEPropertyGet

Retourne la valeur d'une propriété donnée du navigateur ou d'un élément DOM

#include <IE.au3>
_IEPropertyGet ( ByRef $oObject, $sProperty )

Paramètres

$oObject Variable objet InternetExplorer.Application ou élément DOM
$sProperty Choix de la propriété (voir Remarques)

Valeur de retour

Succès: Retourne la valeur de la propriété sélectionnée.
Échec: Retourne 0 et définit @error <> 0.
@error: 3 ($_IEStatus_InvalidDataType) - Type de donnée invalide
4 ($_IEStatus_InvalidObjectType) - Type d'objet invalide
5 ($_IEStatus_InvalidValue) - Valeur invalide
@extended: Contient le nombre de paramètres invalides

Remarques

Les tableaux suivants donnent une description de chaque propriété disponible.
Certaines propriétés concernent les éléments DOM, d'autres le navigateur.

Propriétés du navigateur

Propriété Description
"addressbar" Récupère une valeur booléenne indiquant si la barre d'adresse du navigateur est visible ou cachée.
"browserx" Récupère la coordonnée x du coin supérieur gauche d'un élément de document, par rapport au navigateur.
"browsery" Récupère la coordonnée y du coin supérieur gauche d'un élément de document, par rapport au navigateur.
"busy" Récupère une valeur booléenne indiquant si l'objet est engagé dans une opération de navigation ou de téléchargement.
"contenteditable" Récupère une valeur booléenne indiquant si l'objet peut être modifié avec la souris et le clavier.
"fullscreen" Récupère une valeur booléenne qui indique si le navigateur est en mode plein écran ou en mode fenêtre normale.
"height" Récupère la hauteur de la fenêtre principale du navigateur ou un élément de document.
"hwnd" Récupère le handle de la fenêtre principale d'Internet Explorer. Peut être utilisé dans la plupart des fonctions AutoIt Win*.
"innerhtml" Récupère le rendu HTML d'un élément à l'exclusion du début et de fin des balises d'élément.
"innertext" Récupère le texte rendu (mais pas les balises) d'un élément. Typiquement identique à outertext.
"isdisabled" Récupère la valeur indiquant si l'utilisateur peut interagir avec l'objet.
"left" Récupère la coordonnée écran du bord gauche de la fenêtre principale de l'objet.
"locationname" Récupère le nom de la ressource que Internet Explorer affiche actuellement.
"locationurl" Récupère l'URL de la ressource que Internet Explorer affiche actuellement.
"menubar" Récupère une valeur booléenne indiquant si la barre de menu du navigateur est visible.
"offline" Récupère une valeur booléenne qui indique si le navigateur fonctionne actuellement en mode déconnecté.
"outertext" Récupère le texte rendu (mais pas les balises) d'un élément. Typiquement identique à innerText.
"outerhtml" Récupère le rendu HTML d'un élément y compris les balises de début et de fin de l'élément.
"readystate" Récupère l'état "prêt" d'un objet.
"referrer" Récupère la chaîne URL qui a permis d'accéder à la page actuelle (mais seulement si on y accède via un lien sur cette page, sinon la chaîne est nulle).
"resizable" Récupère une valeur qui indique si l'objet peut être redimensionné.
"screenx" Récupère la coordonnée x du coin supérieur gauche d'un objet de document ou du navigateur, par rapport à l'écran.
"screeny" Récupère la coordonnée y du coin supérieur gauche d'un objet de document ou du navigateur, par rapport à l'écran.
"silent" Récupère une valeur qui indique si le navigateur peut afficher des boîtes de dialogue.
"statusbar" Récupère une valeur qui indique si la barre d'état de l'objet est visible.
"statustext" Récupère le texte dans la barre d'état de l'objet.
"theatermode" Récupère une valeur booléenne indiquant si le navigateur est en mode Theater. Dans le mode Theater, la fenêtre principale du navigateur remplit l'écran entier et affiche une barre d'outils avec un minimum de boutons de navigation.
"title" Récupère le titre du document. Notez que celui-ci est différent du titre de la fenêtre qui commence généralement par le titre du document, mais qui a le texte supplémentaire spécifié dans le registre de Windows qui lui est annexé.
"toolbar" Récupère une valeur booléenne indiquant si la barre d'outils du navigateur est visible ou cachée.
"top" Récupère la coordonnée d'écran du bord supérieur de la fenêtre principale de l'objet.
"visible" Récupère une valeur qui indique si l'objet est visible ou caché.
"width" Récupère la largeur de la fenêtre principale du navigateur ou d'un élément de document.
"uniqueid" Récupère un ID affecté par le DOM qui est unique parmi tous les éléments. Ceci peut être utilisé dans n'importe quel contexte qui nécessite un ID d'élément.

De plus amples informations pour l'objet ClientInfo peuvent être trouvées à MSDN.

ClientInfo Properties

Propriété Description
"appcodename" Récupère le nom de code du navigateur (la propriété a une valeur par défaut: Mozilla).
"appminorversion" Récupère la valeur de la version mineure de l'application.
"appname" Récupère le nom du navigateur (la propriété a une valeur par défaut: Microsoft Internet Explorer).
"appversion" Récupère la plate-forme et la version du navigateur.
"browserlanguage" Récupère la langue du navigateur actuel (la valeur sera l'un de ceux-ci Language Codes).
"cookieenabled" Récupère si les cookies persistants côté client sont activés dans le navigateur. Les cookies persistants sont ceux qui sont stockés sur l'ordinateur côté client.
"cpuclass" Récupère une chaîne indiquant la classe de CPU (les valeurs de retour peuvent être trouvés ici).
"javaenabled" Retourne si Java est activé ou pas.
"online" Récupère une valeur indiquant si le système est en Mode déconnecté global .
"platform" Récupère le nom de système d'exploitation de l'utilisateur (les valeurs de retour peuvent être trouvés ici).
"systemlanguage" Récupère la langue par défaut utilisée par le système d'exploitation (la valeur sera l'une de celles-ci Codes Langue ).
"useragent" Récupère une chaîne équivalente à l'entête de la requête de l'agent utilisateur HTTP.
"userlanguage" Récupère le paramètre de langue naturelle du système d'exploitation (la valeur sera l'une de celles-ci Codes Langue ).

En relation

_IEBodyReadHTML, _IEBodyReadText, _IEBodyWriteHTML, _IEDocInsertHTML, _IEDocInsertText, _IEHeadInsertEventScript, _IEPropertySet

Exemple

Exemple 1

; Ouvre une instance du navigateur avec l'exemple de base, cherche à voir si
; la barre d'adresse est visible, si oui la cache, si non la rend visible

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

Local $oIE = _IE_Example("basic")
If _IEPropertyGet($oIE, "addressbar") Then
    MsgBox($MB_SYSTEMMODAL, "AddressBar Status", "AddressBar Visible, turning it off")
    _IEPropertySet($oIE, "addressbar", False)
Else
    MsgBox($MB_SYSTEMMODAL, "AddressBar Status", "AddressBar Invisible, turning it on")
    _IEPropertySet($oIE, "addressbar", True)
EndIf

Exemple 2

; Ouvre une instance du navigateur avec l'exemple de formulaire et obtient une référence à l'élément
; zone de texte du formulaire. Obtient les coordonnées and les dimensions de la zone de texte,
; décit sa forme avec la souris et revient au centre

#include <IE.au3>

Local $oIE = _IE_Example("form")

Local $oForm = _IEFormGetObjByName($oIE, "ExampleForm")
Local $oTextArea = _IEFormElementGetObjByName($oForm, "textareaExample")

; Obtient les coordonnées et les dimensions de la zone de texte
Local $iScreenX = _IEPropertyGet($oTextArea, "screenx")
Local $iScreenY = _IEPropertyGet($oTextArea, "screeny")
Local $iBrowserX = _IEPropertyGet($oTextArea, "browserx")
Local $iBrowserY = _IEPropertyGet($oTextArea, "browserY")
Local $iWidth = _IEPropertyGet($oTextArea, "width")
Local $iHeight = _IEPropertyGet($oTextArea, "height")

; Décrit la zone de texte avec la souris, et revient au centre
Local $iMousespeed = 50
MouseMove($iScreenX, $iScreenY, $iMousespeed)
MouseMove($iScreenX + $iWidth, $iScreenY, $iMousespeed)
MouseMove($iScreenX + $iWidth, $iScreenY + $iHeight, $iMousespeed)
MouseMove($iScreenX, $iScreenY + $iHeight, $iMousespeed)
MouseMove($iScreenX, $iScreenY, $iMousespeed)
MouseMove($iScreenX + $iWidth / 2, $iScreenY + $iHeight / 2, $iMousespeed)