UDF > IE >


_IECreate

Cr�e une fen�tre avec le navigateur Internet Explorer

#include <IE.au3>
_IECreate ( [$sUrl = "about:blank" [, $iTryAttach = 0 [, $iVisible = 1 [, $iWait = 1 [, $iTakeFocus = 1]]]]] )

Param�tres

$sUrl [optionnel] Sp�cifie l'URL d'acc�s � la page d'accueil lors de la cr�ation
$iTryAttach [optionnel] Sp�cifie si la fonction doit tenter d'attacher IE � une fen�tre existante
    0 = (par d�faut) Ne pas essayer
    1 = Essayer d'attacher IE � une fen�tre existante
$iVisible [optionnel] Indique si la fen�tre du navigateur sera visible
    0 = la fen�tre du navigateur est cach�e
    1 = (par d�faut) la fen�tre du navigateur est visible
$iWait [optionnel] Sp�cifie si la fonction doit attendre que la page soit charg�e avant de retourner
    0 = retour imm�diatement, sans attendre que la page soit charg�e
    1 = (par d�faut) Attendre que le chargement de la page soit termin� avant de retourner
$iTakeFocus [optionnel] Sp�cifie s'il faut donner le focus � la fen�tre attach�e
    0 = Ne pas donner le focus
    1 = (par d�faut) Donner le focus � la fen�tre

Valeur de retour

Succ�s: Retourne une variable objet pointant vers l'objet InternetExplorer.Application.
�chec: D�finit @error <> 0.
@error: 1 ($_IEStatus_GeneralError) - Erreur g�n�rale
3 ($_IEStatus_InvalidDataType) - Type de donn�e invalide
4 ($_IEStatus_InvalidObjectType) - Type d'objet invalide
6 ($_IEStatus_LoadWaitTimeout) - D�lai d'attente de chargement d�pass�
8 ($_IEStatus_AccessIsDenied) - Acc�s refus�
9 ($_IEStatus_ClientDisconnected) - Client d�connect�
@extended: Contient True (1) ou False (0) selon la r�ussite de $iTryAttach

Remarques

Lors de l'utilisation de tryAttach, une erreur No Match sera affich� dans la console � partir de _IEAttach().
Ceci peut �tre contr�l� par _IEErrorNotify().

Lorsque vous ouvrez un fichier HyperTextApplication (.hta) local, Internet Explorer ouvre un nouveau processus de navigateur pour ce fichier qui ne sera pas accessible par la variable objet retourn� par _IECreate().
Pour contr�ler ce nouveau navigateur, vous devez utiliser _IEAttach() avec l'option "embedded".

De nouvelles s�curit�s dans Windows Vista provoque la cr�ation d'une nouvelle fen�tre de navigateur lorsque le navigateur est invit� � naviguer vers une URL dans une zone de s�curit� diff�rente.
Cela se produit aussi bien avec la cr�ation initiale qu'avec la navigation initi�e par _IECreate().
La nouvelle fen�tre est une nouvelle instance du navigateur et la variable objet navigateur pr�c�dente ne pointe plus sur elle.
Il existe plusieurs solutions:
    1) ajoutez #RequireAdmin � votre code (ce qui est n�cessaire, m�me si le compte fait partie du Groupe Administrateur et demandera les informations si n�cessaire),
    2) utilisez _IEAttach() pour se connecter � la nouvelle fen�tre de navigateur
    3) ajoutez le site cible � la zone de s�curit� Sites de Confiance dans Internet Explorer,
    4) d�sactivez "Protected Mode" dans IE,
    ou 5) d�sactivez l'UAC. Il faut prendre soin de comprendre les implications de la d�sactivation des fonctions de s�curit� de IE lors de l'acc�s � des sites non s�curis�s.

En relation

_IEAttach, _IECreateEmbedded, _IELoadWait, _IENavigate, _IEQuit

Exemple

Exemple 1

; Cr�e une fen�tre de navigateur et navigue vers un site web

#include <IE.au3>

Local $oIE = _IECreate("www.autoitscript.com")

Exemple 2

; Cr�e une nouvelle fen�tre de navigateur qui pointe vers 3 URLs diff�rentes
; si une n'existe pas d�j� ($f_tryAttach = 1)
; ne pas attendre le chargement complet de la page ($f_wait =  0)

#include <IE.au3>

_IECreate("www.autoitscript.com", 1, 1, 0)
_IECreate("my.yahoo.com", 1, 1, 0)
_IECreate("www.google.com", 1, 1, 0)

Exemple 3

; Tente d'attacher � un navigateur existant l'affichage d'un site web particulier
; Cr�e une nouvelle page et navigue vers ce site si il n'existe pas d�j�

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

Local $oIE = _IECreate("www.autoitscript.com", 1)
; Teste  la valeur retourn�e @extended pour voir si Attach a r�ussi
If @extended Then
    MsgBox($MB_SYSTEMMODAL, "", "Attached to Existing Browser")
Else
    MsgBox($MB_SYSTEMMODAL, "", "Created New Browser")
EndIf

Exemple 4

; Cr�e une fen�tre navigateur vide et la remplit avec du code HTML perso

#include <IE.au3>

Local $oIE = _IECreate()
Local $sHTML = "<h1>Hello World!</h1>"
_IEBodyWriteHTML($oIE, $sHTML)

Exemple 5

; Cr�e une fen�tre navigateur attach�e � une nouvelle instance de iexplore.exe
; Il est souvent n�cessaire d'obtenir d'abord une nouvelle session de cookie
; (les cookies de session sont partag�s entre toutes les instances du navigateur partageant le m�me iexplore.exe)

#include <IE.au3>

Opt("WinTitleMatchMode", 2)

ShellExecute("iexplore.exe", "about:blank")
WinWait("Windows Internet Explorer")

Local $oIE = _IEAttach("about:blank", "url")
_IELoadWait($oIE)
_IENavigate($oIE, "www.autoitscript.com")