Freigeben über

Zugreifen auf das Steuerelement in Webseiten

  • Artikel

[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

Um von einer Webseite aus auf die Microsoft-Agent-Dienste zuzugreifen, verwenden Sie das HTML-Tag innerhalb des <HEAD> - <OBJECT> oder <BODY> -Elements der Seite, und geben Sie die Microsoft CLSID (Klassenbezeichner) für das Steuerelement an. Verwenden Sie außerdem einen CODEBASE-Parameter, um den Speicherort der Microsoft Agent-Installationsdatei und deren Versionsnummer anzugeben.

Wenn Microsoft Internet Explorer (Version 3.02 oder höher) auf dem System installiert ist, der Microsoft-Agent jedoch noch nicht installiert ist und der Benutzer auf eine Webseite mit dem <OBJECT-Tag> mit der Agent-CLSID zugreift, versucht der Browser automatisch, den Agent von der Microsoft-Website herunterzuladen. Anschließend wird der Benutzer gefragt, ob er mit der Installation fortfahren soll. Bei anderen Browsern wenden Sie sich an den Anbieter, um Informationen zu dessen Support oder Unterstützung von ActiveX-Steuerelementen von Drittanbietern zu erfragen.

Im folgenden Beispiel wird veranschaulicht, wie Sie den CODEBASE-Parameter verwenden, um die englischsprachige Version 2.0 des Microsoft-Agents automatisch herunterzuladen.

<OBJECT
classid="clsid: D45FD31B-5C6E-11D1-9EC1-00C04FD7081F"
CODEBASE = "#VERSION=2,0,0,0"
 id=Agent
>
</OBJECT>

Der Agent kann auch von Ihrem eigenen HTTP-Server oder im Rahmen des Installationsvorgangs einer Anwendung installiert werden. Um die Installation von Ihrem eigenen HTTP-Server zu unterstützen, müssen Sie die Selbstinstallations-.Exe-Datei des Microsoft-Agents veröffentlichen und deren URL im CODEBASE-Tag angeben.

<OBJECT
classid="clsid: D45FD31B-5C6E-11D1-9EC1-00C04FD7081F"
CODEBASE = "https://your server/msagent.exe#VERSION=2,0,0,0"
 id=Agent
>
</OBJECT>

Um den automatischen Download einer Sprachkomponente des Microsoft-Agents von einer Webseite zu unterstützen, schließen Sie das Objekttag der Sprachkomponente auf der Seite vor dem Objekttag des Agent-Steuerelements ein:

<OBJECT width=0 height=0
CLASSID="CLSID: C348XXXX-A7F8-11D1-AA75-00C04FA34D72"
CODEBASE = "#VERSION=2,0,0,0">
</OBJECT>

dabei wird XXXX durch eine Sprach-ID ersetzt. Informationen zu den derzeit unterstützten Sprachen finden Sie auf der Microsoft-Agent-Website.

  • Das <OBJECT> Tag für eine Sprachkomponente muss dem <OBJECT-Tag> für die Kernkomponente des Microsoft-Agents vorangestellt werden.
  • Auf demselben Client können mehrere Sprachen installiert werden.
  • Vor dem Festlegen der LanguageID eines Zeichens wird empfohlen, dass Ihr Skript überprüft, ob das Gebietsschema des Browsers, das in der userLanguage-Eigenschaft verfügbar ist, der festgelegten Sprache entspricht.

Um andere Sprachversionen des Agents zu unterstützen, verwenden Sie ein anderes Object-Tag, das die Sprachkomponente angibt. Beachten Sie jedoch, dass der Versuch, mehrere Sprachen gleichzeitig zu installieren, möglicherweise einen Neustart des Benutzers erfordert. Die Komponenten der Agent-Sprache können von der Agent-Website abgerufen werden, indem Sie dasselbe Verfahren wie für die Agent-Kernkomponente verwenden. Die Verteilungslizenzierung für die Sprachkomponenten wird in der Standard-Agent-Verteilungslizenz behandelt. Um mit der Verwendung eines Zeichens zu beginnen, müssen Sie das Zeichen mit der Load-Methode laden. Ein Zeichen kann aus dem lokalen Speicher des Benutzers oder einem HTTP-Server geladen werden. Weitere Informationen zur Syntax zum Laden eines Zeichens finden Sie in der Load-Methode . Nachdem das Zeichen erfolgreich geladen wurde, können Sie die Methoden, Eigenschaften und Ereignisse verwenden, die vom Agent-Steuerelement verfügbar gemacht werden, um das Zeichen zu programmieren. Sie können auch die Methoden, Eigenschaften und Ereignisse verwenden, die von Ihrer Programmiersprache und dem Browser verfügbar gemacht werden, um das Zeichen zu programmieren. beispielsweise, um die Reaktion auf einen Schaltflächenklick zu programmieren. Lesen Sie die Dokumentation für Ihren Browser, um zu ermitteln, welche Features in seinem Skriptmodell verfügbar gemacht werden. Informationen zu Microsoft Internet Explorer finden Sie im Skriptobjektmodell, das im ActiveX SDK verfügbar ist.

Die Dienste des Agents bleiben nur geladen, wenn mindestens eine Clientanwendung mit einer Verbindung vorhanden ist. Dies bedeutet, dass der Agent heruntergefahren wird, wenn ein Benutzer zwischen Webseiten mit Aktiviertem Agent wechselt, und alle von Ihnen geladenen Zeichen werden nicht mehr angezeigt. Erstellen Sie einen weiteren Client, der zwischen Seitenänderungen geladen bleibt, um die Ausführung des Agents zwischen Seiten aufrechtzuerhalten (und dadurch ein Zeichen sichtbar zu halten). Sie können beispielsweise ein HTML-Frameset erstellen und ein <OBJECT-Tag> für den Agent im übergeordneten Frame deklarieren. Anschließend können Sie die seiten, die Sie laden, in die untergeordneten Frames skripten, um sie in das Skript des übergeordneten Elements aufzurufen. Alternativ können Sie auch ein <OBJECT-Tag> auf jeder Seite einfügen, die Sie in den untergeordneten Frame laden. Denken Sie in diesem Fall daran, dass jede Seite ein eigener Client ist. Möglicherweise müssen Sie die Activate-Methode verwenden, um festzulegen, welcher Client die Kontrolle hat, wenn der Benutzer mit der übergeordneten oder untergeordneten Seite interagiert.