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)