Einbinden von Ressourcen in Anwendungen

Artikel
04/01/2008

Visual FoxPro stellt mehrere Ressourcendateien zur Verfügung, die die grundlegende Funktionalität Ihrer jeweiligen Anwendung erweitern. Zu diesen Ressourcendateien zählen die FOXUSER-Ressourcendateien, die API-Bibliotheken sowie die ActiveX-Steuerelemente. Damit Sie diese Dateien einsetzen können, binden Sie die Dateien in Ihr Projekt oder in Ihr Vertriebsverzeichnis ein.

Weitere Informationen zum Einbinden von Dateien in das Installationsprogramm finden Sie in der Hilfe zum jeweils verwendeten Setup-Erstellungsprogamm. Das verwendete Setup-Erstellungsprogramm muss MSI-Installationspakete unter Verwendung der Windows Installer-Technologie erstellen.

Einbinden von FOXUSER-Ressourcendateien

In Visual FoxPro-Ressourcendateien werden Informationen gespeichert, die für Ihre Anwendung nützlich sind, so z. B. die Positionen von Fenstern, die Konfigurationen von Datenblattfenstern sowie Etikettendefinitionen. Wenn Ihre Anwendung für einige dieser Ressourcenelemente bestimmte Einstellungen erwartet, müssen zusätzlich zu der Anwendung auch entweder die FOXUSER-Datenbank und -Memodatei oder die Ressourcendateien geliefert werden, die Sie speziell für Ihre Anwendung erstellt haben. Diese Ressourcendateien bestehen aus einer Visual FoxPro-Tabelle sowie einer zugehörigen Memodatei und heißen üblicherweise FoxUser.dbf bzw. FoxUser.fpt.

Anmerkung Die FOXUSER-Ressourcendatei ist nicht mit der gebietsschemaspezifischen Ressourcendatei identisch, die Dialogfelder und Fehlermeldungen enthält. In der FOXUSER-Ressourcendatei werden zur Anwendung gehörende Informationen gespeichert, wie z. B. die von Ihnen definierten Makros. In der gebietsschemaspezifischen Ressourcendatei werden für das System benötigte Textzeichenfolgen gespeichert.

Einbinden von externen Bibliotheksdateien

Wenn die Anwendung externe Bibliotheksdateien wie ActiveX-Steuerelmente (.ocx-Dateien) oder Visual FoxPro API-Bibliotheken (.fll-Dateien) enthält, vergewissern Sie sich, dass diese im entsprechenden Verzeichnis des Installationspakets gespeichert sind. Sie können mit Ihren Anwendungen die zu Visual FoxPro gehörende API-Bibliothek FoxTools.fll liefern. Weitere Informationen zum Erstellen von externen Bibliotheken für den Zugriff auf die Visual FoxPro-API finden Sie unter Zugreifen auf APIs.

Einbinden von ActiveX-Steuerelementen und COM-Komponenten

Wenn Ihre Anwendung ActiveX-Steuerelemente enthält oder wenn Sie einen Automatisierungsserver (eine COM-Komponente) als Teil Ihrer Anwendung erstellt haben, binden Sie die entsprechenden .ocx- und .dll-Dateien in Ihr Projekt ein, und vergewissern Sie sich, dass die erforderlichen Unterstützungsdateien am richtigen Speicherort auf dem Computer des Benutzers installiert werden. Beachten Sie, dass die Installation von Komponenten im Windows-Verzeichnis System laut der Windows 2000 Logo-Richtlinien nicht empfohlen wird. Sie können allerdings nur solche ActiveX-Steuerelemente vertreiben, für die Sie eine Lizenz besitzen. Bei einem Automatisierungsserver müssen auch die entsprechenden Registrierungsdateien, wie z. B. Typbibliotheken (.tlb-Dateien) und Dateien für die Registrierung (.vbr-Dateien), in Ihre Anwendung einbezogen werden.

Wenn Sie die Vertriebsdisketten mit Hilfe Ihres Setup-Erstellungsprogramms erstellen, können Sie diese Dateien automatisch einbinden. In diesem Fall überprüft das Setup-Erstellungsprogramm nach der Installation der Anwendung, ob die COM-Komponenten korrekt auf dem Computer des Benutzers installiert wurden. Weitere Informationen zum Einbinden von Dateien in Ihr Setup-Erstellungsprogramm finden Sie in der zugehörigen Hilfe des jeweiligen Programms.

