Anpassen von Hilfe im DBF-Format

Artikel
04/01/2008

In den Programmzeilen Ihrer Anwendung geben Sie neben anderen optionalen Einstellungen an, welche Hilfedatei verwendet und welche Themen wann angezeigt werden sollen. Wenn Sie eine kontextbezogene Hilfe einfügen, können Benutzer sie bei Bedarf sehr einfach zu den Dialogfeldern sowie Menübefehlen Ihrer Anwendung abrufen.

Angeben einer Hilfetabelle

Geben Sie die gewünschte Hilfetabelle durch Eingabe des Befehls SET HELP TO dateiname an. Dadurch wird die aktuell geöffnete Hilfedatei geschlossen und die Datei dateiname als neue Hilfedatei geöffnet.

In dem initialisierenden Teil des Programms speichern Sie zunächst den Namen der aktuellen Hilfedatei in einer Variablen und aktivieren anschließend die programmeigene Hilfe:

cUserHlp = SET("HELP", 1)
SET HELP TO MYHELP.DBF

Bevor die Anwendung beendet wird, können Sie wieder die ursprüngliche Hilfedatei aktivieren:

SET HELP TO (cUserHlp)

Anzeigen von Themen im Hilfefenster

Nachdem Sie eine Hilfetabelle aktiviert haben, können Sie auf folgende Arten angeben, welche Themen angezeigt werden sollen:

Soll ein Thema über seinen Namen ausgewählt werden, verwenden Sie einen der Befehle HELP Topic oder SET TOPIC TO cHelpTopicName.
Verwenden Sie die HelpContextID-Eigenschaft für kontextbezogene Themen.
Verwenden Sie für die Anzeige einer Untermenge von Themen den Befehl SET HELPFILTER.

Auswählen von Themen über ihre Namen

Sollen Themen über ihre Namen ausgewählt werden, müssen Sie den Befehl HELP Topic verwenden. Wenn Sie einen solchen Befehl verwenden, sucht Visual FoxPro in der Hilfetabelle nach einem Datensatz, bei dem der Inhalt des Themenfeldes mit Topic übereinstimmt. Bei der Suche wird nicht nach Groß- und Kleinbuchstaben unterschieden.

Wenn Visual FoxPro eine Übereinstimmung findet, zeigt es im Modus Einzelheiten im Hilfefenster den Inhalt des Memofeldes Details an. Findet Visual FoxPro keine Übereinstimmung, zeigt es im Dialogfeld Hilfe in einer Liste alle Themennamen an, wobei der Name markiert ist, der am ehesten mit dem gesuchten Namen übereinstimmt.

Aktivieren von kontextbezogener Hilfe

Sie können Ihre Anwendung so gestalten, dass Benutzer eine kontextbezogene Hilfe auf zwei Arten abrufen können:

Jederzeit durch Drücken von F1.
Durch Klicken auf die Schaltfläche Hilfe in einem Formular oder Dialogfeld

Reservieren der F1-Taste

Wenn der Benutzer in Ihrer Anwendung die F1-Taste drückt, kann Visual FoxPro ein kontextbezogenes Hilfethema anzeigen. Hierzu weisen Sie einer Hilfekontextnummer ein Thema in Ihrer Hilfetabelle zu und geben diese Nummer als Wert für die HelpContextID-Eigenschaft des Formulars bzw. des Steuerelements ein. Wenn das Formular oder das Steuerelement den Fokus besitzt und der Benutzer die F1-Taste drückt, zeigt Visual FoxPro das entsprechende Hilfethema an.

Anmerkung Standardmäßig ist die F1-Taste für die kontextbezogene Hilfe aktiviert. Da es sich hierbei um einen anerkannten Standard für die Hilfe handelt, wird empfohlen, diese Tastenzuordnung nicht zu ändern.

Einfügen von Hilfe-Schaltflächen in Formulare

Wenn Sie in Ihren Formularen eine Schaltfläche für die Hilfe vorsehen, wird der Zugriff auf die Hilfe noch weiter vereinfacht. Dies ist insbesondere dann sinnvoll, wenn es sich bei den Benutzern um Neueinsteiger handelt.

So erstellen Sie ein kontextbezogenes Hilfethema

Geben Sie in das erste Feld eines Datensatzes Ihrer Hilfetabelle einen numerischen Wert ein.
Geben Sie den gewünschten Text in die Felder Topic und Details ein.

Jetzt können Sie das Hilfethema dem entsprechenden Formular zuweisen. Meist empfiehlt es sich, die jeweilige Schaltfläche Hilfe, das Formular sowie dessen Objekte demselben Hilfethema zuzuweisen.

So stellen Sie die Kontextbezogenheit ein und fügen eine Schaltfläche "Hilfe" hinzu

Geben Sie im Init-Ereignis des Formulars als HelpContextID-Eigenschaft für alle Formularobjekte den gleichen Wert ein, den Sie dem Hilfethema zugewiesen haben. Wenn diese Nummer z. B. den Wert 7 hat, können Sie den folgenden Befehl verwenden:
```
THIS.SetAll("HelpContextID", 7)
```
Fügen Sie in Ihr Formular eine Befehlsschaltfläche ein.
Geben Sie für die Caption-Eigenschaft der Schaltfläche "Hilfe" ein.
Fügen Sie im Click-Ereignis der Befehlsschaltfläche den folgenden Befehl hinzu:
```
HELP ID THIS.HelpContextID
```
Tipp Speichern Sie die Hilfe-Schaltfläche als Klasse, um sie später zu anderen Formularen hinzufügen zu können. Wählen Sie im Formular-Designer aus dem Menü Datei den Befehl Als Klasse speichern. Weitere Informationen zum Speichern von Objekten als Klassen finden Sie unter Erstellen von Formularen.

Festlegen der Position des Hilfefensters

Wenn Sie die Position für die von Ihnen bereitgestellte Hilfe festlegen möchten, müssen Sie mit dem Befehl DEFINE WINDOW ein eigenes Fenster erstellen. Sie können diesen Befehl zu den Initialisierungszeilen Ihrer Anwendung hinzufügen, um sowohl die Größe als auch die Position des Fensters festzulegen. Öffnen Sie anschließend das Fenster, indem Sie es aktivieren oder anzeigen.

Beispielsweise wird mit den folgenden Befehlen ein Fenster namens Test definiert und anschließend innerhalb dieses Fensters die aktuelle Hilfetabelle angezeigt:

DEFINE WINDOW test FROM 1,1 TO 35,60 SYSTEM 
ACTIVATE WINDOW test 
HELP IN WINDOW test

Abstimmen der Hilfe auf Ihre Anwendung

Da Sie beliebig viele Felder in eine Hilfetabelle einfügen und jeden beliebigen logischen Ausdruck zum Auswählen von Hilfethemen verwenden können, können Sie bei der Entwicklung des Hilfesystems alle Ihre Vorstellungen verwirklichen.

Sie können z. B.:

Programmvariablen definieren, die das Verhalten Ihres Hilfesystems steuern, und diesen Variablen abhängig vom Arbeitsmodus Ihres Programms Werte zuweisen.
In Hilfedateien, die für unerfahrene Benutzer vorgesehen sind, umfangreichere Informationen bereitstellen als in Hilfedateien für erfahrene Benutzer.
Benutzern nur dann Zugriff auf die Hilfe gestatten, wenn sie ein entsprechendes Kennwort eingeben.

Siehe auch

Freigeben über