Altova Authentic 2024 Desktop

Im Vergleich zur Integration auf Applikationsebene ist die Integration auf Dokumentebene komplexer, bietet aber dafür mehr Flexibilität beim Einbetten von Authentic Desktop-Funktionalitäten in Ihre Applikation mit Hilfe von ActiveX Controls. Auf diese Art haben Sie selektiven Zugriff auf die folgenden Teile der Authentic Desktop-Benutzeroberfläche:

•Dokument-Bearbeitungsfenster

•Projektfenster

•Infofenster

•Fenster "Meldungen"

•Eingabehilfenfenster (Elemente, Attribute, Entities)

•Ausgabefenster

Wie bereits im Abschnitt Integration auf Applikationsebene erwähnt, ist für eine ActiveX-Integration auf Applikationsebene nur ein Control, nämlich das AuthenticDesktopControl, erforderlich. Für eine ActiveX-Integration auf Dokumentebene werden die Authentic Desktop-Funktionalitäten jedoch durch die folgenden ActiveX Controls zur Verfügung gestellt:

•AuthenticDesktopControl

•AuthenticDesktopControl Document

•AuthenticDesktopControl Placeholder

Diese Controls werden durch die Datei AuthenticControl.ocx aus dem Applikationsinstallationsordner von Authentic Desktop zur Verfügung gestellt. Wenn Sie die ActiveX-Integration mit Hilfe von Visual Studio erstellen, benötigen Sie über die Visual Studio Toolbox Zugriff auf diese Controls (siehe Hinzufügen der ActiveX Controls zur Toolbox).

Die grundlegenden Schritte, um die ActiveX Controls auf Dokumentebene in Ihre Applikation zu integrieren sind die folgenden:

1.Instantiieren Sie in Ihrer Applikation zuerst AuthenticDesktopControl. Die Instantiierung dieses Control ist obligatorisch; Es ermöglicht die Unterstützung für die oben erwähnten Controls AuthenticDesktopControl Document und AuthenticDesktopControl Placeholder. Die Eigenschaft IntegrationLevel muss auf ICActiveXIntegrationOnDocumentLevel (oder "1") gesetzt werden. Um das Control für den Benutzer auszublenden, setzen Sie seine Eigenschaft Visible auf False. Anmerkung: Verwenden Sie für die Integration auf Dokumentebene nicht die Open-Methode des AuthenticDesktopControl, da dies zu unerwünschten Ergebnissen führen könnte. Verwenden Sie stattdessen die entsprechenden open-Methoden von AuthenticDesktopControl Document und AuthenticDesktopControl PlaceHolder.

2.Erstellen Sie mindestens eine Instanz von AuthenticDesktopControl Document in Ihrer Applikation. Dieses Control stellt Ihrer Applikation das Dokumentbearbeitungsfenster von Authentic Desktop zur Verfügung und kann bei Bedarf mehrmals instantiiert werden.erwenden Sie die Methode Open, um eine vorhandene Datei zu laden. Um Funktionen im Zusammenhang mit einem Dokument aufzurufen, verwenden Sie die Methoden Path und Save oder Methoden und Eigenschaften, die über die Eigenschaft Document zur Verfügung stehen. Anmerkung: Das Control unterstützt keinen schreibgeschützten Modus. Der Wert der Eigenschaft ReadOnly wird ignoriert.

3.Fügen Sie optional für jedes weitere Fenster (bei dem es sich nicht um das Dokumentfenster handelt) und das Ihrer Applikation zur Verfügung stehen soll, den AuthenticDesktopControl Placeholder zur Ihrer Applikation hinzu. Mit Hilfe von Instanzen von AuthenticDesktopControl PlaceHolder können Sie selektiv zusätzliche Fenster von Authentic Desktop in Ihre Applikation einbetten. Die Art des Fensters (z.B. Projektfenster) wird durch die Eigenschaft PlaceholderWindowID definiert. Um daher die Art des Fensters zu definieren, definieren Sie die Eigenschaft PlaceholderWindowID. Gültige Fenster-IDs finden Sie unter AuthenticDesktopControlPlaceholderWindow. Verwenden Sie für jeden Windows Identifier nur einen AuthenticDesktopControl PlaceHolder.

Für Placeholder Controls, die das Authentic Desktop-Projektfenster auswählen, stehen zusätzliche Methoden zur Verfügung. Mit Hilfe von OpenProject können Sie ein Authentic Desktop-Projekt laden. Mit Hilfe der Eigenschaft "Project" und der Methoden und Eigenschaften aus der Authentic Desktop Automation-Schnittstelle können Sie andere Operationen im Zusammenhang mit einem Projekt durchführen.

