<\/p>\n
Zu vielen Access-Anwendungen gibt es Beschreibungen und Dokumentationen, eine integrierte Online-Hilfe jedoch nur selten. Warum funktionieren Sie nicht die schon vorhandene Programmbeschreibung zum Hilfetext um Diesen Hilfetext lassen Sie sich dann kontextsensitiv anzeigen. Wie Sie diese Idee mit einem PDF-Dokument umsetzen, zeigt dieser Beitrag. <\/b><\/p>\n Wenn Sie eine PDF-basierte Hilfe umsetzen wollen, sollten Sie sich mit folgenden Fragen beschäftigen:<\/p>\n Ein PDF-Dokument öffnen<\/b><\/p>\n Als Erstes ist die Frage zu klären, wie Sie ein PDF-Dokument öffnen. Bei der Suche nach einer Lösung stoßen Sie ganz schnell auf die Funktion FollowHyperlink<\/b>. Mit dieser Funktion können Sie auf einfache Art ein PDF-Dokument öffnen:<\/p>\n Der Vorteil dieser Funktion liegt in ihrer Einfachheit. Darin besteht aber auch gleichzeitig ihr Nachteil. Sie haben keine Kontrolle über die Ausführung der Funktion oder die Anwendung, die das Dokument öffnen soll. Sie können nur den Pfad zum Dokument übergeben. Die Angabe weiterer Parameter, die im Folgenden benötigt werden, ist nicht möglich. Wozu Sie diese weiteren Parameter brauchen, erfahren Sie später im Text.<\/p>\n Eine andere Funktion, die Ihnen hilft, ein PDF-Dokument anzuzeigen, finden Sie unter den API-Funktionen. Es ist die Funktion ShellExecute <\/b>[1].<\/p>\n Mit dieser Funktion starten Sie jede beliebige externe Anwendung. Außerdem können Sie beliebige Dokumente mit dem dafür vorgesehenen Programm öffnen oder drucken. Damit Sie die Funktion ShellExecute <\/b>verwenden können, müssen Sie diese zuerst in einem Modulkopf deklarieren:<\/p>\n Tab. 1 gibt einen überblick über die verwendeten Parameter und ihre Bedeutung.<\/p>\n Parameter<\/p>\n<\/td>\n Erläuterung<\/p>\n<\/td>\n<\/tr>\n<\/thead>\n hWnd<\/p>\n<\/td>\n Verweis auf das Fenster des startenden Programms.<\/p>\n<\/td>\n<\/tr>\n lpOperation<\/p>\n<\/td>\n Welche Aktion soll ausgeführt werden Mögliche Werte sind etwa „open“, „print“ oder „edit“.<\/p>\n<\/td>\n<\/tr>\n lpFile<\/p>\n<\/td>\n Welche Datei soll geöffnet werden<\/p>\n<\/td>\n<\/tr>\n lpParameters<\/p>\n<\/td>\n Wenn in lpFile der Pfad zu einer Anwendung angegeben ist, können hiermit Parameter an das Programm übergeben werden.<\/p>\n<\/td>\n<\/tr>\n lpDirectory<\/p>\n<\/td>\n Arbeitsverzeichnis des Programms.<\/p>\n<\/td>\n<\/tr>\n nShowCmd<\/p>\n<\/td>\n Konstante, die angibt, wie das Programm angezeigt werden soll. 1<\/span> bedeutet „normal“, also sichtbar.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Tab. 1: Parameter für die Funktion ShellExecute<\/span><\/b><\/p>\n Für den Parameter nShowCmd <\/b>ist eine Vielzahl von Werten möglich. Bei Interesse können Sie diese in der Beispieldatenbank nachlesen.<\/p>\n Der Aufruf der Funktion erfolgt ähnlich einfach wie bei FollowHyperlink<\/b>:<\/p>\n Mit Hilfe dieser Funktion sind Sie in der Lage, ein beliebiges PDF-Dokument mit dem Adobe Reader aus einem Formular heraus zu öffnen. Leider können Sie auf diesem Weg nur das Dokument als Ganzes öffnen. Dabei wird Ihnen immer die erste Seite des Dokuments angezeigt.<\/p>\n Ein PDF-Dokument an einer bestimmten Stelle öffnen<\/p>\n Seit der Version 6 des Adobe Readers ist es möglich, einem PDF-Dokument beim öffnen einen oder mehrere Parameter zu übergeben. Mit Hilfe dieser Parameter lässt sich unter anderem steuern, welche Seite nach dem öffnen angezeigt werden soll. Die Dokumentation dieser Parameter finden Sie auf den Webseiten der Firma Adobe [2], [3] und [4]. Die Dokumentationen und damit auch die Parameter unterscheiden sich teilweise voneinander. Die in diesem Beitrags verwendeten Parameter funktionieren aber unverändert mit allen Versionen seit Adobe Reader 6.<\/p>\n <\/p>\n Was bewirken diese Parameter nun In der Dokumentation von Adobe finden Sie folgende Erläuterung:<\/p>\n Dazu gibt es folgendes konkretes Beispiel:<\/p>\n Damit Sie einen Open<\/b>-Parameter verwenden können, benötigen Sie folgende drei Informationen:<\/p>\n Wie passen diese Informationen nun zur Funktion ShellExecute<\/b> Sie übergeben der Funktion ShellExecute <\/b>den Pfad zu AcroRd32.exe <\/b>(Reader) oder Acrobat.exe <\/b>(Acrobat Vollversion) als Parameter lpFile<\/b>. Für den Parameter lpParameters <\/b>übergeben Sie den Text für den Open<\/b>-Parameter und den Pfad zum PDF-Dokument.<\/p>\n Als Open<\/b>-Parameter verwenden Sie den Wert page<\/b>. Damit können Sie angeben, welche Seite nach dem öffnen des PDF-Dokuments angezeigt werden soll. Der komplette Text für den Open<\/b>-Parameter sieht so aus:<\/p>\n In diesem Beispiel wird nach dem öffnen die dritte Seite des PDF-Dokuments angezeigt:<\/p>\n Ein Problem gibt es mit der bisher beschriebenen Lösung noch – der Pfad zu Acrobat.exe<\/b>. Sie können den Pfad für Ihr System ermitteln und in den VBA-Code einfügen. Wenn Sie aber die nächste Version des Adobe Readers installieren, wird der Pfad nicht mehr stimmen und Sie müssen Ihren Code anpassen.<\/p>\n Noch viel problematischer wird es, wenn Sie Ihre Datenbank an Dritte weitergeben. Dann haben Sie keine Kontrolle mehr darüber, wo der Adobe Reader installiert wurde.<\/p>\n Auch dieses Problem können Sie mit einer API-Funktion lösen. Die Funktion heißt FindExecutable <\/b>[5]. Dieser Funktion übergeben Sie den Pfad zu einem Dokument. Als Ergebnis erhalten Sie den Namen und den Pfad der mit dieser Datei verknüpften Anwendung.<\/p>\n Eine Funktion, der Sie einen Dateinamen übergeben und als Ergebnis den Pfad zur verknüpften Exe-Datei erhalten, finden Sie in folgendem Listing:<\/p>\n Vom Hilfethema zur Seitenzahl<\/p>\n Sie sind jetzt in der Lage, ein PDF-Dokument zu öffnen und eine beliebige Seite anzeigen zu lassen. Was jetzt noch fehlt, ist die Verknüpfung zwischen dem anzuzeigenden Hilfethema und der entsprechenden Seite im PDF-Dokument. <\/p>\n Sie könnten auf die Idee kommen, an jeder Stelle, an der Sie die Hilfe aufrufen, im VBA-Code die Seitenzahl fest einzutragen. Aus dieser Formulierung wird gleich das Problem deutlich, das ein solches Vorgehen mit sich bringen würde. Wenn in der Hilfedatei ein Text geändert oder ergänzt wird, kann dies zur Folge haben, dass sich die Seitenzahlen ändern. In diesem Fall müssten Sie Ihren gesamten VBA-Code durchsuchen und alle fest eincodierten Seitenzahlen überprüfen und anpassen. Besser ist es, wenn Sie eine Tabelle verwenden, in der Sie die Information speichern, welches Hilfethema auf welcher Seite dargestellt ist. Den Aufbau der Tabelle sehen Sie in Tab. 2.<\/p>\n Feldname<\/p>\n<\/td>\n Eigenschaften<\/p>\n<\/td>\n<\/tr>\n<\/thead>\n HilfeThema<\/p>\n<\/td>\n Datentyp Text Seite<\/p>\n<\/td>\n Datentyp: Long Integer Tab. 2: Aufbau der Tabelle tbl_HilfeSeitenzahl<\/span><\/b><\/p>\n Die Spalte HilfeThema <\/b>ist als Primärschlüssel definiert. Damit wird sichergestellt, dass jedes Hilfethema nur einmal in die Tabelle eingetragen werden kann. Die Spalte Seite <\/b>nimmt die Seitenzahl auf. Sie hat als Standardwert den Wert 1<\/b>. Damit wird erreicht, dass im Zweifel die Hilfedatei mit der ersten Seite aufgerufen wird.<\/p>\n Es bietet sich an, das Hilfedokument so zu formatieren, dass jedes Hilfethema auf einer neuen Seite beginnt. In einem so formatierten Dokument wirken sich Korrekturen am Text selten auf die nachfolgenden Seiten aus. <\/p>\n Wenn ein Thema länger wird und sich dadurch die Seitenzahl der nachfolgenden Themen ändert, werden Sie dies sofort bemerken. Dann können Sie leicht mit einer Aktualisierungsabfrage die notwendigen Korrekturen in der Tabelle tbl_HilfeSeitenzahl <\/b>herbeiführen:<\/p>\n Funktion zum Aufruf der Hilfe<\/p>\n Jetzt fehlt Ihnen nur noch eine globale Funktion, mit der Sie Ihre Hilfe aufrufen. Dieser Funktion übergeben Sie als Parameter das anzuzeigende Hilfethema (s. Listing 1).<\/p>\n Listing 1: Funktion zur Anzeige eines Hilfethemas <\/p>\n Die Funktion geht davon aus, dass die Hilfedatei im selben Verzeichnis wie die Anwendung gespeichert ist. Das macht die Funktion robust.<\/p>\n Wenn die Anwendung (zusammen mit dem Hilfe-PDF) in einen anderen Pfad verschoben wird, sind keine Anpassungen notwendig. Der Name der Hilfedatei ist als Konstante deklariert. Wenn Sie den Dateinamen für die Hilfedatei ändern, brauchen Sie nur diese Konstante anzupassen.<\/p>\n Die Prozedur zum Aufruf der Hilfe ist absichtlich als Function<\/b> ausgelegt, obwohl sie keinen Rückgabewert liefert. Auf diesem Weg ist es möglich, dass Sie den Aufruf der Hilfefunktion direkt in die Eigenschaft Beim Klicken<\/b> einer Befehlsschaltfläche schreiben (siehe Bild 1).<\/p>\n Bild 1: Aufruf der Hilfefunktion in der Eigenschaft Beim Klicken<\/span><\/b><\/p>\n<\/p><\/div>\n Nachdem Sie jetzt alle Bausteine für eine PDF-basierte Hilfe zusammengestellt haben, können Sie anfangen und beispielsweise in Ihrer gesamten Anwendung Hilfeschaltflächen platzieren (siehe Bild 2). <\/p>\n Bild 2: Eine Hilfe-Schaltfläche im Einsatz<\/span><\/b><\/p>\n<\/p><\/div>\n In der Eigenschaft Beim Klicken <\/b>rufen Sie die Funktion zum Anzeigen der Hilfe mit dem jeweiligen Thema auf.<\/p>\n Weitere überlegungen<\/b><\/p>\n Es gibt die Möglichkeit, als Open<\/b>-Parameter eine so genannte named destination <\/b>anzugeben. Damit könnten Sie die Hilfefunktion noch weiter vereinfachen und sich die Tabelle zur Verknüpfung von Hilfethema und Seitenzahl sparen. <\/p>\n Dieser Weg würde jedoch erfordern, dass Sie erweiterte Kenntnisse über die Erstellung von PDF-Dokumenten haben. Aus diesem Grund wurde dieser Weg in diesem Artikel nicht weiter verfolgt.<\/p>\n Laut der Dokumentation von Adobe gibt es auch die Möglichkeit, über einen Open<\/b>-Parameter eine Suche im PDF-Dokument zu starten. Trotz intensiver Recherchen ist es dem Autor nicht gelungen, mit einer solchen Suche befriedigende Ergebnisse zu erzielen.<\/p>\n Zusammenfassung<\/b><\/p>\n Mit den Open<\/b>-Parametern des Adobe Readers ist es möglich, nach dem öffnen eines PDF-Dokuments eine bestimmte Seite anzuzeigen. Diese Möglichkeit kann dazu genutzt werden, ein PDF-basiertes Hilfesystem zu erstellen.<\/p>\n Um das in diesem Artikel vorgestellte Hilfesystem in Ihrer Anwendung einzusetzen, sind folgende Schritte erforderlich:<\/p>\n Sie sehen, es ist möglich, mit relativ wenig Aufwand ein Hilfesystem zu realisieren. Wann spendieren Sie Ihren Anwendern den einfachen Zugriff auf Ihre Dokumentation\/Hilfe<\/p>\n Quellen<\/b><\/p>\n [1] Die Funktion ShellExecute: http:\/\/support.microsoft.com\/kbid=238245<\/a><\/p>\n [2] PDF Open Parameters für Version 6: http:\/\/partners.adobe.com\/public\/developer\/en\/acrobat\/PDFOpenParams.pdf<\/a><\/p>\n [3] PDF Open Parameters für Version 7: http:\/\/partners.adobe.com\/public\/developer\/en\/acrobat\/PDFOpenParameters.pdf<\/a><\/p>\n [4] PDF Open Parameters für Version 8: http:\/\/www.adobe.com\/devnet\/acrobat\/pdfs\/pdf_open_parameters.pdf<\/a><\/p>\n [5] Die Funktion FindExecutable: http:\/\/support.microsoft.com\/kb\/109931\/en-us<\/a><\/p>\n Enthaltene Beispieldateien:<\/p>\n PDF-basierteHilfe.mdb<\/p>\n\n\n
Dim strPfad As String\r\nDim strDok As String\r\nstrPfad = CurrentProject.Path\r\nstrDok = strPfad & \"\\\" & \"Hilfe.pdf\"\r\nApplication.FollowHyperlink strDok<\/pre>\n
Private Declare Function ShellExecute _\r\n Lib \"shell32.dll\" Alias \"ShellExecuteA\" _\r\n (ByVal hwnd As Long, _\r\n ByVal lpOperation As String, _\r\n ByVal lpFile As String, _\r\n ByVal lpParameters As String, _\r\n ByVal lpDirectory As String, _\r\n ByVal nShowCmd As SW_Show) As Long<\/pre>\n
\n\n
\n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n Dim strPfad As String\r\nDim strDok As String\r\nstrPfad = CurrentProject.Path\r\nstrDok = strPfad & \"\\\" & \"Hilfe.pdf\"\r\nShellExecute Me.hwnd, \"Open\", _\r\n strDok, vbNullString, \"C:\\\", _\r\n SW_SHOWNORMAL<\/pre>\n
<path to Acrobat>
\/A \"<open parameter>=OpenActions\"
\"<path to PDF file>\"<\/pre>\nAcrobat.exe
\/A \"zoom=1000=OpenActions\"
\"C:\\example.pdf\"<\/pre>\n\n
\/A \"page=3=OpenActions\" <\/pre>\n
Dim strExe As String\r\nDim strPfad As String\r\nDim strDok As String\r\nDim lngSeite As Long\r\nstrPfad = CurrentProject.Path\r\nstrDok = strPfad & \"\\\" & \"Hilfe.pdf\"\r\nstrExe = GibExe(strDok)\r\nlngSeite = Me!cboSeite\r\nShellExecute Me.hwnd, \"Open\", _\r\n strExe, \" \/A \"\"page=\" & _\r\n lngSeite & \"=OpenActions\"\" \"\"\" & _\r\n strDok & \"\"\"\", CurrentProject.Path, SW_SHOWNORMAL<\/pre>\n
Private Function GibExe(strFile As String) _
As String\r\n 'Variablen deklarieren\r\n Dim intI As Integer\r\n Dim strBuffer As String\r\n 'Buffer füllen\r\n strBuffer = String(MAX_FILENAME_LEN, 32)\r\n 'Exe-Datei zum übergebenen Dokument ermitteln\r\n intI = FindExecutable(strFile, vbNullString, _
strBuffer)\r\n If intI > 32 Then\r\n GibExe = Left$(strBuffer, InStr(strBuffer, _
Chr$(0)) - 1)\r\n Else\r\n MsgBox \"Keine verknüpfte Anwendung gefunden\"\r\n End If\r\nEnd Function<\/pre>\n\n\n
\n \n\n \n \n \n \n
Primärschlüssel<\/p>\n<\/td>\n<\/tr>\n\n \n \n
Standardwert: 1<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nUPDATE tbl_HilfeSeitenzahl \r\nSET Seite = Seite+1\r\nWHERE Seite>=3;<\/pre>\n
\nPrivate Const cstrHilfeDatei As String = \"Hilfe.pdf\"\r\nPublic Function HilfeAnzeigen(strThema As String)\r\n 'Variablen deklarieren\r\n Dim strPfad As String\r\n Dim strDok As String\r\n Dim strExe As String\r\n Dim lngSeite As Long\r\n 'Hilfedatei ermitteln\r\n strPfad = CurrentProject.Path\r\n strDok = strPfad & \"\\\" & cstrHilfeDatei\r\n 'Seitenzahl ermitteln\r\n lngSeite = Nz(DLookup(\"Seite\", \"tbl_HilfeSeitenzahl\", \"HilfeThema='\" & strThema & \"'\"), 1)\r\n 'Pfad zur Adobe.exe ermitteln\r\n strExe = GibExe(strDok)\r\n 'Hilfe anzeigen\r\n ShellExecute Application.hWndAccessApp, \"Open\", strExe, \" \/A \"\"page=\" & lngSeite _
& \"=OpenActions\"\" \"\"\" & strDok & \"\"\"\", CurrentProject.Path SW_SHOWNORMAL\r\nEnd Function<\/pre>\n<\/p><\/div>\n\n ![\"missing](\"..\/fileadmin\/_temp_\/2007_05\/PDFHilfe-web-images\/Bild334_opt.jpeg\")
\n <\/div>\n\n\n ![\"missing](\"..\/fileadmin\/_temp_\/2007_05\/PDFHilfe-web-images\/Bild341_opt.jpeg\")
\n <\/div>\n\n\n
Downloads zu diesem Beitrag<\/h3>\n