Alle Benutzer können Formulare ausführen, die ActiveX-Steuerelemente enthalten. Zu beachten ist allerdings, dass Ihre Anwendung bestimmte Aufgaben nicht ausführen kann, wenn sie unter der Laufzeitversion von Visual FoxPro ausgeführt wird. Es gelten folgende Richtlinien:

Ihre Anwendung muss unter einer Vollversion von Visual FoxPro ausgeführt werden, um Änderungen an Formularen, Klassen oder Unterklassen vornehmen zu können, die ActiveX-Steuerelemente enthalten.
Ihre Anwendung muss unter einer Vollversion von Visual FoxPro ausgeführt werden, um ActiveX-Steuerelemente während der Laufzeit zu einem Formular hinzufügen zu können. Zum Beispiel ist die Vollversion von Visual FoxPro erforderlich, damit der folgende Code ausgeführt werden kann, um ein Hierarchie-Steuerelement zu einem Formular hinzuzufügen:
```
PUBLIC frmOleNewForm
frmOleNewForm = CREATEOBJECT("form")
frmOleNewForm.Show
frmOleNewForm.ScaleMode = 3
frmOleNewForm.Addobject("NewOutline","OLEControl",;
   "MSOutl.Outline")
```
Anmerkung Steuerelemente, die während der Laufzeit hinzugefügt wurden, werden nicht gespeichert, wenn ein Formular geschlossen wird.
ActiveX-Steuerelemente, die als Unterklassen vorliegen, kann Ihre Anwendung während der Laufzeit zu einem Formular hinzufügen, wobei es keine Rolle spielt, ob die Anwendung unter der Laufzeit- oder unter der Vollversion von Visual FoxPro ausgeführt wird. Zum Beispiel können Sie aus der Klasse Outline die Unterklasse RedOutline definieren und diese Unterklasse in der Datei Olelib.vcx liefern. Alle Benutzer können dann ein RedOutline-Steuerelement zu einem Formular hinzufügen, indem sie folgenden Code ausführen:
```
PUBLIC frmOleNewForm
frmOleNewForm = CREATEOBJECT("form")
frmOleNewForm.Show
frmOleNewForm.ScaleMode = 3
SET CLASSLIB TO CURR() + OLELIB.VCX
frmOleNewForm.Addobject("NewOutline","RedOutline")
```

Einbinden einer Konfigurationsdatei

Mit Hilfe der Konfigurationsdatei (Config.fpw) können viele Visual FoxPro-Standardeinstellungen festgelegt werden. Zum Beispiel können Sie den Text der Visual FoxPro-Titelleiste, die Hintergrundfarbe sowie die Möglichkeit ändern, wie sich ein Benutzer per Tastatur durch die Benutzeroberfläche bewegt.

Soll die Konfigurationsdatei schreibgeschützt sein, muss die Datei in Ihr Projekt eingefügt und als Einbezogen markiert werden. Soll sie veränderbar sein, muss die Datei als Nicht einbezogen markiert werden. Dann muss die Konfigurationsdatei als eigenständige Datei zusammen mit Ihrer Anwendung oder ausführbaren Datei geliefert werden. Standardmäßig sucht Visual FoxPro nach einer Konfigurationsdatei namens Config.fpw. Wenn Sie für den Start von Visual FoxPro den Befehlszeilenparameter -C verwenden, können Sie den Namen einer anderen Konfigurationsdatei angeben.

Weitere Informationen zu Optionen, die Sie in der Konfigurationsdatei einstellen können, finden Sie unter Anpassen der Visual FoxPro-Umgebung unter der Überschrift "Verwenden einer Konfigurationsdatei".

Einbinden einer gebietsschemaspezifischen Ressourcendatei

Wenn Sie Ihre Anwendung zusammen mit der Laufzeitversion von Visual FoxPro vertreiben, müssen Sie möglicherweise eine gebietsspezifische Ressourcendatei mitliefern. Diese Datei enthält die Dialogfelder und andere Elemente der Benutzeroberfläche, auf die Visual FoxPro bei der Interaktion mit dem Benutzer zurückgreift. Für jede Sprache, in der Visual FoxPro verfügbar ist, gibt es eine andere Ressourcendatei, die während der Laufzeit verwendet wird.