Ein Beispiel, wie Sie in C# oder VB.NET mit Visual Studio eine einfache, aus einem Formular bestehende Applikation, in der die Authentic Desktop ActiveX Controls auf Dokumentebene integriert sind, erstellen, sehen Sie in der Beschreibung unten. Beachten Sie, dass Ihre Applikation bei Bedarf auch komplexer sein kann. In der Anleitung unten sehen Sie jedoch, welche Voraussetzungen mindestens gegeben sein müssen, damit eine ActiveX-Integration auf Dokumentebene erfolgen kann.

1.Erstellen Sie ein neues Visual Studio Windows Forms-Projekt mit einem neuen leeren Formular.

2.Fügen Sie die ActiveX Controls zur Toolbox hinzu, falls dies noch nicht geschehen ist (siehe Hinzufügen der ActiveX Controls zur Toolbox).

3.Ziehen Sie das AuthenticDesktopControl aus der Toolbox in Ihr neues Formular.

4.Setzen Sie die Eigenschaft IntegrationLevel des AuthenticDesktopControl auf ICActiveXIntegrationOnDocumentLevel und die Eigenschaft Visible auf False. Sie können dies entweder über den Code oder über das Fenster Properties tun.

5.Ziehen Sie das AuthenticDesktopControl Document aus der Toolbox in das Formular. Dieses Control stellt das Dokument-Hauptfenster von Authentic Desktop für Ihre Applikation zur Verfügung. Eventuell müssen Sie die Größe des Fensters an die Ihres Dokuments anpassen.

6.Fügen Sie optional ein oder mehrere AuthenticDesktopControl Placeholder Controls zum Formular hinzu (eines für jeden zusätzlichen Fenstertyp, der für Ihre Applikation benötigt wird, z.B. das Projektfenster). Solche zusätzlichen Placeholder Controls werden normalerweise entweder unterhalb oder rechts oder links vom Dokument-Haupt-Control platziert z.B.:

7.Setzen Sie die Eigenschaft PlaceholderWindowID jedes AuthenticDesktopControl Placeholder auf einen gültigen Fenster-Identifier. Eine Liste der gültigen Werte finden Sie unter AuthenticDesktopControlPlaceholderWindow.

8.Fügen Sie, wie unten gezeigt, Befehle zu Ihrer Applikation hinzu (Sie benötigen zumindest Befehle zum Öffnen, Speichern und Schließen von Dokumenten).

Abfragen von Authentic Desktop-Befehlen

Bei einer Integration auf Dokumentebene stehen in Ihrer Applikation kein Authentic Desktop-Menü- und keine Authentic Desktop-Symbolleiste zur Verfügung. Sie können statt dessen die benötigten Befehle aufrufen, deren Status anzeigen und diese programmatisch ausführen, wie folgt:

•Um alle verfügbaren Befehle abzurufen, verwenden Sie die Eigenschaft CommandsList des AuthenticDesktopControl.

•Um die Befehle, geordnet nach ihrer Menüstruktur abzurufen, verwenden Sie die Eigenschaft MainMenu.

•Um die Befehle, geordnet nach der Symbolleiste, in der sie vorkommen, abzurufen, verwenden Sie die Eigenschaft Toolbars.

•Um Befehle an Authentic Desktop zu senden, verwenden Sie die Methode Exec.

•Um abzufragen, ob ein Befehl gerade aktiviert oder deaktiviert ist, verwenden Sie die Methode QueryStatus.

Auf diese Art können Sie Authentic Desktop-Befehle flexibel in die Menüs und Symbolleisten Ihrer Applikation integrieren.

Über Ihre Installation von Authentic Desktop stehen Ihnen auch Symbole für in Authentic Desktop verwendete Befehle zur Verfügung. Im Ordner <Applicationsordner>\Examples\ActiveX\Images Ihrer Authentic Desktop-Installation finden Sie Symbole im GIF-Format. Die Dateinamen entsprechen den im Abschnitt Befehlsreferenz aufgelisteten Befehlsnamen.

Allgemeines

Um das Verhalten von Authentic Desktop zu automatisieren, verwenden Sie die für AuthenticDesktopControl, AuthenticDesktopControl Document und AuthenticDesktopControl Placeholder beschriebenen Eigenschaften, Methoden und Ereignisse.

Für einen komplexeren Zugriff auf Authentic Desktop-Funktionalitäten sollten Sie die folgenden Eigenschaften verwenden:

•AuthenticDesktopControl.Application

•AuthenticDesktopControlDocument.Document

•AuthenticDesktopControlPlaceHolder.Project

Über diese Eigenschaften erhalten Sie Zugriff auf die Authentic Desktop Automation-Schnittstelle (<%APPAPI%)

Beispiele, wie Sie die erforderlichen Controls in unterschiedlichen Programmierumgebungen instantiieren und aufrufen finden Sie unter Beispiele zur ActiveX-Integration.