_IEDocInsertHTML

Beschreibung anzeigen in

Fügt HTML in oder um ein Element herum ein

#include <IE.au3>
_IEDocInsertHTML ( ByRef $oObject, $sString [, $sWhere = "beforeend"] )

Parameter

$oObject	Objektvariable, die auf ein Dokument verweist
$sString	Die Variable enthält den einzufügenden HTML-Text.
$sWhere	[optional] Gibt an, wo der HTML-Text eingefügt werden soll "beforebegin" = Fügt den String unmittelbar vor dem Objekt ein. "afterbegin" = Fügt den String nach dem Anfang des Objekts, jedoch vor dem anderen Inhalt des Objekts ein. "beforeend" = (Standard) Fügt den String unmittelbar vor dem Ende des Objekts, jedoch nach dem anderen Inhalt des Objekts ein. "afterend" = Fügt den String unmittelbar nach dem Objekt ein.

Rückgabewert

Erfolg:	1.
Fehler:	0 und setzt das @error Flag auf ungleich null
@Error:	2 ($_IEStatus_COMError) - COM Error in Objektreferenz 3 ($_IEStatus_InvalidDataType) - Ungültiger Datentyp 4 ($_IEStatus_InvalidObjectType) - Ungültiger Objekttyp 5 ($_IEStatus_InvalidValue) - Ungültiger Wert
@extended:	Beinhaltet Nummer des ungültigen Parameters

Bemerkungen

Mit den _IEPropertySet()-Eigenschaften innerHTML, outerHTML, innerText und outerText kann der einzufügende Inhalt dynamisch geändert werden.

Beispiel

Beispiel 1

#include <IE.au3>

; Einfügen von HTML in ein Dokument, am Anfang und Ende

Local $oIE = _IECreate("http://www.autoitscript.com")
Local $oBody = _IETagNameGetCollection($oIE, "body", 0)
_IEDocInsertHTML($oBody, "<h2><font color=red>Dieser HTML-Code ist eingefügt am Anfang</font></h2>", "afterbegin")
_IEDocInsertHTML($oBody, "<h2><font color=red>Dieser HTML-Code ist eingefügt am Ende</font></h2>", "beforeend")

Beispiel 2

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

; Öffnet einen Browser mit einer grundlegenden Beispielseite, fügt HTML in
; Und um den DIV-Tag "IEAu3Data" ein und zeigt den BODY-Quellcode.

Local $oIE = _IE_Example("basic")
Local $oDiv = _IEGetObjById($oIE, "IEAu3Data")

_IEDocInsertHTML($oDiv, "<b>(HTML beforebegin)</b>", "beforebegin")
_IEDocInsertHTML($oDiv, "<i>(HTML afterbegin)</i>", "afterbegin")
_IEDocInsertHTML($oDiv, "<b>(HTML beforeend)</b>", "beforeend")
_IEDocInsertHTML($oDiv, "<i>(HTML afterend)</i>", "afterend")

MsgBox($MB_SYSTEMMODAL, "Body", _IEBodyReadHTML($oIE) & @CRLF)

Beispiel 3

#include <IE.au3>

; Erweitertes Beispiel
; Fuegt eine Uhr und einen Herkunft-String im Kopfbereich ein. Diese bleiben auch beim Weiterbrowsen auf jeder Folgeseite erhalten.
; Benutzt _IEDocInsertText, _IEDocInsertHTML und
; _IEPropertySet Funktionen "innerhtml" und "referrer"

Global $g_oIE = _IECreate("http://www.autoitscript.com")

AdlibRegister("UpdateClock", 1000) ; Uhren-Update einmal pro Sekunde

While 1
    Sleep(10000)
WEnd

Exit

Func UpdateClock()
    ; wartet bis das Browser-Fenster existiert
    If Not WinExists(_IEPropertyGet($g_oIE, "hwnd")) Then Exit

    Local $sCurTime = "<font color=red><b>Aktuelle Zeit ist: </b>" & @HOUR & ":" & @MIN & ":" & @SEC & "</font>"
    ; _IEGetObjById soll nach der Navigation einen "NoMatch"-Fehler zurückgeben
    ;   (bevor DIV eingefügt wird), deshalb wird die Benachrichtigung vorübergehen abgeschaltet
    _IEErrorNotify(False)
    Local $oAutoItClock = _IEGetObjById($g_oIE, "AutoItClock")
    If Not IsObj($oAutoItClock) Then ; Fügt DIV-Element ein, falls es nicht gefunden wurde
        ;
        ; Holt Referenz zu BODY, fügt DIV ein, holt Referenz zu DIV, aktualisiert die Zeit
        Local $oBody = _IETagNameGetCollection($g_oIE, "body", 0)
        _IEDocInsertHTML($oBody, "<div id='AutoItClock'></div>", "afterbegin")
        $oAutoItClock = _IEGetObjById($g_oIE, "AutoItClock")
        _IEPropertySet($oAutoItClock, "innerhtml", $sCurTime)
        ;
        ; Überprüft den Herkunft-String. Ist dieser nicht leer, fügt er ihn nach der Uhr ein
        _IELoadWait($g_oIE)
        Local $sReferrer = _IEPropertyGet($g_oIE, "referrer")
        If $sReferrer Then _IEDocInsertText($oAutoItClock, _
                "  Referred by: <font color=red>" & $sReferrer & "</font>", "afterend")
    Else
        _IEPropertySet($oAutoItClock, "innerhtml", $sCurTime) ; Aktualisiert die Zeit
    EndIf
    _IEErrorNotify(True)
EndFunc   ;==>UpdateClock

Funktionreferenz