Weitere Informationen zu gebietsschemaspezifischen Laufzeitdateien finden Sie im Abschnitt Entwickeln internationaler Anwendungen unter der Überschrift "Vertreiben von gebietsspezifischen Laufzeitdateien".

Anmerkung Eine gebietsschemaspezifische Ressourcendatei ist nicht mit der FOXUSER-Ressourcendatei identisch, in der anwendungspezifische Informationen gespeichert sind, wie z. B. die von Ihnen definierten Makros. In einer gebietsschemaspezifischen Ressourcendatei sind Textzeichenfolgen des Systems gespeichert.

Wenn Sie eine Anwendung für Plattformen des Mittleren Ostens erstellen, vergewissern Sie sich, dass Sie die Datei VBAME.DLL zu Ihrem Vertriebspaket hinzufügen und sie im Windows System-Verzeichnis installiert haben.

Einbinden von Hilfedateien

Wenn Sie für Ihre Anwendung grafikorientierte Hilfe erstellen, legen Sie die entsprechende .chm- oder .hlp-Datei in dem Vertriebsverzeichnis Ihrer Anwendung ab, damit das Setup-Erstellungsprogramm die Hilfedatei in Ihre Vertriebsdisketten einbinden kann. Weitere Informationen zum Erstellen von Hilfedateien finden Sie unter Erstellen von Hilfedateien.

Anmerkung Sie dürfen weder Winhelp.exe noch die Hilfedateien vertreiben, die mit Visual FoxPro geliefert wurden. Weitere Informationen finden Sie unter Entfernen eingeschränkt nutzbarer Visual FoxPro-Elemente und -Dateien.

Einbinden der von Ihnen erstellten Dateien

Eine ganze Reihe von Visual FoxPro-Dateien, -Grafiken und -Programmen dürfen Sie lizenzfrei zusammen mit den von Ihnen erstellten Anwendungen vertreiben. Weitere Informationen finden Sie unter Entfernen eingeschränkt nutzbarer Visual FoxPro-Elemente und -Dateien.

Bevor Sie Ihre Anwendung erstellen, muss überprüft werden, ob Ihr Projekt alle benötigten Dateien umfasst, also sowohl alle Dateien, die für Ihre Anwendung erforderlich sind, als auch alle zusätzlichen Ressourcendateien, wie z. B. Grafikdateien oder Vorlagen.

In der folgenden Tabelle sind Dateien aufgeführt, die Sie zu Ihrem Projekt hinzufügen können.

Aktion	Hinzuzufügende Dateien
Wenn Sie für Ihre Anwendung eine benutzerdefinierte Konfiguration verwenden	Config.fpw
Wenn Sie für Ihre Anwendung benutzerdefinierte Einstellungen verwenden	Foxuser.dbf und Foxuser.fpt
Wenn Sie eine Datei vertreiben, die Hilfe im .dbf-Format enthält	Die Hilfedatei im .dbf-Format

So fügen Sie Dateien zu Ihrer Anwendung hinzu

Binden Sie die Dateien in Ihr Projekt ein.

Soll es nicht möglich sein, in der Endbenutzeranwendung Änderungen an diesen Dateien vorzunehmen, müssen die Dateien in Ihr Projekt eingefügt und als Einbezogen markiert werden. Die Dateien sind dann schreibgeschützt und können nicht geändert werden.

- Oder -
Fügen Sie die Dateien zum Anwendungsverzeichnis hinzu, so dass das Setup-Erstellungsprogramm auf einfache Weise darauf zugreifen kann.

Soll es möglich sein, Änderungen an den Dateien vornehmen zu können, müssen diese in Ihr Projekt eingefügt und als Nicht einbezogen angemeldet werden (d.h., die Option Einbezogen darf nicht aktiviert sein). Die Dateien liefern Sie anschließend als separate Dateien zusammen mit Ihrer Anwendung.

Weitere Informationen zum Erstellen von Projekten und zum Einbinden oder Ausschließen von Dateien finden Sie in unter Kompilieren einer Anwendung.

Siehe auch

Menüoptionen | Entfernen eingeschränkt nutzbarer Visual FoxPro-Elemente und -Dateien | Schützen und Dokumentieren von Quellcode | Vorbereitung einer vertriebsfähigen Anwendung

Freigeben über